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

​
概要

このセクションで行うこと：
  • 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)
ABBYY Vantage のテナントやアカウントは、MCP サーバーの使用には不要です。
1

CLI から追加する（推奨）

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

代替手段: 手動設定

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

接続を確認する

Claude Code を再起動し、次のスラッシュコマンドを実行して、サーバーが登録されていることを確認します。
/mcp
abbyy-vantage が接続済みのステータスで表示されるはずです。ツールが正しく動作していることを確認するには、Claude に Vantage に関する質問をしてみてください。
「Vantage Processing API でドキュメントを送信するには、どの Parameter が必要ですか？」
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 サーバーの削除

Claude Code から ABBYY Vantage MCP サーバーを削除するには、次を実行します。 
claude mcp remove abbyy-vantage
サーバーをユーザーレベルで追加した場合は、--scope user フラグを含めてください。 
claude mcp remove abbyy-vantage --scope user

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

サーバーが /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 に接続する

プロンプトベースの抽出

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