Atlas MCP

Инструкция по подключению. Актуальная документация по sources, tools, actions и схемам доступна внутри MCP через documentation_get.

Оглавление

1. Подключение в Codex

Codex хранит MCP-настройки в config.toml. Имя секции локальное и произвольное, но в новых примерах мы рекомендуем runtime slug atlas-mcp:

[mcp_servers."atlas-mcp"]
url = "https://atlas-mcp.ru/mcp"

Если у вас уже сохранён legacy alias direct-alert, его можно не менять: это только локальное имя MCP-клиента.

После этого запустите вход:

codex mcp login atlas-mcp

Не отправляйте агенту пароли, токены и другие секретные данные. Вход выполняется через браузер.

2. API-token для локальной автоматизации

OAuth остаётся основным стандартным flow подключения MCP. API-token — workaround для Claude Code, Codex и локальной автоматизации, когда OAuth refresh нестабилен или не подходит для конкретного окружения.

  • Создавайте API-token на странице «Настройка агента» и копируйте raw token только один раз сразу после создания.
  • Новый API-token по умолчанию создаётся бессрочным; если нужен конечный срок, включите «Ограничить срок действия» в форме создания.
  • Для Claude Code используйте сгенерированную команду claude mcp add с --header Authorization: Bearer.
  • Для Codex используйте сгенерированную команду, которая обновляет user-level ~/.codex/config.toml с http_headers.Authorization.
  • Не храните token в project .codex/config.toml, .mcp.json и других коммитимых конфигах.
  • Никогда не отправляйте token в чат агенту.
  • Env var с bearer_token_env_var теперь только advanced/fallback, не основной путь.
claude mcp add --transport http --scope user atlas-mcp https://atlas-mcp.ru/mcp \
  --header "Authorization: Bearer <API_TOKEN>"
[mcp_servers."atlas-mcp"]
url = "https://atlas-mcp.ru/mcp"
http_headers = { Authorization = "Bearer <API_TOKEN>" }

Codex-блок добавляется в пользовательский ~/.codex/config.toml или в ${CODEX_HOME}/config.toml. Если выбранный агент уже открыт, перезапустите его после изменения config.

API-token даёт доступ только к MCP /mcp и не заменяет браузерную web-session для обычных /api endpoints. Если token был случайно опубликован, отзовите его и создайте новый.

3. Актуальная документация

Эта страница намеренно не дублирует список tools, actions и параметры вызовов. После подключения агент должен читать актуальную документацию из самого MCP через documentation_get.

Если нужна информация по конкретному source или action, не используйте сайт как контракт. Используйте MCP documentation_get в подключённом клиенте.