Коннектор MCP в Claude API

Ваше приложение вызывает Claude с подключённым Sallyport. Модель получает инструменты, а ключи никогда.

Messages API сам подключается к удалённому MCP-серверу. Назовите Sallyport в mcp_servers, включите его инструменты в tools и передайте токен агента в authorization_token.

Подключение

В разделе Агенты нажмите «Новый агент» и «Создать агента», затем «Новый токен» в разделе «Токены». Храните токен в SP_AGENT_TOKEN рядом с 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

Коннектор работает в бете с заголовком anthropic-beta: mcp-client-2025-11-20 и поддерживает вызовы инструментов. В ответе приходят блоки mcp_tool_use и mcp_tool_result.

Дайте каждому своему клиенту отдельного агента. Тогда токен ограничивает модель подключениями этого агента, а журнал называет агента за каждым вызовом.

Когда вызов ждёт человека

В mcp_tool_result ожидающего вызова приходят approve_url и call_id. Покажите ссылку тому, кто отвечает за этот сервис.

Когда человек ответит, продолжите разговор. Результат подсказывает модели повторить вызов с тем же call_id, и этот повтор возвращает итог, так что сервис вызывается один раз.

authorization_token принимает сам токен агента, без Bearer. Проходить OAuth заранее не нужно: токен выдаёт консоль.

Подключение

Когда вызов ждёт человека

Подключите агента, который открыт прямо сейчас