> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub Copilot に Vantage MCP サーバーを追加する

> Vantage 連携の構築中にドキュメントをすぐに検索できるよう、VS Code の GitHub Copilot に ABBYY Vantage MCP サーバーを接続します。

<div id="overview">
  ## 概要
</div>

**このセクションで行うこと:**

* VS Code の GitHub Copilot に ABBYY Vantage MCP サーバーを追加する
* 接続が正常に機能していることを確認する
* `SearchAbbyyVantageDocumentation` ツールを使用して、Copilot Chat 内からドキュメントを検索する

**所要時間:** 約5分

***

<div id="what-is-the-mcp-server">
  ## MCP サーバーとは？
</div>

Model Context Protocol (MCP) は、AI アシスタントを外部ツールやデータソースに接続するためのオープンスタンダードです。GitHub Copilot に MCP サーバーを追加すると、コンテンツを手動でコピー＆ペーストしなくても、AI が構造化データや各種機能に直接アクセスできるようになります。

ABBYY Vantage MCP サーバー は、Vantage のドキュメント全体を対象にセマンティック検索を実行する単一のツール `SearchAbbyyVantageDocumentation` を提供します。Copilot がこのサーバーに接続されていれば、作業しながら API パラメーター、Skill の構成オプション、トラブルシューティング手順などを自動的に調べられます。

<Note>
  MCP サーバーは、公開ドキュメントへの読み取り専用アクセスを提供します。Vantage テナントには接続せず、ドキュメントを処理することも、Vantage の認証情報を必要とすることもありません。
</Note>

***

<div id="prerequisites">
  ## 前提条件
</div>

* [VS Code](https://code.visualstudio.com/) バージョン **1.99 以降** (MCP サポートが必要)
* [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) 拡張機能がインストールされており、サインイン済みであること

<Note>
  MCP サーバーの利用に、ABBYY Vantage テナントやアカウントは必要ありません。
</Note>

***

<Steps>
  <Step title="コマンド パレットから追加（推奨）">
    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** を選択します

    | Scope     | Config location     | When to use       |
    | --------- | ------------------- | ----------------- |
    | Workspace | `.vscode/mcp.json`  | 特定の 1 つのプロジェクト    |
    | User      | コマンド パレットから開くユーザー設定 | このマシン上のすべてのプロジェクト |
  </Step>

  <Step title="代替: 手動設定">
    手動で設定する場合は、適切な設定ファイルにサーバー エントリを追加します。

    <AccordionGroup>
      <Accordion title="Workspace (.vscode/mcp.json)">
        プロジェクト ルートに `.vscode/mcp.json` を作成または編集します。

        ```json theme={null}
        {
          "servers": {
            "abbyy-vantage": {
              "type": "http",
              "url": "https://docs.abbyy.com/mcp"
            }
          }
        }
        ```
      </Accordion>

      <Accordion title="ユーザー レベルの設定">
        コマンド パレット (**Cmd+Shift+P** / **Ctrl+Shift+P**) を開き、**"MCP: Open User Configuration"** と入力して、次のエントリを追加します。

        ```json theme={null}
        {
          "servers": {
            "abbyy-vantage": {
              "type": "http",
              "url": "https://docs.abbyy.com/mcp"
            }
          }
        }
        ```
      </Accordion>
    </AccordionGroup>
  </Step>

  <Step title="接続を確認する">
    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` を呼び出し、ドキュメントから結果を返します。

    <Warning>
      URL は、末尾にスラッシュを付けず、必ず `https://docs.abbyy.com/mcp` と完全に一致する形で入力してください。また、VS Code からサーバーにアクセスできるネットワーク接続があることも確認してください。
    </Warning>
  </Step>
</Steps>

***

<div id="available-tools">
  ## 利用可能なツール
</div>

ABBYY Vantage MCP サーバー では、1 つのツールを利用できます。

**`SearchAbbyyVantageDocumentation`**

ABBYY Vantage のDocumentation全体を対象にセマンティック検索を実行し、最も関連性の高いコンテンツを返します。Vantage に関する質問をすると、Copilot は Agent mode でこのツールを自動的に呼び出します。

**クエリ例:**

* 「Vantage で Document Skill を設定するにはどうすればよいですか？」
* 「`minConfidence` パラメーターは何をするものですか？」
* 「Vantage で LLM 接続を設定するにはどうすればよいですか？」
* 「Vantage はどのエクスポート形式をサポートしていますか？」
* 「Vantage REST API で認証するにはどうすればよいですか？」

***

<div id="use-cases">
  ## ユースケース
</div>

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

***

<div id="tips-for-effective-queries">
  ## 効果的に問い合わせるためのヒント
</div>

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

***

<div id="removing-the-mcp-server">
  ## MCP サーバーの削除
</div>

サーバーは、次のいずれかの方法で削除できます。

**コマンド パレット から:**

1. コマンド パレット を開きます (**Cmd+Shift+P** / **Ctrl+Shift+P**)
2. **"MCP: List Servers"** を実行します
3. `abbyy-vantage` を選択します
4. **Remove** を選択します

**設定ファイルから:**

`.vscode/mcp.json` (workspace) またはユーザーの MCP 設定から、`abbyy-vantage` エントリを削除します。

***

<div id="troubleshooting">
  ## トラブルシューティング
</div>

**「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" や具体的な機能名と組み合わせてください。

***

<div id="overview">
  ## 概要
</div>

以下の操作が正常に完了しました。

* ✅ VS Code の GitHub Copilot に ABBYY Vantage MCP サーバーを追加
* ✅ "MCP: List Servers" を使用して接続を検証
* ✅ Agent mode の Copilot Chat からドキュメント検索を実行する方法を習得

***

<div id="next-steps">
  ## 次のステップ
</div>

<CardGroup cols={2}>
  <Card title="API 入門" icon="plug" href="/ja/vantage/developer/api-introduction">
    Vantage Processing REST API の利用を開始する
  </Card>

  <Card title="文書処理" icon="file-lines" href="/ja/vantage/documentation/skills/process-skill">
    Process Skill を作成し、SFTP 経由の文書処理を自動化する
  </Card>

  <Card title="LLM 接続の設定" icon="brain" href="/ja/vantage/documentation/skills/connections">
    Vantage を OpenAI または Microsoft Foundry に接続する
  </Card>

  <Card title="プロンプトベースの抽出" icon="wand-magic-sparkles" href="/ja/vantage/documentation/skills/prompt-extraction">
    自然言語のプロンプトを使って文書からデータを抽出する
  </Card>

  <Card title="Claude Code 用 MCP サーバー" icon="terminal" href="/ja/vantage/developer/mcp-server">
    同じ MCP サーバーを Claude Code に追加する
  </Card>
</CardGroup>