MCPコネクタ
ClaudeのModel Context Protocol(MCP)コネクタ機能を使用すると、別のMCPクライアントを使用せずにメッセージAPIから直接リモートMCPサーバーに接続できます。
この機能には、ベータヘッダーが必要です:"anthropic-beta": "mcp-client-2025-04-04"
主な機能
- 直接API統合:MCPクライアントを実装せずにMCPサーバーに接続
- ツール呼び出しのサポート:メッセージAPIを通じてMCPツールにアクセス
- OAuth認証:認証されたサーバー用のOAuth Bearerトークンのサポート
- 複数サーバー:1つのリクエストで複数のMCPサーバーに接続
制限事項
- MCP仕様の機能セットのうち、現在はツール呼び出しのみがサポートされています。
- サーバーはHTTPを通じて公開されている必要があります。ローカルのSTDIOサーバーには直接接続できません。
- MCPコネクタは現在、Amazon BedrockおよびGoogle Vertexではサポートされていません。
メッセージAPIでMCPコネクタを使用する
リモートMCPサーバーに接続するには、メッセージAPIリクエストにmcp_servers
パラメータを含めます:
MCPサーバー設定
mcp_servers
配列の各MCPサーバーは、以下の設定をサポートしています:
フィールドの説明
プロパティ | 型 | 必須 | 説明 |
---|---|---|---|
type | string | はい | 現在は「url」のみサポート |
url | string | はい | MCPサーバーのURL。https://で始まる必要があります |
name | string | はい | このMCPサーバーの一意の識別子。mcp_tool_call ブロックでサーバーを識別し、モデルにツールを区別するために使用されます。 |
tool_configuration | object | いいえ | ツールの使用を設定 |
tool_configuration.enabled | boolean | いいえ | このサーバーからのツールを有効にするかどうか(デフォルト:true) |
tool_configuration.allowed_tools | array | いいえ | 許可するツールを制限するリスト(デフォルトでは、すべてのツールが許可されます) |
authorization_token | string | いいえ | MCPサーバーで必要な場合のOAuth認証トークン。MCP仕様を参照してください。 |
レスポンスコンテンツタイプ
ClaudeがMCPツールを使用する場合、レスポンスには2つの新しいコンテンツブロックタイプが含まれます:
MCPツール使用ブロック
MCPツール結果ブロック
複数のMCPサーバー
mcp_servers
配列に複数のオブジェクトを含めることで、複数のMCPサーバーに接続できます:
認証
OAuth認証を必要とするMCPサーバーの場合、アクセストークンを取得する必要があります。MCPコネクタベータは、MCPサーバー定義にauthorization_token
パラメータを渡すことをサポートしています。
APIコンシューマーは、APIコールを行う前にOAuthフローを処理してアクセストークンを取得し、必要に応じてトークンを更新することが期待されています。
テスト用のアクセストークンの取得
MCPインスペクターを使用すると、テスト目的でアクセストークンを取得するプロセスを案内します。
-
次のコマンドでインスペクターを実行します。マシンにNode.jsがインストールされている必要があります。
-
左側のサイドバーで、「Transport type」に「SSE」または「Streamable HTTP」を選択します。
-
MCPサーバーのURLを入力します。
-
右側のエリアで、「Need to configure authentication?」の後にある「Open Auth Settings」ボタンをクリックします。
-
「Quick OAuth Flow」をクリックし、OAuth画面で認証します。
-
インスペクターの「OAuth Flow Progress」セクションの手順に従い、「Authentication complete」に到達するまで「Continue」をクリックします。
-
access_token
の値をコピーします。 -
MCPサーバー設定の
authorization_token
フィールドに貼り付けます。
アクセストークンの使用
上記のいずれかのOAuthフローを使用してアクセストークンを取得したら、MCPサーバー設定で使用できます:
OAuthフローの詳細な説明については、MCP仕様の認証セクションを参照してください。