atlas-mcp
Разделы документации

Начало

Подключение агента

Настройте Atlas MCP в Codex, Claude Code или другом MCP-клиенте и проверьте подключение.

На этой странице

Atlas MCP отдаёт данные агентам через MCP-адрес. Создайте MCP API-токен на странице «Подключение агента» и выберите один из трёх вариантов: Codex, Claude или «Подключить вручную». После подключения агент получает актуальную документацию через documentation_get и работает только в рамках прав пользователя.

Не отправляйте агенту MCP API-токены, OAuth-токены, API key, webhook URL и пароли. MCP API-токен используйте только через готовую команду или параметры со страницы «Подключение агента».

Codex

Для Codex откройте страницу «Подключение агента», выберите Codex и вашу систему, создайте MCP API-токен и скопируйте готовую команду. Команда обновит пользовательский ~/.codex/config.toml или ${CODEX_HOME}/config.toml и добавит Atlas MCP с нужными параметрами подключения.

[mcp_servers."atlas-mcp"]
url = "https://atlas-mcp.ru/mcp"
http_headers = { Authorization = "Bearer <API_TOKEN>" }
  1. Откройте страницу «Подключение агента».
  2. Выберите Codex и систему.
  3. Создайте MCP API-токен и скопируйте его сразу после создания.
  4. Нажмите «Я сохранил».
  5. Скопируйте полную команду установки.
  6. Нажмите «Закончить установку».
  7. Выполните команду на своём устройстве.
  8. Перезапустите Codex, если он уже был открыт.
  9. Проверьте подключение через documentation_get.

Подробная инструкция доступна на /docs/mcp, текстовая версия — на /docs/mcp/raw.

Claude Code

Для Claude Code откройте страницу «Подключение агента», выберите «Claude» и вашу систему, создайте MCP API-токен и скопируйте готовую команду. Команда добавит Atlas MCP как HTTP MCP-сервер в пользовательскую область настроек Claude Code.

claude mcp add --transport http --scope user atlas-mcp https://atlas-mcp.ru/mcp \
  --header "Authorization: Bearer <API_TOKEN>"
  1. Откройте страницу «Подключение агента».
  2. Выберите «Claude» и систему.
  3. Создайте MCP API-токен и скопируйте его сразу после создания.
  4. Нажмите «Я сохранил».
  5. Скопируйте полную команду установки.
  6. Нажмите «Закончить установку».
  7. Выполните команду на своём устройстве.
  8. Перезапустите Claude Code, если он уже был открыт.
  9. Проверьте подключение через documentation_get, затем session.context.

Не кладите MCP API-токен в .mcp.json внутри проекта. Такой файл легко случайно закоммитить.

Подключение вручную

Для другого MCP-клиента выберите «Подключить вручную». В этом варианте операционную систему выбирать не нужно: кабинет покажет адрес MCP-сервера и создаст отдельный MCP API-токен.

MCP server name: atlas-mcp
Transport: HTTP
URL: https://atlas-mcp.ru/mcp
Header:
Authorization: Bearer <API_TOKEN>
  1. Откройте страницу «Подключение агента».
  2. Выберите «Подключить вручную».
  3. Создайте MCP API-токен и скопируйте его сразу после создания.
  4. Нажмите «Я сохранил».
  5. Скопируйте адрес MCP-сервера и заголовок Authorization.
  6. Вставьте параметры в настройки своего MCP-клиента.
  7. Проверьте подключение через documentation_get.

Проверка подключения

  • Агент видит MCP-сервер Atlas MCP.
  • documentation_get возвращает индекс источников, инструментов, действий и схем.
  • session.context показывает доступный пользователю контекст.
  • accounts.list показывает аккаунты нужного источника, если источник работает с аккаунтами.
  • Агент выбирает source и account_id только после просмотра доступных аккаунтов. Source — это код источника, account_id — ID аккаунта.
  • Полная инструкция подключения находится на /docs/mcp, текстовая версия — на /docs/mcp/raw.