MCP-Connector der Claude API

Die Messages API verbindet sich für Sie mit einem entfernten MCP-Server. Nennen Sie Sallyport in mcp_servers, schalten Sie seine Tools in tools ein und übergeben Sie einen Agent-Token als authorization_token.

Verbinden

Klicken Sie unter Agenten auf „Neuer Agent“ und „Agent erstellen“, dann unter „Token“ auf „Neuer Token“. Legen Sie den Token in SP_AGENT_TOKEN neben ANTHROPIC_API_KEY ab.

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

Der Connector ist in der Beta hinter anthropic-beta: mcp-client-2025-11-20 und unterstützt Tool-Aufrufe. Die Antwort enthält Blöcke mcp_tool_use und mcp_tool_result.

Geben Sie jedem Ihrer Kunden einen eigenen Agenten. Der Token beschränkt das Modell dann auf die Verbindungen dieses Agenten, und das Journal nennt den Agenten hinter jedem Aufruf.

Wenn ein Aufruf auf einen Menschen wartet

Das mcp_tool_result eines wartenden Aufrufs enthält approve_url und call_id. Zeigen Sie den Link der Person, die für diesen Dienst antwortet.

Sobald sie geantwortet hat, führen Sie die Unterhaltung fort. Das Ergebnis sagt dem Modell, den Aufruf mit derselben call_id zu wiederholen, und diese Wiederholung liefert den Ausgang. Der Dienst wird einmal aufgerufen.

authorization_token nimmt den Agent-Token unverändert, ohne Bearer. Einen OAuth-Ablauf vorher gibt es nicht: Den Token stellt die Konsole aus.