# Atlas MCP

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

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

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

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

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

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

```bash
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, не основной путь.

```bash
claude mcp add --transport http --scope user atlas-mcp https://atlas-mcp.ru/mcp \
  --header "Authorization: Bearer <API_TOKEN>"
```

```toml
[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 в подключённом клиенте.