Документация Atlas MCP

1.1 Codex

• Аккаунт Atlas MCP с доступом к кабинету.
• MCP endpoint Atlas MCP.
• Codex CLI или Codex App с поддержкой MCP.
• Доступ к браузеру для OAuth-входа, если клиент запросит авторизацию.

Добавьте MCP-сервер в конфигурацию Codex. Имя atlas-mcp локальное: его можно заменить, если в вашей установке уже используется другой alias.

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

1. Откройте настройки Codex или файл config.toml.
2. Добавьте MCP-сервер Atlas MCP с URL endpoint.
3. Сохраните конфигурацию и перезапустите Codex, если клиент не перечитывает конфиг автоматически.
4. Запустите вход через MCP, если Codex попросит авторизацию.
5. Попросите агента вызвать documentation_get и получить индекс доступных источников.

codex mcp login atlas-mcp
codex mcp list

1.2 Claude Code

• Аккаунт Atlas MCP с доступом к кабинету.
• Установленный Claude Code.
• MCP endpoint Atlas MCP.
• Доступ к авторизации, если Atlas MCP запросит OAuth-вход.

Claude Code умеет добавлять MCP-серверы через CLI и хранить project-scoped конфигурацию в .mcp.json. Для remote endpoint используйте HTTP transport.

claude mcp add --transport http atlas-mcp https://atlas-mcp.ru/mcp

Если вы храните конфигурацию в проекте, пример .mcp.json выглядит так:

{
  "mcpServers": {
    "atlas-mcp": {
      "type": "http",
      "url": "https://atlas-mcp.ru/mcp"
    }
  }
}

1. Добавьте сервер atlas-mcp через команду или через .mcp.json.
2. Перезапустите Claude Code или обновите список MCP-серверов.
3. Проверьте, что сервер виден в списке MCP.
4. Попросите агента вызвать documentation_get, затем session.context у нужного source.

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

• Агент видит MCP-сервер Atlas MCP.
• Публичные tools: documentation_get, direct, wordstat, bitrix, metrica, amocrm, calltouch, roistat, avito, avito_ads, ozon, vk_ads, project_context, feedback.
• documentation_get возвращает индекс и карточки действий.
• session.context показывает профиль пользователя, sources, аккаунты, проекты, подписки, баланс и лимиты.
• project_context возвращает полный markdown проекта или контекст конкретного аккаунта по запросу.
• Агент выбирает source и account_id только после просмотра доступных пользователю аккаунтов.

2.1 Что такое контекст

• Главные цели и KPI проекта.
• Кампании, воронки, регионы или продукты, которые важнее остальных.
• Правила качества лидов, сделок, звонков и заявок.
• Ограничения: что агенту нельзя предлагать или менять без согласования.
• Соглашения по атрибуции, часовому поясу, периодам и исключениям.

2.2 Контекст аккаунта

Контекст аккаунта привязан к конкретному аккаунту источника: Direct-логину, счётчику Метрики, порталу Bitrix24, аккаунту amoCRM, проекту Calltouch или Roistat. В UI поле называется «Контекст аккаунта» и принимает до 8000 символов или файл .txt/.md.

Основная цель — заявки на консультацию.
Ключевые кампании: бренд, поиск, ретаргетинг.
Не учитывать тестовые кампании и кампании с пометкой draft.
CPA выше 2500 руб. считать проблемным.

2.3 Контекст проекта

Контекст проекта привязан не к одному источнику, а к проекту. Проект может объединять Direct, Metrica, Bitrix24, amoCRM, Calltouch и Roistat. В UI можно ввести до 50000 символов markdown или загрузить .txt/.md.

Агент видит компактный список проектов в session.context, а полный markdown проекта или контекст аккаунта читает через project_context.

Проект: интернет-магазин мебели.

Главная бизнес-цель — продажи кухонь и шкафов на заказ.
Основной KPI — стоимость квалифицированной заявки.
Важнее качество заявок, чем их количество.
Регионы: Москва и Московская область.
Не предлагать отключать брендовые кампании без отдельного согласования.

2.4 Какой контекст куда писать

2.5 Что нельзя писать в контекст

• Пароли, OAuth-токены, API key и webhook URL с секретами.
• Приватные ключи и одноразовые коды входа.
• Персональные данные клиентов без необходимости.
• Данные банковских карт и платёжные реквизиты.
• Любые секреты, которые должны храниться только в защищённых полях интеграции.

3.1 Direct

Direct даёт агенту read-only доступ к рекламным аккаунтам Яндекс.Директа: кампаниям, группам, объявлениям, фразам, бюджетам, статистике, целям и отчётам.

• Основной сценарий: Яндекс OAuth, затем выбор Direct-логинов.
• Ручной сценарий: login Direct-аккаунта и OAuth token с доступом к Direct API.
• Контекст аккаунта: важные кампании, тестовые кампании, целевой CPA/CPL, регионы, цели и запреты.
• После подключения агент увидит source direct, список аккаунтов и сможет читать доступные действия через documentation_get.

3.2 Metrica

Metrica даёт агенту read-only доступ к счётчикам Яндекс.Метрики, целям, отчётам, drilldown, bytime, comparison, визитам и конверсиям.

• Основной сценарий: общее подключение Яндекса и выбор счётчиков.
• Ручной сценарий: OAuth token с доступом к Метрике и Counter ID.
• Контекст аккаунта: главные цели, микроцели, сегменты, исключённые визиты, приоритетные страницы и правила анализа источников трафика.
• После подключения агент увидит source metrica и сможет запрашивать отчёты по выбранному счётчику.

3.3 Bitrix24

Bitrix24 даёт агенту read-only доступ к CRM-данным: лидам, сделкам, компаниям, контактам, стадиям, воронкам, metadata и пользовательским полям, если они доступны через API.

• Подключение выполняется через входящий webhook Bitrix24.
• Нужно подготовить webhook URL и права webhook на чтение нужных CRM-данных.
• Контекст аккаунта: важные воронки, успешные и мусорные стадии, поля квалификации, тестовые лиды, менеджеры и отделы проекта.
• После подключения агент увидит source bitrix, портал и доступные методы через documentation_get.

3.4 amoCRM

amoCRM подключается через OAuth и даёт агенту read-only доступ к CRM-данным: сделкам, контактам, компаниям, воронкам, статусам, задачам, событиям, metadata и безопасным raw GET endpoints.

• Ручные токены вводить не нужно: пользователь проходит OAuth-авторизацию.
• Нужно иметь доступ к аккаунту amoCRM и права на авторизацию интеграции.
• Контекст аккаунта: основная воронка, целевые статусы, статусы отказа, признаки качественной сделки, важные поля и исключения.
• После подключения агент увидит source amocrm и сможет читать доступные сущности аккаунта.

3.5 Calltouch

Calltouch подключается вручную и даёт агенту read-only доступ к звонкам, заявкам, сделкам, клиентам, источникам, справочникам и рекламным данным, если они доступны через API.

• Нужно подготовить API token Calltouch и site_id проекта.
• Контекст аккаунта: целевые звонки, минимальная длительность, номера и источники для исключения, правила дублей и модель атрибуции.
• После подключения агент увидит source calltouch и сможет запрашивать действия, описанные в documentation_get.

3.6 Roistat

Roistat подключается по API key и Project ID. Агент получает read-only доступ к аналитике, визитам, заказам, клиентам, звонкам, маркетинговым источникам, расходам и выручке, если эти данные доступны через API проекта.

• Нужно подготовить API key Roistat и числовой Project ID.
• Контекст аккаунта: модель атрибуции, статусы продаж, исключаемые заказы, целевой ROMI/ROI/CPO, правила дублей и важные каналы.
• После подключения агент увидит source roistat и сможет читать отчёты и справочники через documented actions.

3.7 Wordstat

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

• Источник доступен без индивидуальной настройки аккаунта.
• Для Wordstat полезнее заполнять контекст проекта: регион продвижения, тематика, минус-темы, запрещённые сегменты, приоритетные продукты и сезонность.
• После подключения MCP агент увидит source wordstat в public catalog и сможет вызывать documented actions в рамках дневного лимита.

4.1 Агент не видит источник

• Проверьте, что источник подключён и активен.
• Проверьте, что аккаунт добавлен в проект, если агент работает в рамках проекта.
• Проверьте права пользователя на аккаунт.
• Попросите агента заново вызвать documentation_get и session.context.

4.2 Агент видит не тот аккаунт

• Проверьте выбранный проект.
• Проверьте привязку аккаунтов к проекту.
• Переименуйте аккаунт в понятное название.
• Заполните контекст аккаунта, чтобы агент понимал назначение источника.

4.3 Ошибка авторизации

• Проверьте, что token, API key или webhook не истёк и не был удалён.
• Проверьте права интеграции во внешнем сервисе.
• Для OAuth-источников пройдите подключение заново.
• Если секрет случайно раскрыт, перевыпустите его во внешнем сервисе и обновите подключение.

4.4 Неверные данные в отчётах

• Проверьте период отчёта, часовой пояс и фильтры.
• Проверьте цели, модель атрибуции и CRM-стадии.
• Проверьте исключённые кампании, визиты, воронки и тестовые данные.
• Добавьте недостающие правила в контекст проекта или контекст аккаунта.