MCP 服务器的目标

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

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

主要考虑因素和限制

上市模式

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

授权策略

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

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

必须配置以下内容。

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

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

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

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

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

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

URL 会话绑定

OAuth 2.0 授权网址会话绑定可验证发起 OAuth 授权请求的用户是否与授予同意的用户相同。用户完成同意后，浏览器会重定向回目标上配置的带有唯一会话 URI 的返回 URL。然后，应用程序负责调用 CompleteResourceTokenAuthAPI，同时显示用户的身份和会话 URI。Amazon Bedrock Ident AgentCore ity 会验证启动流程的用户是否与在使用授权码交换访问令牌之前完成流程的用户相同。

这样可以防止出现用户意外共享授权网址而其他人完成同意的情况，这会将访问令牌授予错误的一方。授权 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/*"
        }
    ]
}