Definir tu agente

Conector MCP

Conecta servidores MCP a tus agentes para acceder a herramientas externas y fuentes de datos.

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:

Creación del agente declara a qué servidores MCP se conecta el agente, por nombre y URL.
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.

Todas las solicitudes de la API de Managed Agents requieren el encabezado beta managed-agents-2026-04-01. El SDK establece el encabezado beta automáticamente.

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_response=$(curl -sS --fail-with-body https://api.anthropic.com/v1/agents \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d @- <<'EOF'
{
  "name": "GitHub Assistant",
  "model": "claude-sonnet-4-6",
  "mcp_servers": [
    {
      "type": "url",
      "name": "github",
      "url": "https://api.githubcopilot.com/mcp/"
    }
  ],
  "tools": [
    {"type": "agent_toolset_20260401"},
    {"type": "mcp_toolset", "mcp_server_name": "github"}
  ]
}
EOF
)
agent_id=$(jq -r '.id' <<<"$agent_response")

El conjunto de herramientas MCP tiene por defecto una política de permisos de always_ask, que requiere aprobación del usuario antes de cada llamada de herramienta. Consulta políticas de permisos para configurar este comportamiento.

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_response=$(curl -sS --fail-with-body https://api.anthropic.com/v1/sessions \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d @- <<EOF
{
  "agent": "$agent_id",
  "environment_id": "$environment_id",
  "vault_ids": ["$vault_id"]
}
EOF
)
session_id=$(jq -r '.id' <<<"$session_response")

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.

Was this page helpful?

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_response=$(curl -sS --fail-with-body https://api.anthropic.com/v1/agents \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d @- <<'EOF'
{
  "name": "GitHub Assistant",
  "model": "claude-sonnet-4-6",
  "mcp_servers": [
    {
      "type": "url",
      "name": "github",
      "url": "https://api.githubcopilot.com/mcp/"
    }
  ],
  "tools": [
    {"type": "agent_toolset_20260401"},
    {"type": "mcp_toolset", "mcp_server_name": "github"}
  ]
}
EOF
)
agent_id=$(jq -r '.id' <<<"$agent_response")

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

session_response=$(curl -sS --fail-with-body https://api.anthropic.com/v1/sessions \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d @- <<EOF
{
  "agent": "$agent_id",
  "environment_id": "$environment_id",
  "vault_ids": ["$vault_id"]
}
EOF
)
session_id=$(jq -r '.id' <<<"$session_response")