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

​
概要

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

​
MCP サーバーとは

Model Context Protocol (MCP) は、AI アシスタントを外部ツールやデータソースに接続できるようにするオープン標準です。GitHub Copilot に MCP サーバーを追加すると、手動でコンテンツをコピー＆ペーストしなくても、AI が構造化データや機能に直接アクセスできるようになります。 ABBYY Vantage MCP サーバーは、SearchAbbyyVantageDocumentation という単一のツールを提供しており、Vantage の全ドキュメントを対象にセマンティック検索を実行します。Copilot がこのサーバーに接続されていると、作業中に API パラメーター、Skill の設定オプション、トラブルシューティング手順などを自動的に参照できます。
MCP サーバーは、公開ドキュメントへの読み取り専用アクセスを提供します。Vantage tenant には接続せず、文書を処理することも、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
スコープ設定場所使用するケース
Workspace.vscode/mcp.json特定の 1 つのプロジェクト
Userコマンドパレットから開くユーザー設定このマシン上のすべてのプロジェクト
2

代替方法: 手動設定

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

接続を確認する

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

​
利用可能なツール

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

​
活用例

API 連携

IDEを離れることなく、エンドポイントのパラメーター、認証方式、リクエスト/レスポンス形式を確認できます

Skill の設定

Document Skills、Process Skills、Advanced Designer の設定オプションやベストプラクティスをすばやく確認できます

トラブルシューティング

エラーメッセージや既知の問題を検索して、連携のデバッグ時に問題をより早く解決できます

機能の把握

プロジェクトの計画時に、Vantage で利用できる機能 (抽出モデル、対応形式、tenant 設定など) を把握できます

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

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

​
MCP サーバーの削除

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

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

「MCP: List Servers」にサーバーが表示されない 構成ファイルが正しく保存されていて、JSON が有効であること (末尾にカンマがないこと) を確認してください。ファイルを手動で編集した場合は、VS Code を再読み込みしてみてください (コマンドパレットで Developer: Reload Window を実行) 。 VS Code のバージョンが古すぎる MCP のサポートには、VS Code 1.99 以降 が必要です。Help → About でバージョンを確認し、必要に応じて更新してください。 ツールが自動的に呼び出されない Copilot が MCP ツールを呼び出すのは、Agent モード のときだけです。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 モードの Copilot Chat からドキュメント検索を実行する方法を習得

​
次のステップ

APIの概要

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

ドキュメント処理

Process skill を作成し、SFTP 経由でドキュメント処理を自動化する

LLM 接続の設定

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

プロンプトベースの抽出

自然言語プロンプトを使用してドキュメントからデータを抽出する

Claude Code 用 MCP サーバー

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