Conector MCP

Claude Managed Agents admite la conexión de servidores Model Context Protocol (MCP) a tus agentes. Esto le da al agente acceso a herramientas externas, fuentes de datos y servicios a través de un protocolo estandarizado.

La configuración de MCP se divide en dos pasos:

1. Creación del agente declara a qué servidores MCP se conecta el agente, por nombre y URL.
2. Creación de sesión proporciona autenticación para esos servidores haciendo referencia a un vault pre-registrado.

Esta separación mantiene los secretos fuera de las definiciones de agentes reutilizables mientras permite que cada sesión se autentique con sus propias credenciales.

Declara servidores MCP en el agente

Especifica servidores MCP en el array mcp_servers al crear un agente. Cada servidor necesita un type, un name único y una url. No se proporcionan tokens de autenticación en esta etapa.

El name que asignes en el array del servidor MCP se utiliza para hacer referencia a las entradas mcp_toolset en el array de herramientas.

AGENT_ID=$(ant beta:agents create \
  --name "GitHub Assistant" \
  --model claude-opus-4-7 \
  --mcp-server '{type: url, name: github, url: "https://api.githubcopilot.com/mcp/"}' \
  --tool '{type: agent_toolset_20260401}' \
  --tool '{type: mcp_toolset, mcp_server_name: github}' \
  --transform id --raw-output)

Proporciona autenticación en la creación de sesión

Al iniciar una sesión, pasa vault_ids para proporcionar credenciales para tus servidores MCP. Los vaults son colecciones de credenciales que registras una vez y referencias por ID. Consulta Autenticarse con vaults para saber cómo crear vaults y gestionar credenciales.

session = client.beta.sessions.create(
    agent=agent.id,
    environment_id=environment.id,
    vault_ids=[vault.id],
)

Si las credenciales de autorización proporcionadas en el vault no son válidas, la creación de sesión tendrá éxito y la interacción sigue siendo posible. Se emite un evento session.error que describe el fallo de autenticación de MCP. Puedes decidir si bloquear más interacciones en este error, desencadenar una actualización de credenciales o permitir que la sesión continúe sin el MCP. Los reintentos de autenticación ocurrirán en la siguiente transición de session.status_idle a session.status_running. Consulta Flujo de eventos de sesión para obtener detalles sobre cómo consumir session.error y otros eventos.

Tipos de servidores MCP admitidos

Claude Managed Agents se conecta a servidores MCP remotos que exponen un punto final HTTP. El servidor debe admitir el transporte HTTP transmisible del protocolo MCP.

Para obtener más información sobre MCP y crear servidores MCP, consulta la documentación de MCP.