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

​
概要

このセクションで行うこと：
  • ABBYY Vantage MCP サーバーを Claude Code に追加する
  • 接続が正しく動作していることを確認する
  • SearchAbbyyVantageDocumentation ツールを使用して、AI ワークフロー内からドキュメントを検索する
所要時間： 約 5 分

​
MCP サーバーとは？

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

​
前提条件

  • Claude Code がインストールされ、起動していること
  • ターミナルへのアクセス（macOS、Linux、または WSL を使用する Windows）
MCP サーバーを使用するために ABBYY Vantage のテナントやアカウントは不要です。
1

CLI から追加する（推奨）

ターミナルで次のコマンドを実行して、MCP サーバーを Claude Code に登録します。
claude mcp add abbyy-vantage https://docs.abbyy.com/mcp --transport sse
スコープのオプション:デフォルトでは、サーバーは プロジェクトレベル で追加されます。つまり、現在のディレクトリでのみ利用可能（.claude/settings.json に保存）です。すべてのプロジェクトで利用できるようにするには、--scope user フラグを追加します。
claude mcp add abbyy-vantage https://docs.abbyy.com/mcp --transport sse --scope user
スコープ設定ファイル用途
プロジェクト（デフォルト）.claude/settings.json特定の 1 プロジェクトのみ
ユーザー~/.claude/settings.jsonこのマシン上のすべてのプロジェクト
2

代替: 手動で設定する

手動で設定したい場合は、次の JSON を設定ファイルに追加します。
プロジェクトのルートにある .claude/settings.json を作成または編集します。
{
  "mcpServers": {
    "abbyy-vantage": {
      "type": "sse",
      "url": "https://docs.abbyy.com/mcp"
    }
  }
}
ホームディレクトリにある ~/.claude/settings.json を編集します。
{
  "mcpServers": {
    "abbyy-vantage": {
      "type": "sse",
      "url": "https://docs.abbyy.com/mcp"
    }
  }
}
3

接続を確認する

Claude Code を再起動し、次のスラッシュコマンドを実行して、サーバーが登録されていることを確認します。
/mcp
abbyy-vantage が接続済みのステータスで一覧に表示されるはずです。ツールが正しく動作していることを確認するには、Claude に Vantage に関する質問をしてみてください。
「Vantage Processing API で文書を送信するには、どのパラメーターが必要ですか？」
Claude Code は SearchAbbyyVantageDocumentation を呼び出し、ドキュメントからの結果を返します。
/mcp にサーバーが表示されない場合は、URL が末尾のスラッシュなしで https://docs.abbyy.com/mcp と正確に入力されているか確認してください。また、ターミナルからネットワーク経由でサーバーにアクセスできることも確認してください。

​
利用可能なツール

ABBYY Vantage MCP サーバーは、1 つのツールを公開しています。 SearchAbbyyVantageDocumentation ABBYY Vantage のドキュメント全体に対してセマンティック検索を実行し、最も関連性の高いコンテンツを返します。Claude Code は、Vantage に関連する質問をした場合に、このツールを自動的に呼び出します。 クエリ例:
  • 「Vantage で Document Skill をどのように設定しますか？」
  • 「minConfidence Parameter はどのような動作をしますか？」
  • 「Vantage で LLM 接続をどのように設定しますか？」
  • 「Vantage はどのエクスポート形式をサポートしていますか？」
  • 「Vantage REST API ではどのように認証しますか？」

​
ユースケース

API 連携

IDE を離れることなく、エンドポイントの Parameter、認証方法、リクエスト／レスポンス形式を確認できます

Skill の設定

Document Skill、Process Skill、Advanced Designer 向けの設定オプションやベストプラクティスをすばやく見つけることができます

トラブルシューティング

統合をデバッグしている最中でも、エラーメッセージや既知の問題を検索して、より迅速に問題を解決できます

機能の探索

プロジェクトを計画しながら、Vantage がサポートする抽出モデル、対応形式、テナント設定などを把握できます

​
効率的なクエリのためのヒント

  • 具体的に書く: 一般的な質問ではなく、質問の中に機能名や API エンドポイントを含めましょう
  • Vantage の用語を使う: “Process Skill”、“Document Skill”、“Skill Designer”、“tenant” のような用語を使うと、より正確な結果が得られます
  • フォローアップの質問をする: Claude Code はコンテキストを保持するため、フォローアップのプロンプトで結果をさらに絞り込むことができます
  • 自分のコードと組み合わせる: API レスポンスや設定のスニペットを貼り付けて、Vantage のドキュメントを使ってそれを説明するように Claude に依頼してください

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

サーバーが /mcp に表示されない 設定ファイルが正しく保存されていること、JSON が有効な形式であること（末尾にカンマがないこと）を確認してください。変更を加えた後は、Claude Code を完全に再起動してください。 ツールが自動的に実行されない Claude Code は関連性に基づいて MCP ツールを実行します。ツールが使われていない場合は、質問をより明確に表現してみてください（例：「ABBYY Vantage のドキュメントを検索して…」）。または、特定の Vantage の機能名を明示的に記載してください。 検索結果が無関係なものになる クエリを、Vantage のインターフェースやドキュメントで実際に使用されている用語を使って言い換えてください。“workflow” や “settings” のような汎用的な用語だけの使用は避け、「Vantage」や特定の機能名と組み合わせて指定してください。

​
まとめ

次のことを実行しました:
  • ✅ ABBYY Vantage MCP サーバーを Claude Code に追加しました
  • ✅ /mcp を使用して接続を確認しました
  • ✅ AI ワークフロー内からドキュメント検索を開始する方法を学びました

​
次のステップ

API 入門

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

ドキュメントの処理

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

LLM 接続の設定

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

プロンプトベースの抽出

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