Connecteur MCP de l’API Claude

La Messages API se connecte pour vous à un serveur MCP distant. Nommez Sallyport dans mcp_servers, activez ses outils dans tools et passez un jeton d’agent dans authorization_token.

Connectez-le

Dans Agents, cliquez sur « Nouvel agent » et « Créer l’agent », puis sur « Nouveau jeton » sous « Jetons ». Gardez le jeton dans SP_AGENT_TOKEN à côté 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

Le connecteur est en bêta derrière anthropic-beta: mcp-client-2025-11-20 et prend en charge les appels d’outils. La réponse contient des blocs mcp_tool_use et mcp_tool_result.

Donnez à chacun de vos clients son propre agent. Le jeton limite alors le modèle aux connexions de cet agent, et le journal nomme l’agent derrière chaque appel.

Quand un appel attend une personne

Le mcp_tool_result d’un appel en attente contient approve_url et call_id. Montrez le lien à la personne qui répond pour ce service.

Une fois qu’elle a répondu, poursuivez la conversation. Le résultat dit au modèle de répéter l’appel avec le même call_id, qui renvoie l’issue : le service est appelé une seule fois.

authorization_token prend le jeton d’agent tel quel, sans Bearer. Aucun flux OAuth à mener avant : la console émet le jeton.