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

Справка

Безопасность и частые ошибки

Правила безопасной работы и короткие проверки для частых проблем.

На этой странице
  • MCP API-токены создаются и отзываются на странице «Подключение агента».
  • Полное значение MCP API-токена показывается только один раз после создания.
  • MCP API-токен не нужно отправлять агенту в чат и не нужно писать в контекст аккаунта или проекта.
  • Не храните MCP API-токен в .mcp.json, project .codex/config.toml и других файлах проекта.
  • Если MCP API-токен раскрыт, отзовите его на странице «Подключение агента» и создайте новый.
  • Токены и ключи внешних источников вводятся только в защищённые поля подключения.
  • Read-only источники не должны выполнять действия изменения данных.
  • Скриншоты для документации должны быть очищены от токенов, webhook secret, email, телефонов и персональных данных.

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

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

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

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

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

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

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

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