MCP connector

Claude Managed Agents поддерживает подключение серверов Model Context Protocol (MCP) к вашим агентам. Это дает агенту доступ к внешним инструментам, источникам данных и сервисам через стандартизированный протокол.

Конфигурация MCP разделена на два этапа:

1. Создание агента объявляет, какие MCP серверы подключает агент, по имени и URL.
2. Создание сессии предоставляет аутентификацию для этих серверов путем ссылки на предварительно зарегистрированное хранилище.

Это разделение держит секреты вне переиспользуемых определений агентов, позволяя каждой сессии аутентифицироваться с собственными учетными данными.

Объявите MCP серверы на агенте

Укажите MCP серверы в массиве mcp_servers при создании агента. Каждому серверу нужен type, уникальное name и url. На этом этапе токены аутентификации не предоставляются.

name, который вы назначаете в массиве MCP сервера, используется для ссылки на записи mcp_toolset в массиве инструментов.

agent_response=$(curl -sS --fail-with-body https://api.anthropic.com/v1/agents \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d @- <<'EOF'
{
  "name": "GitHub Assistant",
  "model": "claude-sonnet-4-6",
  "mcp_servers": [
    {
      "type": "url",
      "name": "github",
      "url": "https://api.githubcopilot.com/mcp/"
    }
  ],
  "tools": [
    {"type": "agent_toolset_20260401"},
    {"type": "mcp_toolset", "mcp_server_name": "github"}
  ]
}
EOF
)
agent_id=$(jq -r '.id' <<<"$agent_response")

Предоставьте аутентификацию при создании сессии

При запуске сессии передайте vault_ids для предоставления учетных данных для ваших MCP серверов. Хранилища — это коллекции учетных данных, которые вы регистрируете один раз и ссылаетесь по ID. См. Аутентификация с хранилищами для информации о создании хранилищ и управлении учетными данными.

session_response=$(curl -sS --fail-with-body https://api.anthropic.com/v1/sessions \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d @- <<EOF
{
  "agent": "$agent_id",
  "environment_id": "$environment_id",
  "vault_ids": ["$vault_id"]
}
EOF
)
session_id=$(jq -r '.id' <<<"$session_response")

Если учетные данные аутентификации, предоставленные в хранилище, недействительны, создание сессии будет успешным, и взаимодействие все еще возможно. Генерируется событие session.error, описывающее ошибку аутентификации MCP. Вы можете решить, блокировать ли дальнейшие взаимодействия на этой ошибке, запустить обновление учетных данных или позволить сессии продолжить работу без MCP. Повторные попытки аутентификации произойдут при следующем переходе session.status_idle на session.status_running. См. Поток событий сессии для деталей о потреблении session.error и других событий.

Поддерживаемые типы MCP серверов

Claude Managed Agents подключается к удаленным MCP серверам, которые предоставляют HTTP конечную точку. Сервер должен поддерживать потоковый HTTP транспорт протокола MCP.

Для получения дополнительной информации о MCP и создании MCP серверов см. документацию MCP.