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

# Claude Code に ABBYY Vantage MCP サーバーを追加する

> ABBYY Vantage MCP サーバーを Claude Code に追加すると、連携や Skill の構築時に、AI アシスタントから Vantage のドキュメントを直接検索できるようになります。

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

**この手順でできること:**

* ABBYY Vantage MCP サーバーを Claude Code に追加する
* 接続が正しく機能していることを確認する
* `SearchAbbyyVantageDocumentation` ツールを使用して、AI ワークフロー内からドキュメントを検索する

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

***

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

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

ABBYY Vantage MCP サーバーは、`SearchAbbyyVantageDocumentation` という 1 つのツールを提供しており、Vantage のドキュメント全体を対象にセマンティック検索を実行します。Claude Code がこのサーバーに接続されていると、作業中に API パラメーター、Skill の設定オプション、トラブルシューティング手順などを自動的に調べることができます。

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

***

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

* [Claude Code](https://claude.ai/code) がインストールされ、実行中であること
* ターミナルにアクセスできること (macOS、Linux、または WSL を使用する Windows)

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

***

<Steps>
  <Step title="CLI で追加（推奨）">
    ターミナルで次のコマンドを実行して、MCP サーバーを Claude Code に登録します。

    ```bash theme={null}
    claude mcp add abbyy-vantage https://docs.abbyy.com/mcp --transport http
    ```

    **スコープオプション:**

    デフォルトでは、サーバーは **プロジェクトレベル** で追加されます。つまり、現在のディレクトリでのみ使用可能です (`.claude/settings.json` に保存されます) 。すべてのプロジェクトで使えるようにするには、`--scope user` フラグを追加します。

    ```bash theme={null}
    claude mcp add abbyy-vantage https://docs.abbyy.com/mcp --transport http --scope user
    ```

    | スコープ           | 設定ファイル                    | 使用する場合            |
    | -------------- | ------------------------- | ----------------- |
    | プロジェクト (デフォルト) | `.claude/settings.json`   | 特定の1つのプロジェクト      |
    | User           | `~/.claude/settings.json` | このマシン上のすべてのプロジェクト |
  </Step>

  <Step title="代替: 手動設定">
    手動で設定する場合は、次の JSON を設定ファイルに追加します。

    <AccordionGroup>
      <Accordion title="プロジェクトレベル (.claude/settings.json)">
        プロジェクトのルートにある `.claude/settings.json` を作成または編集します。

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

      <Accordion title="ユーザーレベル (~/.claude/settings.json)">
        ホームディレクトリにある `~/.claude/settings.json` を編集します。

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

  <Step title="接続を確認">
    Claude Code を再起動し、次のスラッシュコマンドを実行してサーバーが登録されていることを確認します。

    ```
    /mcp
    ```

    `abbyy-vantage` が接続済みのステータスで表示されるはずです。ツールが正常に動作していることを確認するには、Claude に Vantage 関連の質問をしてください。

    > 「ドキュメントを送信するには、Vantage Processing API でどのようなパラメーターが必要ですか？」

    Claude Code は `SearchAbbyyVantageDocumentation` を呼び出し、Documentation から結果を返します。

    <Warning>
      `/mcp` にサーバーが表示されない場合は、URL が末尾のスラッシュなしで `https://docs.abbyy.com/mcp` と正確に入力されていることを確認してください。あわせて、ターミナルからサーバーにアクセスできるネットワーク接続があることも確認してください。
    </Warning>
  </Step>
</Steps>

***

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

ABBYY Vantage MCP サーバーは、1 つのツールを提供しています。

**`SearchAbbyyVantageDocumentation`**

ABBYY Vantage のドキュメント全体を対象にセマンティック検索を実行し、最も関連性の高い内容を返します。Vantage に関する質問をすると、Claude Code はこのツールを自動的に呼び出します。

**質問例:**

* 「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" などの用語を使うと、より的確な結果が得られます
* **追加で質問する:** Claude Code はコンテキストを保持するため、後続のプロンプトで結果をさらに絞り込めます
* **コードと組み合わせる:** APIレスポンスや設定スニペットを貼り付けて、Vantage のドキュメントを基に Claude に説明させることができます

***

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

Claude Code から ABBYY Vantage MCP サーバーを削除するには、以下を実行します。

```bash theme={null}
claude mcp remove abbyy-vantage
```

サーバーをユーザーレベルで追加した場合は、`--scope user` フラグを指定してください。

```bash theme={null}
claude mcp remove abbyy-vantage --scope user
```

***

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

**`/mcp` に Server が表示されない**

設定ファイルが正しく保存されていること、および JSON が有効であること (末尾にカンマがないこと) を確認してください。変更を加えたら、Claude Code を完全に再起動してください。

**ツールが自動的に呼び出されない**

Claude Code は、関連性に基づいて MCP ツールを呼び出します。ツールが使われない場合は、質問をより具体的にしてみてください。たとえば、"Search the ABBYY Vantage docs for..." のように尋ねるか、特定の Vantage 機能名を挙げてください。

**検索で無関係な結果が返る**

Vantage のインターフェイスやドキュメントで使われている用語を使って、クエリを言い換えてください。"workflow" や "settings" のような一般的な用語を単独で使うのは避け、"Vantage" または特定の機能名と組み合わせてください。

***

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

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

* ✅ Claude Code に ABBYY Vantage MCP サーバーを追加
* ✅ `/mcp` を使用して接続を検証
* ✅ AI ワークフロー内からドキュメント検索を実行する方法を習得

***

<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>
</CardGroup>