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.

Contrato de protocolo MCP

Comprenda los requisitos para implementar el Protocolo de contexto modelo (MCP) para que los agentes puedan llamar a las herramientas y a los servidores de agentes.

Para ver un ejemplo de código, consulte Implementar servidores MCP en AgentCore tiempo de ejecución.

Requisitos de implementación del protocolo

Su servidor MCP debe implementar estos requisitos de protocolo específicos:

Administración de sesiones MCP y capacidad de almacenamiento de microVM

El protocolo de contexto modelo (MCP) usa el Mcp-Session-Id encabezado para administrar el estado de la sesión y enrutar las solicitudes. Para ver la especificación MCP, consulte MCP Streamable HTTP Transport.

Resistencia de la microVM: Amazon Bedrock AgentCore usa el Mcp-Session-Id encabezado para dirigir las solicitudes a la misma instancia de microVM. Los clientes deben capturar la información Mcp-Session-Id devuelta en la respuesta e incluirla en todas las solicitudes posteriores para garantizar la afinidad de la sesión. Sin un identificador de sesión coherente, cada solicitud puede enrutarse a una microVM nueva, lo que puede provocar una latencia adicional debido a los arranques en frío.

MCP sin estado (): stateless_http=True

MCP con estado (): stateless_http=False

Para obtener más información sobre la administración de sesiones MCP con estado, consulte la especificación de administración de sesiones MCP.

Requisitos de contenedores

Su servidor MCP debe implementarse como una aplicación en contenedores que cumpla con estas especificaciones:

Requisitos de ruta

/mcp - POST

Finalidad

Recibe los mensajes RPC de MCP y los procesa a través de las herramientas de su agente. Transfiere completamente la carga útil de la InvokeAgentRuntime API con los mensajes RPC de MCP estándar

Formato de las respuestas

JSON-RPC request/response formato basado, compatible con ambos tipos de contenido y como respuesta application/json text/event-stream

Casos de uso

El /mcp punto final cumple varios propósitos clave:

Gestión de errores

Los servidores MCP devuelven los errores como respuestas de error estándar JSON-RPC 2.0. La mayoría de los errores se almacenan en el JSON-RPC error objeto con un código de estado HTTP 200, tal como exige la especificación MCP. Solo los errores de autenticación, autorización y solicitud a nivel de protocolo utilizan códigos de estado HTTP distintos de los 200. La siguiente tabla asigna cada excepción de tiempo de ejecución a su código de JSON-RPC error, código de estado HTTP y mensaje. Algunas excepciones comparten un código de JSON-RPC error pero devuelven mensajes diferentes, por lo que aparecen en filas independientes.

ConflictExceptiony RetryableConflictException ambos utilizan JSON-RPC un código de error -32005 (HTTP 200) pero se distinguen por su mensaje. El servicio devuelve RetryableConflictException (Session operation in progress, please retry) cuando una segunda operación apunta a una sesión mientras el servicio está aprovisionando o cancelando esa sesión. Como MCP devuelve el HTTP 200 con el error en el JSON-RPC cuerpo, la persona que llama debe inspeccionar el cuerpo de la respuesta y volver a intentarlo con un breve retraso exponencial; los clientes de MCP no lo reintentan automáticamente.

Ejemplo de respuesta de error:

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

Respuestas de autenticación de OAuth

OAuth-configured los agentes siguen los estándares de autenticación RFC 6749 (OAuth 2.0). Cuando falta la autenticación, el servicio devuelve una respuesta no autorizada 401 con un WWW-Authenticate encabezado (según la RFC 7235), lo que permite a los clientes descubrir los puntos finales del servidor de autorización a través de la API. GetRuntimeProtectedResourceMetadata

401 sin autorización

Se devuelve cuando el encabezado de autorización falta o está vacío.

La respuesta incluye WWW-Authenticate el encabezado:

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