Conector MCP de la API de Claude

La Messages API se conecta por ti a un servidor MCP remoto. Nombra Sallyport en mcp_servers, activa sus herramientas en tools y pasa un token de agente como authorization_token.

Conéctalo

En Agentes, pulsa «Nuevo agente» y «Crear agente», y luego «Nuevo token» en «Tokens». Guarda el token en SP_AGENT_TOKEN junto a ANTHROPIC_API_KEY.

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: mcp-client-2025-11-20" \
  -d @- <<EOF
{
  "model": "claude-opus-5-5",
  "max_tokens": 1024,
  "messages": [
    { "role": "user", "content": "Which services can you reach through Sallyport?" }
  ],
  "mcp_servers": [
    {
      "type": "url",
      "url": "https://mcp.sallyport.cloud/mcp",
      "name": "sallyport",
      "authorization_token": "$SP_AGENT_TOKEN"
    }
  ],
  "tools": [
    { "type": "mcp_toolset", "mcp_server_name": "sallyport" }
  ]
}
EOF

El conector está en beta con anthropic-beta: mcp-client-2025-11-20 y admite llamadas a herramientas. La respuesta trae bloques mcp_tool_use y mcp_tool_result.

Da a cada uno de tus clientes un agente propio. Así el token limita el modelo a las conexiones de ese agente, y el registro nombra al agente detrás de cada llamada.

Cuando una llamada espera a una persona

El mcp_tool_result de una llamada en espera lleva approve_url y call_id. Muestra el enlace a la persona que responde por ese servicio.

Cuando responda, sigue la conversación. El resultado indica al modelo que repita la llamada con el mismo call_id, que devuelve el desenlace, así que el servicio se llama una sola vez.

authorization_token recibe el token del agente tal cual, sin Bearer. No hay que hacer ningún flujo OAuth antes: el token lo emite la consola.