# Atlas MCP

Подключение Codex, Claude Code и других MCP-клиентов через MCP API-токен. Актуальный список источников, инструментов, действий и схем доступен внутри MCP через documentation_get.

## 1. Основной способ подключения

Создайте MCP API-токен на странице «Подключение агента». Это основной способ подключить агента к Atlas MCP.

На этой странице доступны три варианта: Codex, Claude и «Подключить вручную». Для Codex и Claude после выбора агента нужно выбрать систему: macOS, Linux или Windows.

OAuth-вход MCP-клиента можно оставить как расширенный или запасной сценарий, но для обычного подключения начинайте со страницы «Подключение агента» и API-токена.

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

## 2. Подключение через страницу «Подключение агента»

Откройте страницу «Подключение агента». Она показывает готовый сценарий подключения и управляет MCP API-токенами.

1. Откройте страницу «Подключение агента».
2. Выберите Codex, Claude или «Подключить вручную».
3. Для Codex или Claude выберите систему: macOS, Linux или Windows. При ручном подключении этот шаг не нужен.
4. Нажмите «Создать токен».
5. Дайте токену понятное название, например «Claude laptop» или «Codex desktop».
6. Скопируйте токен сразу после создания. После обновления страницы полное значение больше не показывается.
7. Нажмите «Я сохранил».
8. Скопируйте полную команду установки или параметры подключения.
9. Нажмите «Закончить установку».
10. Вставьте команду в терминал или настройки MCP-клиента.
11. Перезапустите агент, если он уже был открыт.

Важно: Не сохраняйте токен в файлах проекта, которые могут попасть в git: .mcp.json, project .codex/config.toml, README, заметки, issue или чат. Для Codex используйте пользовательский ~/.codex/config.toml или ${CODEX_HOME}/config.toml.

## 3. Команды и параметры для клиентов

На странице «Подключение агента» команда или параметры собираются автоматически под выбранную систему и агента. Примеры ниже показывают формат, но вместо <API_TOKEN> нужно использовать токен, созданный на этой странице.

### 3.1 Claude Code

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

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

После добавления проверьте, что сервер atlas-mcp появился в списке MCP-серверов Claude Code. Если Claude Code уже был открыт, перезапустите его.

### 3.2 Codex

Для Codex используйте команду со страницы «Подключение агента». Она обновляет пользовательский config.toml и добавляет Atlas MCP с нужными параметрами подключения.

```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. Не добавляйте токен в конфиг внутри проекта.

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

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

| Параметр | Значение |
| --- | --- |
| Название MCP-сервера | atlas-mcp |
| Способ подключения | HTTP |
| URL | https://atlas-mcp.ru/mcp |
| Заголовок | Authorization: Bearer <API_TOKEN> |

Если в разделе «Подключение агента» указан другой адрес MCP-сервера, используйте адрес с этой страницы.

## 4. Если API-токен уже создан

Полное значение MCP API-токена показывается только один раз — сразу после создания. Позже на странице «Подключение агента» видны только название, префикс, дата создания, срок действия, последнее использование и статистика вызовов.

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

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

После подключения попросите агента проверить MCP-сервер Atlas MCP.

1. Вызвать documentation_get.
2. Проверить, что MCP вернул индекс доступных источников, инструментов, действий и схем.
3. Вызвать session.context у нужного источника.
4. Вызвать accounts.list у нужного источника, если источник работает с аккаунтами.
5. Выбирать source и account_id только после просмотра доступных аккаунтов. Source — это код источника, account_id — ID аккаунта.

Для Direct проверка обычно начинается с direct: сначала session.context, затем accounts.list. Для других источников используйте source и actions, которые вернул documentation_get.

Примечание: Страница /docs/mcp не дублирует полный список инструментов и схем. Точные правила вызовов MCP нужно читать через documentation_get в подключённом клиенте.

## 6. Безопасность

- MCP API-токен даёт доступ к MCP-адресу /mcp в рамках прав пользователя.
- Не отправляйте токен агенту в чат.
- Не вставляйте токен в публичные документы, задачи, комментарии, скриншоты и обучающие примеры.
- Не храните токен в файлах проекта, которые могут быть закоммичены.
- Для разных устройств и агентов лучше создавать разные токены.
- Если токен раскрыт, отзовите его на странице «Подключение агента» и создайте новый.
- При необходимости включайте ограничение срока действия при создании токена.

Важно: MCP API-токен не заменяет обычную браузерную сессию Atlas MCP и не предназначен для вызова обычных /api-адресов. Используйте его только для MCP-адреса.

## 7. OAuth как запасной сценарий

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

Не смешивайте два разных вида авторизации: OAuth внешних источников данных нужен для подключения Direct, Metrica или amoCRM в кабинете, а MCP API-токен нужен агенту для доступа к Atlas MCP.

## 8. Текстовая версия инструкции

Текстовая версия этой инструкции доступна на /docs/mcp/raw. Она генерируется из того же источника, что и страница /docs/mcp.