Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Destinos de servidores MCP

Los servidores MCP proporcionan herramientas locales, acceso a datos o funciones personalizadas para sus interacciones con los modelos y los agentes de Bedrock. AgentCore En Bedrock AgentCore, puede definir un servidor MCP preconfigurado como destino al crear una puerta de enlace.

Los servidores MCP alojan herramientas, indicaciones y recursos que los agentes pueden descubrir y utilizar. En Bedrock AgentCore, utiliza una puerta de enlace para asociar los objetivos a estas capacidades y conectarlos al tiempo de ejecución de su agente. Se conecta con servidores MCP externos a través de la SynchronizeGatewayTargets API, que realiza protocolos de enlace e indexa las capacidades disponibles. Para obtener más información sobre la instalación y el uso de servidores MCP, consulte Amazon Bedrock AgentCore MCP Server: Vibe coding with your coding assistant.

Consideraciones y limitaciones clave

Modo de listado

ListingMode se puede establecer como DINÁMICO o PREDETERMINADO para los destinos del servidor MCP.

Sincronización implícita

Para los objetivos en modo DEFAULT, CreateGatewayTarget y UpdateGatewayTarget las operaciones activan automáticamente la detección de capacidades y la indexación. Cuando se invoca una de las operaciones, Gateway busca las herramientas disponibles utilizando la tools/list capacidad de MCP, solicita el uso, los recursos que utilizan resources/list yprompts/list, ademásresources/templates/list, agrega las capacidades devueltas al catálogo unificado.

Sincronización explícita

Los catálogos de capacidades para los objetivos en modo DEFAULT se pueden actualizar manualmente mediante una llamada a la SynchronizeGatewayTargets API. Cuando se llama, actualiza la lista de capacidades disponibles de Gateway. Debe llamar a la API cada vez que cambien las definiciones de herramientas, solicitudes o recursos de un servidor MCP.

La sincronización es un mecanismo fundamental para mantener catálogos de capacidades precisos al integrar los servidores MCP. La sincronización implícita se produce automáticamente durante la creación y las actualizaciones de los destinos, donde Gateway descubre e indexa inmediatamente las herramientas, las instrucciones y los recursos del servidor MCP para garantizar que las capacidades de búsqueda semántica y listas unificadas estén disponibles. La sincronización explícita se realiza bajo demanda a través de la SynchronizeGatewayTargets API, lo que permite descubrir el catálogo de capacidades del MCP cuando los servidores del MCP modifican sus capacidades de forma independiente.

¿Cuándo llamar SynchronizeGatewayTargets

Siempre que el destino de un servidor MCP tenga su modo de listado establecido en DEFAULT, utilice la SynchronizeGatewayTargets API después de agregar, eliminar o modificar las herramientas, las instrucciones o los recursos. Dado que Gateway precalcula las incrustaciones vectoriales para la búsqueda semántica y mantiene los catálogos de capacidades normalizados, la sincronización es necesaria para garantizar que los usuarios puedan descubrir e invocar las herramientas, las instrucciones y los recursos más recientes disponibles.

¿Cómo llamar a la API

Realiza una solicitud PUT a /gateways/ {GatewayIdentifier} /synchronize con el ID de destino en el cuerpo de la solicitud. La API devuelve inmediatamente una respuesta 202 y procesa la sincronización de forma asincrónica. Supervise el estado del objetivo GetGatewayTarget para realizar un seguimiento del progreso de la sincronización, ya que la operación puede tardar varios minutos en el caso de conjuntos de capacidades grandes.

Estrategia de autorización

Se admiten los siguientes tipos de estrategia de autorización.

Consideraciones de configuración para los destinos del servidor MCP

Se debe configurar lo siguiente.

On-behalf-of consideraciones sobre el intercambio de fichas

Cuando se utiliza el intercambio de fichas en nombre del intercambio de fichas (el tipo de TOKEN_EXCHANGE concesión) como autorización saliente para un destino de servidor MCP, se aplican las siguientes limitaciones:

Asegurar el estado de la solicitud para su obtención y muestreo (versión 2026-07-28 y posteriores)

En la versión 2026-07-28 y posteriores, la obtención y el muestreo utilizan el patrón de solicitudes de ida y vuelta múltiples (MRTR). El destino de su servidor MCP genera el requestState valor en un input_required resultado; la puerta de enlace trata este valor como opaco. La puerta de enlace no almacena elrequestState. Conserva el valor en la memoria únicamente mientras lo reenvía sin cambios entre su cliente y su servidor MCP de destino, y lo descarta cuando se completa la solicitud.

AgentCore Gateway y su servidor MCP de destino comparten la responsabilidad de proteger el estado de la solicitud:

Para proteger el estado de la solicitud, siga las instrucciones de la especificación MCP. Cifre o firme el estado (por ejemplo, con un JWT firmado AES-GCM o con él) para garantizar la confidencialidad y la integridad. Vincula un estado específico del usuario al usuario original, haz que caduque el estado y trata cualquier valor de estado en texto plano como una entrada que no sea de confianza. Para obtener más información, consulte las solicitudes de ida y vuelta múltiples en el sitio web del Model Context Protocol.

Conexión a un servidor OAuth-protected MCP mediante el flujo de código de autorización

Para admitir el tipo de concesión del código de autorización (OAuth de tres vías) en los destinos de los servidores MCP, Amazon Bedrock AgentCore Gateway proporciona dos métodos para la creación de objetivos.

Sincronización implícita durante la creación del destino del servidor MCP

Con este método, el usuario administrador completa el flujo del código de autorización durante CreateGatewayTarget SynchronizeGatewayTargets las operaciones o mediante la URL de autorización devuelta en la respuesta. UpdateGatewayTarget Esto permite a Amazon Bedrock AgentCore Gateway descubrir y almacenar en caché las herramientas del servidor MCP por adelantado.

Proporcione el esquema por adelantado durante la creación del destino del servidor MCP

Con este método, los usuarios administradores proporcionan el esquema de la herramienta directamente durante CreateGatewayTarget UpdateGatewayTarget las operaciones que utilizan el mcpToolSchema campo, en lugar de que Amazon Bedrock AgentCore Gateway los obtenga dinámicamente del servidor MCP. Amazon Bedrock AgentCore Gateway analiza el esquema proporcionado y almacena en caché las definiciones de las herramientas.

Enlace de sesión URL

La vinculación de la sesión con la URL de autorización de OAuth 2.0 verifica que el usuario que inició la solicitud de autorización de OAuth sea el mismo usuario que otorgó el consentimiento. Una vez que el usuario complete el consentimiento, el navegador lo redirige a una URL de retorno configurada en el destino con una URI de sesión única. La aplicación es entonces responsable de llamar a la CompleteResourceTokenAuth API, presentando tanto la identidad del usuario como el URI de la sesión. Amazon Bedrock AgentCore Identity valida que el usuario que inició el flujo es el mismo usuario que lo completó antes de cambiar el código de autorización por un token de acceso.

Esto evita que un usuario comparta accidentalmente la URL de autorización y otra persona complete el consentimiento, lo que otorgaría los tokens de acceso a la parte equivocada. La URL de autorización y la URI de sesión solo son válidas durante 10 minutos, lo que limita aún más el margen de uso indebido. El enlace de sesión se aplica durante la creación del destino (sincronización implícita) y durante la invocación de la herramienta.

Configurar los permisos

La función de IAM que utilice para crear, actualizar o sincronizar los destinos de los servidores MCP debe tener los permisos que se muestran en el siguiente ejemplo.

{
"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/*"
        }
    ]
}