翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

MCP プロトコル契約

エージェントがツールとエージェントサーバーを呼び出すことができるように、モデルコンテキストプロトコル (MCP) を実装するための要件を理解します。

コード例については、AgentCore ランタイムで MCP サーバーをデプロイする」を参照してください。

プロトコル実装要件

MCP サーバーは、以下の特定のプロトコル要件を実装する必要があります。

MCP セッション管理と microVM の維持

Model Context Protocol (MCP) は、 Mcp-Session-Idヘッダーを使用してセッション状態とルートリクエストを管理します。MCP の仕様については、「MCP Streamable HTTP Transport」を参照してください。

MicroVM の永続性: Amazon Bedrock AgentCore は Mcp-Session-Idヘッダーを使用して、リクエストを同じ microVM インスタンスにルーティングします。クライアントは、レスポンスでMcp-Session-Id返された をキャプチャし、以降のすべてのリクエストに含めて、セッションのアフィニティを確保する必要があります。一貫したセッション ID がないと、各リクエストが新しいmicroVM にルーティングされ、コールドスタートによるレイテンシーが増加する可能性があります。

ステートレス MCP ( stateless_http=True ):

ステートフル MCP ( stateless_http=False ):

ステートフル MCP セッション管理の詳細については、「MCP セッション管理仕様」を参照してください。

コンテナの要件

MCP サーバーは、以下の仕様を満たすコンテナ化されたアプリケーションとしてデプロイする必要があります。

パスの要件

/mcp - POST

目的

MCP RPC メッセージを受信し、エージェントのツール機能を通じて処理します。標準の MCP RPC メッセージを使用して InvokeAgentRuntime API ペイロードを完全にパススルーします。

レスポンスの形式

JSON-RPC ベースのリクエスト/レスポンス形式。 application/jsonと の両方をレスポンスコンテンツタイプtext/event-streamとしてサポート

ユースケース

/mcp エンドポイントには、いくつかの重要な目的があります。

エラー処理

MCP サーバーは、標準の JSON-RPC 2.0 エラーレスポンスとしてエラーを返します。ほとんどのエラーは、MCP 仕様の要求に従って、HTTP 200 ステータスコードを持つ JSON-RPC error オブジェクトで実行されます。認証、認可、プロトコルレベルのリクエストエラーのみが、200 以外の HTTP ステータスコードを使用します。次の表は、各ランタイム例外を JSON-RPC エラーコード、HTTP ステータスコード、およびメッセージにマッピングしています。一部の例外は JSON-RPC エラーコードを共有しますが、異なるメッセージを返すため、別々の行としてリストされます。

ConflictException と RetryableConflictExceptionはどちらも JSON-RPC エラーコード -32005 (HTTP 200) を使用しますが、メッセージによって区別されます。サービスがそのセッションをプロビジョニングまたは破棄している間に 2 番目のオペレーションがセッションをターゲットにすると、サービスは RetryableConflictException (Session operation in progress, please retry) を返します。MCP は JSON-RPC 本文のエラーで HTTP 200 を返すため、発信者はレスポンス本文を検査し、短いエクスポネンシャルバックオフで再試行する必要があります。MCP クライアントはそれを自動再試行しません。

エラー応答のサンプル:

{
  "jsonrpc": "2.0",
  "id": "req-001",
  "error": {
    "code": -32005,
    "message": "Session operation in progress, please retry"
  }
}

OAuth 認証レスポンス

OAuth 設定のエージェントは、RFC 6749 (OAuth 2.0) 認証標準に従います。認証がない場合、サービスは WWW-Authenticate ヘッダー (RFC 7235 ごと) を含む 401 Unauthorized レスポンスを返します。これにより、クライアントは GetRuntimeProtectedResourceMetadata API を通じて認可サーバーエンドポイントを検出できます。

401 Unauthorized

認可ヘッダーが欠落しているか空の場合に返されます。

レスポンスには WWW-Authenticate ヘッダーが含まれます。

WWW-Authenticate: Bearer resource_metadata="https://bedrock-agentcore.{region}.amazonaws.com/runtimes/{ESCAPED_ARN}/invocations/.well-known/oauth-protected-resource?qualifier={QUALIFIER}"