MCP connector

Подключите MCP серверы к вашим агентам для доступа к внешним инструментам и источникам данных.

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

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

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

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

Все запросы Managed Agents API требуют заголовка бета-версии managed-agents-2026-04-01. SDK автоматически устанавливает заголовок бета-версии.

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

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

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

AGENT_ID=$(ant beta:agents create \
  --name "GitHub Assistant" \
  --model claude-opus-4-7 \
  --mcp-server '{type: url, name: github, url: "https://api.githubcopilot.com/mcp/"}' \
  --tool '{type: agent_toolset_20260401}' \
  --tool '{type: mcp_toolset, mcp_server_name: github}' \
  --transform id --raw-output)

Набор инструментов MCP по умолчанию использует политику разрешений always_ask, которая требует одобрения пользователя перед каждым вызовом инструмента. См. политики разрешений для настройки этого поведения.

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

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

session = client.beta.sessions.create(
    agent=agent.id,
    environment_id=environment.id,
    vault_ids=[vault.id],
)

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

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

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

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

Was this page helpful?

РазработкаОпределение агента