Adset.ProAdset.ProKnowledge base
To app
Home/MCP-сервис Adset/FAQ — подключение MCP (ChatGPT, Claude, Cursor)

FAQ — подключение MCP (ChatGPT, Claude, Cursor)

Ответы на частые вопросы о работе MCP-подключения Adset.Pro. Как подключить клиента и какие скоупы за что отвечают — в статье MCP-сервис Adset.

Что такое Developer mode в ChatGPT?

Режим ChatGPT, без которого нельзя добавить своё MCP-приложение: без него в настройках нет пункта «Добавить приложение». Включается один раз: Настройки → Приложения → Дополнительные настройки → Режим разработчика. Claude, Claude Code и Cursor такой режим не требуют.


Клиент пишет, что инструменты недоступны

  • ChatGPT: проверьте, что включён Developer mode, а приложение Adset.Pro в статусе Connected.

  • Скоупы: клиент видит только инструменты разрешённых скоупов. Например, для отчётов и дашбордов нужны stats:reports и stats:reports:write, для Meta / TikTok — ads:read.

  • Скоуп добавлен позже: у API-ключа включите его в редактировании скоупов (Настройки профиля → MCP Keys), а OAuth-приложение (ChatGPT, Claude) подключите заново.


Ошибка 401 или invalid_token

Токен неверный, отозван или истёк.

  • API-ключ (Claude Code, Cursor): перевыпустите ключ в Настройки профиля → MCP Keys и замените токен в клиенте. Проверьте, что токен скопирован без пробелов.

  • OAuth (ChatGPT, Claude): отключите приложение и подключите заново.


Ошибка 403 missing required scope

У ключа или OAuth-подключения нет скоупа, который нужен инструменту. Включите скоуп и повторите запрос.


Почему один и тот же запрос иногда не срабатывает?

Клиент мог потерять сессию с инструментами, или запрос оказался слишком тяжёлым и не уложился в ожидание клиента. Повторите запрос, при необходимости — в новом чате, и сузьте его: короче период, меньше группировок, только top-N строк.


Как работать с большими выборками?

  • query_stats возвращает максимум 1000 строк за запрос.

  • Для больших выборок используйте export_csv (мягкий лимит 100 000 строк) или дробите запрос по периоду и группировкам.


Почему ответы пустые?

MCP отдаёт только данные, доступные вашей роли в кабинете. Проверьте, что нужные команда, кампании и период доступны вашему аккаунту и что за этот период есть данные.


Почему модель иногда называет неверные цифры?

Если инструмент вернул ошибку или не был вызван, модель может ответить по старому контексту. Для важных цифр попросите явно взять данные из Adset.Pro, укажите период и сверьте результат со статистикой в кабинете.


Как формулировать запросы

Конкретно: период, команда, GEO или кампания, нужные метрики.

Хорошие примеры

  • «Покажи топ GEO за сегодня»

  • «Сравни installs вчера и сегодня»

  • «Проанализируй просадку revenue за 7 дней»

  • «Какие кампании упали по CR?»

Плохие примеры

  • «Что происходит?»

  • «Проанализируй всё»

  • «Почему плохо льётся?»


Что делать, если подключение перестало работать

  1. Повторите запрос в новом чате.

  2. Проверьте соединение из терминала: curl -i https://app.adset.pro/mcp -H "Authorization: Bearer mcp_ВАШ_ТОКЕН". Ответ 401 значит, что токен недействителен.

  3. Переподключите приложение (OAuth) или перевыпустите API-ключ.

  4. Если не помогло — напишите в поддержку в Telegram: @roman_adsetpro.