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

​
概要

このセクションで行うこと:
  • VS Code の GitHub Copilot に ABBYY Vantage MCP サーバーを追加する
  • 接続が正常に機能していることを確認する
  • SearchAbbyyVantageDocumentation ツールを使用して、Copilot Chat 内からドキュメントを検索する
所要時間: 約5分

​
MCP サーバーとは？

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

​
前提条件

  • VS Code バージョン 1.99 以降 (MCP サポートが必要)
  • GitHub Copilot 拡張機能がインストールされており、サインイン済みであること
MCP サーバーの利用に、ABBYY Vantage テナントやアカウントは必要ありません。
1

コマンド パレットから追加（推奨）

VS Code のコマンド パレットを使用して、MCP サーバーを登録します。
  1. Cmd+Shift+P (macOS) または Ctrl+Shift+P (Windows/Linux) でコマンド パレットを開きます
  2. “MCP: Add Server…” と入力して選択します
  3. トランスポートの種類として HTTP を選択します
  4. URL を入力します: https://docs.abbyy.com/mcp
  5. 名前を入力します: abbyy-vantage
  6. スコープとして Workspace または User を選択します
2

代替: 手動設定

手動で設定する場合は、適切な設定ファイルにサーバー エントリを追加します。
プロジェクト ルートに .vscode/mcp.json を作成または編集します。
コマンド パレット (Cmd+Shift+P / Ctrl+Shift+P) を開き、“MCP: Open User Configuration” と入力して、次のエントリを追加します。
3

接続を確認する

  1. コマンド パレットを開いて “MCP: List Servers” を実行し、abbyy-vantage が接続済みと表示されることを確認します
  2. Copilot Chat を開きます (サイドバーの Copilot アイコンをクリックするか、Ctrl+Shift+I / Cmd+Shift+I を押します)
  3. チャット パネル上部のモード セレクターで Agent mode に切り替えます
  4. チャット入力欄の tools icon をクリックし、リストに SearchAbbyyVantageDocumentation が表示されることを確認します
  5. 質問してテストします:
「ドキュメントを送信するには、Vantage Processing API でどのパラメーターが必要ですか？」
Copilot は SearchAbbyyVantageDocumentation を呼び出し、ドキュメントから結果を返します。
URL は、末尾にスラッシュを付けず、必ず https://docs.abbyy.com/mcp と完全に一致する形で入力してください。また、VS Code からサーバーにアクセスできるネットワーク接続があることも確認してください。

​
利用可能なツール

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

​
ユースケース

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

​
効果的に問い合わせるためのヒント

  • 具体的に質問する: 漠然とした聞き方ではなく、機能名やAPI endpointを質問に含めてください
  • Vantageの用語を使う: “Process Skill”、“Document Skill”、“Skill Designer”、“tenant” などの用語を使うと、より的確な結果が得られます
  • 続けて質問する: Copilot はコンテキストを保持するため、追加の prompt で結果をさらに絞り込めます
  • コードと組み合わせて使う: API レスポンスや設定スニペットを貼り付けて、Vantage のドキュメントに基づいて説明するよう Copilot に依頼できます
  • Agent mode を使う: MCP ツールは Agent mode でのみ利用できます。質問する前に、モードセレクターが “Agent” に設定されていることを確認してください

​
MCP サーバーの削除

サーバーは、次のいずれかの方法で削除できます。 コマンド パレット から:
  1. コマンド パレット を開きます (Cmd+Shift+P / Ctrl+Shift+P)
  2. “MCP: List Servers” を実行します
  3. abbyy-vantage を選択します
  4. Remove を選択します
設定ファイルから: .vscode/mcp.json (workspace) またはユーザーの MCP 設定から、abbyy-vantage エントリを削除します。

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

「MCP: List Servers」に Server が表示されない 設定ファイルが正しく保存されており、JSON が有効であること (末尾に余分なカンマがないこと) を確認してください。ファイルを手動で編集した場合は、VS Code を再読み込みしてみてください (コマンド パレット で Developer: Reload Window を実行) 。 VS Code のバージョンが古すぎる MCP のサポートには、VS Code 1.99 以降が必要です。Help → About でバージョンを確認し、必要に応じて更新してください。 ツールが自動的に呼び出されない Copilot が MCP ツールを呼び出すのは Agent mode のときだけです。Copilot Chat パネル上部のモードセレクターを使って、「Ask」または「Edit」モードから「Agent」に切り替えていることを確認してください。それでもツールが使われない場合は、質問をより具体的にしてみてください。たとえば、“Search the ABBYY Vantage docs for…” のように尋ねるか、特定の Vantage 機能名を明示してください。 検索結果に無関係なものが表示される Vantage のインターフェイスやドキュメントで使われている用語を使って、クエリを言い換えてください。“workflow” や “settings” のような一般的な語を単独で使うのは避け、“Vantage” や具体的な機能名と組み合わせてください。

​
概要

以下の操作が正常に完了しました。
  • ✅ VS Code の GitHub Copilot に ABBYY Vantage MCP サーバーを追加
  • ✅ “MCP: List Servers” を使用して接続を検証
  • ✅ Agent mode の Copilot Chat からドキュメント検索を実行する方法を習得

​
次のステップ

API 入門

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

文書処理

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

LLM 接続の設定

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

プロンプトベースの抽出

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

Claude Code 用 MCP サーバー

同じ MCP サーバーを Claude Code に追加する