本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

MCP 服务器目标

MCP 服务器为你在 Bedro AgentCore ck 中与模型和代理进行交互提供本地工具、数据访问或自定义函数。在 Bedrock 中 AgentCore，您可以在创建网关时将预配置的 MCP 服务器定义为目标。

MCP 服务器托管代理可以发现和使用的工具、提示和资源。在 Bedrock 中 AgentCore，您可以使用网关将目标与这些功能关联并将它们连接到您的代理运行时。您可以通过执行协议握手和索引可用功能的 SynchronizeGatewayTargets API 与外部 MCP 服务器连接。有关安装和使用 MCP 服务器的更多信息，请参阅 Amazon Bedro AgentCore ck MCP 服务器：使用编程助手进行氛围编码。

主要注意事项和局限性

上市模式

ListingMode 可以将 MCP 服务器目标设置为动态或默认。

隐式同步

对于处于 DEFAULT 模式的目标， CreateGatewayTarget UpdateGatewayTarget 操作会自动触发能力发现和索引。调用任一操作时，Gateway 会使用 MCP 的tools/list功能获取可用工具，提示使用prompts/list，使用resources/list和资源resources/templates/list，并将返回的功能添加到统一目录中。

显式同步

默认模式下目标的能力目录可以通过调用 API 手动刷新。SynchronizeGatewayTargets调用时，它会更新网关的可用功能列表。每当 MCP 服务器的工具、提示、资源定义发生变化时，您都应该调用 API。

在集成 MCP 服务器时，同步是保持精确功能目录的关键机制。隐式同步在目标创建和更新期间自动发生，Gateway 会立即发现来自 MCP 服务器的工具、提示和资源并将其编入索引，以确保具有语义搜索和统一列表功能。显式同步通过 SynchronizeGatewayTargets API 按需执行，允许在 MCP 服务器独立修改其功能时发现 MCP 功能目录。

什么时候打电话 SynchronizeGatewayTargets

每当 MCP 服务器目标的列表模式设置为 DEFAULT 时，请在添加、删除或修改工具、提示或资源后使用 SynchronizeGatewayTargets API。由于 Gateway 会预先计算用于语义搜索的矢量嵌入并维护标准化功能目录，因此必须进行同步以确保您的用户能够发现和调用最新的可用工具、提示和资源。

如何调用 API

向 /gateways/ {GatewayS/ {GatewayIdentier} /发出 PUT 请求，并与请求正文中的目标 ID 同步。API 立即返回 202 响应并异步处理同步。监控目标状态 GetGatewayTarget 以跟踪同步进度，因为大型功能集的操作可能需要几分钟。

授权策略

支持以下类型的授权策略。

MCP 服务器目标的配置注意事项

必须配置以下内容。

On-behalf-of 代币交换注意事项

当您使用代表令牌交换（授权类型）作为 MCP 服务器TOKEN_EXCHANGE目标的出站授权时，以下限制适用：

保护抽样和采样请求状态（版本 2026-07-28 及更高版本）

在版本2026-07-28及更高版本中，抽取和采样使用多往返请求 (MRTR) 模式。您的 MCP 服务器目标在input_required结果中生成该requestState值；网关将该值视为不透明。网关不存储requestState。它仅在客户端和 MCP 服务器目标之间不变地转发该值时将其保存在内存中，并在请求完成时将其丢弃。

AgentCore 网关和您的 MCP 服务器目标共同负责保护请求状态：

要保护请求状态，请按照 MCP 规范中的指导进行操作。对状态进行加密或签名（例如，使用 AES-GCM 或签名的 JWT），以确保机密性和完整性。将用户特定状态绑定到原始用户，使状态过期，并将任何纯文本状态值视为不可信输入。有关更多信息，请参阅模型上下文协议网站上的多次往返请求。

使用授权码流程连接到 OAuth-protected MCP 服务器

为了支持 MCP 服务器目标的授权码授权类型（三段 OAuth），Amazon Bedrock AgentCore Gateway 提供了两种创建目标的方法。

创建 MCP 服务器目标期间的隐式同步

使用此方法，管理员用户使用响应中返回的授权 URL 在CreateGatewayTargetUpdateGatewayTarget、或SynchronizeGatewayTargets操作期间完成授权码流程。这允许亚马逊 Bedrock AgentCore Gateway 预先发现和缓存 MCP 服务器的工具。

在创建 MCP 服务器目标期间预先提供架构

使用这种方法，管理员用户在CreateGatewayTarget或使用该mcpToolSchema字段进行UpdateGatewayTarget操作期间直接提供工具架构，而不是 Amazon Bedrock AgentCore Gateway 从 MCP 服务器动态获取它们。Amazon Bedrock AgentCore Gateway 解析提供的架构并缓存工具定义。

URL 会话绑定

OAuth 2.0 授权 URL 会话绑定可验证发起 OAuth 授权请求的用户是否与授予同意的用户相同。用户完成同意后，浏览器会重定向回在目标系统上配置的具有唯一会话 URI 的返回 URL。然后，应用程序负责调用 CompleteResourceTokenAuth API，提供用户的身份和会话 URI。Amazon Bedrock I AgentCore dentity 会验证启动流程的用户是否与在将授权码交换为访问令牌之前完成流程的用户相同。

这样可以防止用户意外共享授权 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/*"
        }
    ]
}