Conector MCP da API do Claude

A Messages API se conecta a um servidor MCP remoto por você. Nomeie o Sallyport em mcp_servers, ative as ferramentas dele em tools e passe um token de agente como authorization_token.

Conecte

Em Agentes, clique em «Novo agente» e «Criar agente», depois em «Novo token» em «Tokens». Guarde o token em SP_AGENT_TOKEN ao lado de 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

O conector está em beta com anthropic-beta: mcp-client-2025-11-20 e aceita chamadas de ferramentas. A resposta traz blocos mcp_tool_use e mcp_tool_result.

Dê a cada um dos seus clientes um agente próprio. Assim o token limita o modelo às conexões desse agente, e o registro nomeia o agente por trás de cada chamada.

Quando uma chamada espera por uma pessoa

O mcp_tool_result de uma chamada em espera traz approve_url e call_id. Mostre o link para a pessoa que responde por esse serviço.

Quando ela responder, continue a conversa. O resultado diz ao modelo para repetir a chamada com o mesmo call_id, que devolve o desfecho, então o serviço é chamado uma vez.

authorization_token recebe o token do agente como ele é, sem Bearer. Não há fluxo OAuth para fazer antes: o console emite o token.