MCP サーバーターゲット

MCP サーバーは、Bedrock AgentCore でモデルやエージェントとやり取りするためのローカルツール、データアクセス、またはカスタム関数を提供します。Bedrock AgentCore では、ゲートウェイの作成時に事前設定された MCP サーバーをターゲットとして定義できます。

MCP サーバーは、エージェントが検出して使用できるツール、プロンプト、リソースをホストします。Bedrock AgentCore では、ゲートウェイを使用してターゲットをこれらの機能に関連付け、エージェントランタイムに接続します。プロトコルハンドシェイクを実行し、使用可能な機能にインデックスを作成する SynchronizeGatewayTargets API を使用して、外部 MCP サーバーに接続します。MCP サーバーのインストールと使用の詳細については、「Amazon Bedrock AgentCore MCP Server: Vibe coding with your coding Assistant」を参照してください。

主な考慮事項と制限事項

一覧表示モード

ListingMode は、MCP サーバーターゲットの DYNAMIC または DEFAULT として設定できます。

暗黙的な同期

DEFAULT モードのターゲットの場合、CreateGatewayTarget オペレーションと UpdateGatewayTarget オペレーションによって、機能検出とインデックス作成が自動的にトリガーされます。いずれかのオペレーションが呼び出されると、Gateway は MCP tools/listの機能を使用して使用可能なツールを取得し、 を使用してプロンプトを表示しprompts/list、 resources/listと を使用してリソースを取得しresources/templates/list、返された機能を統合カタログに追加します。

明示的な同期

DEFAULT モードのターゲットの 機能カタログは、 SynchronizeGatewayTargets API を呼び出して手動で更新できます。呼び出されると、ゲートウェイの使用可能な機能のリストが更新されます。MCP サーバーのツール、プロンプト、リソース定義が変更されるたびに API を呼び出す必要があります。

同期は、MCP サーバーを統合するときに正確な機能カタログを維持するための重要なメカニズムです。暗黙的な同期はターゲットの作成時と更新時に自動的に行われ、Gateway は MCP サーバーからツール、プロンプト、リソースを即座に検出してインデックスを作成し、セマンティック検索と統合出品に機能を利用できるようにします。明示的な同期は SynchronizeGatewayTargets API を介してオンデマンドで実行されるため、MCP サーバーが個別に機能を変更するときに MCP 機能カタログを検出できます。

SynchronizeGatewayTargets を呼び出すタイミング

MCP サーバーターゲットのリスト化モードが DEFAULT に設定されている場合は、ツール、プロンプト、またはリソースを追加、削除、または変更した後に SynchronizeGatewayTargets API を使用します。Gateway はセマンティック検索用のベクトル埋め込みを事前計算し、正規化された機能カタログを維持するため、ユーザーが利用可能な最新のツール、プロンプト、リソースを検出して呼び出すことができるように同期する必要があります。

API を呼び出す方法

/gateways/ { gatewayIdentifier}/synchronize に PUT リクエストを実行します。API はすぐに 202 レスポンスを返し、同期を非同期的に処理します。GetGatewayTarget を使用してターゲットステータスをモニタリングし、同期の進行状況を追跡します。大規模な機能セットではオペレーションに数分かかる可能性があるためです。

認可戦略

次のタイプの認可戦略がサポートされています。

MCP サーバーターゲットの設定に関する考慮事項

以下を設定する必要があります。

認可コードフローを使用した OAuth で保護された MCP サーバーへの接続

MCP サーバーターゲットで認可コード付与タイプ (3 レッグの OAuth) をサポートするために、Amazon Bedrock AgentCore Gateway にはターゲット作成のための 2 つの方法が用意されています。

MCP サーバーターゲットの作成中の暗黙的な同期

この方法では、管理者ユーザーは、レスポンスで返された認可 URL CreateGatewayTarget を使用して、、、または UpdateGatewayTarget SynchronizeGatewayTargetsオペレーション中に認可コードフローを完了します。これにより、Amazon Bedrock AgentCore Gateway は MCP サーバーのツールを事前に検出してキャッシュできます。

MCP サーバーターゲットの作成時にスキーマを事前に指定する

この方法では、管理者ユーザーは Amazon Bedrock AgentCore Gateway が MCP サーバーから動的に取得するのではなく、 CreateGatewayTarget または UpdateGatewayTargetオペレーション中に mcpToolSchemaフィールドを使用してツールスキーマを直接提供します。Amazon Bedrock AgentCore Gateway は、提供されたスキーマを解析し、ツール定義をキャッシュします。

URL セッションのバインド

OAuth 2.0 認可 URL セッションバインディングは、OAuth 認可リクエストを開始したユーザーが、同意を付与したユーザーと同じであることを確認します。ユーザーが同意を完了すると、ブラウザは一意のセッション URI を使用してターゲットに設定された戻り URL にリダイレクトします。その後、アプリケーションは CompleteResourceTokenAuth API を呼び出し、ユーザーの ID とセッション URI の両方を提示します。Amazon Bedrock AgentCore Identity は、フローを開始したユーザーが、アクセストークンの認可コードを交換する前にフローを完了したのと同じユーザーであることを検証します。

これにより、ユーザーが誤って承認 URL を共有し、他のユーザーが同意を完了して、アクセストークンを間違った相手に付与するシナリオを防ぐことができます。認可 URL とセッション URI は 10 分間のみ有効で、誤用のウィンドウがさらに制限されます。セッションバインディングは、ターゲットの作成時 (暗黙的な同期) およびツールの呼び出し時に適用されます。

許可を設定する

MCP サーバーターゲットの作成、更新、または同期に使用する IAM ロールには、次の例に示すアクセス許可が必要です。

{
"Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "bedrock-agentcore:CreateGateway",
                "bedrock-agentcore:GetGateway",
                "bedrock-agentcore:CreateGatewayTarget",
                "bedrock-agentcore:GetGatewayTarget",
                "bedrock-agentcore:SynchronizeGatewayTargets",
                "bedrock-agentcore:UpdateGatewayTarget"
            ],
            "Resource": "arn:aws:bedrock-agentcore:*:*:*gateway*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "bedrock-agentcore:CreateWorkloadIdentity",
                "bedrock-agentcore:GetWorkloadAccessToken",
                "bedrock-agentcore:GetWorkloadAccessTokenForUserId",
                "bedrock-agentcore:GetResourceOauth2Token",
                "bedrock-agentcore:GetResourceApiKey",
                "bedrock-agentcore:CompleteResourceTokenAuth",
                "secretsmanager:GetSecretValue"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "kms:EnableKeyRotation",
                "kms:Decrypt",
                "kms:Encrypt",
                "kms:GenerateDataKey*",
                "kms:ReEncrypt*",
                "kms:CreateAlias",
                "kms:DisableKey",
                "kms:*"
            ],
            "Resource": "arn:aws:kms:*:123456789012:key/*"
        }
    ]
}