> ## 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.

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

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

<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 サーバーは、`SearchAbbyyVantageDocumentation` という単一のツールを提供しており、Vantage の全ドキュメントを対象にセマンティック検索を実行します。Copilot がこのサーバーに接続されていると、作業中に API パラメーター、Skill の設定オプション、トラブルシューティング手順などを自動的に参照できます。

<Note>
  MCP サーバーは、公開ドキュメントへの読み取り専用アクセスを提供します。Vantage tenant には接続せず、文書を処理することも、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**

    | スコープ      | 設定場所               | 使用するケース           |
    | --------- | ------------------ | ----------------- |
    | 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 モード** に切り替えます
    4. チャット入力欄の **ツールアイコン** をクリックします — 一覧に `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 のドキュメント全体を対象にセマンティック検索を実行し、最も関連性の高いコンテンツを返します。Vantage に関する質問をすると、Copilot は Agent モードでこのツールを自動的に呼び出します。

**クエリの例:**

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

***

<div id="use-cases">
  ## 活用例
</div>

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

***

<div id="tips-for-effective-queries">
  ## 効果的にクエリするためのヒント
</div>

* **具体的に質問する:** 漠然とした聞き方ではなく、質問には機能名や API エンドポイントを含めてください
* **Vantage の用語を使う:** "Process Skill"、"Document Skill"、"Skill Designer"、"tenant" などの用語を使うと、より的確な結果が得られます
* **追加で質問する:** Copilot はコンテキストを保持するため、追加のプロンプトで結果をさらに絞り込めます
* **コードと組み合わせる:** API レスポンスや設定スニペットを貼り付けて、Vantage のドキュメントに基づいて説明するよう Copilot に依頼してください
* **Agent モードを使う:** MCP ツールは Agent モードでのみ使用できます。質問する前に、モードセレクターが "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` (ワークスペース) またはユーザーの MCP 構成から `abbyy-vantage` のエントリを削除します。

***

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

**「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" または特定の機能名と組み合わせてください。

***

<div id="summary">
  ## まとめ
</div>

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

* ✅ VS Code の GitHub Copilot に ABBYY Vantage MCP サーバーを追加
* ✅ 「MCP: List Servers」を使用して接続を確認
* ✅ Agent モードの 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/how-to/process-skill">
    Process skill を作成し、SFTP 経由でドキュメント処理を自動化する
  </Card>

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

  <Card title="プロンプトベースの抽出" icon="wand-magic-sparkles" href="/ja/vantage/how-to/prompt-extraction">
    自然言語プロンプトを使用してドキュメントからデータを抽出する
  </Card>

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