メインコンテンツへスキップ

​
概要

この手順でできること:
  • ABBYY Vantage MCP サーバーを Claude Code に追加する
  • 接続が正しく機能していることを確認する
  • SearchAbbyyVantageDocumentation ツールを使用して、AI ワークフロー内からドキュメントを検索する
所要時間: 約5分

​
MCP サーバーとは？

Model Context Protocol (MCP) は、AI アシスタントが外部ツールやデータソースに接続するためのオープン標準です。Claude Code に MCP サーバーを追加すると、コンテンツを手動でコピー＆ペーストしなくても、AI が構造化データや機能に直接アクセスできるようになります。 ABBYY Vantage MCP サーバーは、SearchAbbyyVantageDocumentation という 1 つのツールを提供しており、Vantage のドキュメント全体を対象にセマンティック検索を実行します。Claude Code がこのサーバーに接続されていると、作業中に API パラメーター、Skill の設定オプション、トラブルシューティング手順などを自動的に調べることができます。
MCP サーバーは、公開ドキュメントへの読み取り専用アクセスを提供します。Vantage テナントには接続せず、ドキュメントを処理することもなく、Vantage の資格情報も必要ありません。

​
前提条件

  • Claude Code がインストールされ、実行中であること
  • ターミナルにアクセスできること (macOS、Linux、または WSL を使用する Windows)
MCP サーバーの使用に、ABBYY Vantage テナントやアカウントは必要ありません。
1

CLI で追加（推奨）

ターミナルで次のコマンドを実行して、MCP サーバーを Claude Code に登録します。
スコープオプション:デフォルトでは、サーバーは プロジェクトレベル で追加されます。つまり、現在のディレクトリでのみ使用可能です (.claude/settings.json に保存されます) 。すべてのプロジェクトで使えるようにするには、--scope user フラグを追加します。
2

代替: 手動設定

手動で設定する場合は、次の JSON を設定ファイルに追加します。
プロジェクトのルートにある .claude/settings.json を作成または編集します。
ホームディレクトリにある ~/.claude/settings.json を編集します。
3

接続を確認

Claude Code を再起動し、次のスラッシュコマンドを実行してサーバーが登録されていることを確認します。
abbyy-vantage が接続済みのステータスで表示されるはずです。ツールが正常に動作していることを確認するには、Claude に Vantage 関連の質問をしてください。
「ドキュメントを送信するには、Vantage Processing API でどのようなパラメーターが必要ですか？」
Claude Code は SearchAbbyyVantageDocumentation を呼び出し、Documentation から結果を返します。
/mcp にサーバーが表示されない場合は、URL が末尾のスラッシュなしで https://docs.abbyy.com/mcp と正確に入力されていることを確認してください。あわせて、ターミナルからサーバーにアクセスできるネットワーク接続があることも確認してください。

​
利用可能なツール

ABBYY Vantage MCP サーバーは、1 つのツールを提供しています。 SearchAbbyyVantageDocumentation ABBYY Vantage のドキュメント全体を対象にセマンティック検索を実行し、最も関連性の高い内容を返します。Vantage に関する質問をすると、Claude Code はこのツールを自動的に呼び出します。 質問例:
  • 「Vantage で Document Skill を設定するにはどうすればよいですか？」
  • 「minConfidence パラメーターは何をしますか？」
  • 「Vantage で LLM 接続を設定するにはどうすればよいですか？」
  • 「Vantage はどのエクスポート形式をサポートしていますか？」
  • 「Vantage REST API で認証するにはどうすればよいですか？」

​
ユースケース

  • API 連携: IDE を離れることなく、エンドポイントのパラメーター、認証方式、リクエスト/レスポンス形式を確認できます
  • Skill の設定: Document Skills、Process Skills、Advanced Designer の設定オプションやベストプラクティスをすばやく見つけられます
  • トラブルシューティング: エラーメッセージや既知の問題を検索して、連携のデバッグ中に問題をより迅速に解決できます
  • 機能の把握: プロジェクトの計画時に、Vantage でサポートされる内容 (抽出モデル、対応フォーマット、テナント設定) を確認できます

​
効果的にクエリするためのヒント

  • 具体的に質問する: 漠然と尋ねるのではなく、機能名やAPIエンドポイントを質問に含めてください
  • Vantageの用語を使う: “Process Skill”、“Document Skill”、“Skill Designer”、“tenant” などの用語を使うと、より的確な結果が得られます
  • 追加で質問する: Claude Code はコンテキストを保持するため、後続のプロンプトで結果をさらに絞り込めます
  • コードと組み合わせる: APIレスポンスや設定スニペットを貼り付けて、Vantage のドキュメントを基に Claude に説明させることができます

​
MCP サーバーの削除

Claude Code から ABBYY Vantage MCP サーバーを削除するには、以下を実行します。
サーバーをユーザーレベルで追加した場合は、--scope user フラグを指定してください。

​
トラブルシューティング

/mcp に Server が表示されない 設定ファイルが正しく保存されていること、および JSON が有効であること (末尾にカンマがないこと) を確認してください。変更を加えたら、Claude Code を完全に再起動してください。 ツールが自動的に呼び出されない Claude Code は、関連性に基づいて MCP ツールを呼び出します。ツールが使われない場合は、質問をより具体的にしてみてください。たとえば、“Search the ABBYY Vantage docs for…” のように尋ねるか、特定の Vantage 機能名を挙げてください。 検索で無関係な結果が返る Vantage のインターフェイスやドキュメントで使われている用語を使って、クエリを言い換えてください。“workflow” や “settings” のような一般的な用語を単独で使うのは避け、“Vantage” または特定の機能名と組み合わせてください。

​
まとめ

以下が正常に完了しました。
  • ✅ Claude Code に ABBYY Vantage MCP サーバーを追加
  • ✅ /mcp を使用して接続を検証
  • ✅ AI ワークフロー内からドキュメント検索を実行する方法を習得

​
次のステップ

API の概要

Vantage Processing REST API の利用を開始する

文書処理

Process Skill を作成し、SFTP 経由で文書処理を自動化する

LLM 接続の設定

Vantage を OpenAI または Microsoft Foundry に接続する

プロンプトベースの抽出

自然言語のプロンプトを使用して、文書からデータを抽出する