Adset.ProAdset.ProKnowledge base
To app
Home/Интеграции/MCP-сервис Adset

MCP-сервис Adset

Платформа Adset.Pro предоставляет публичный MCP-сервис (Model Context Protocol), через который языковые модели (ChatGPT, Claude и совместимые клиенты) работают с вашим кабинетом Adset.Pro: запрашивают статистику, собирают отчёты и дашборды, читают кампании, потоки, офферы, PWA, push, автоправила, раздел Meta / TikTok и биллинг.

Набор инструментов (tools), который увидит клиент, зависит от скоупов ключа или OAuth-подключения:

Скоуп

Что разрешает

stats:query, stats:meta, stats:export

Статистика (query_stats), список метрик, группировок и фильтров (get_metadata), выгрузка в CSV (export_csv)

stats:reports, stats:reports:write

Пресеты отчётов и кастомные дашборды: чтение и создание/изменение. Удалять отчёты и дашборды через MCP нельзя

entities:read, entities:read:full, entities:resolve

Чтение объектов кабинета (кампании, потоки, офферы, партнёрские сети, лендинги, PWA, пиксели, домены, источники и др.) и поиск их по названию или id

entities:create:campaign, entities:create:flow, entities:create:offer, entities:create:cpa, entities:create:pixel, entities:create:pwa, entities:create:source, entities:update:campaign

Создание объектов соответствующего типа и изменение кампаний

pushes:read, pushes:read:full

Чтение push-уведомлений и push-групп

autorules:read, autorules:write

Автоправила: чтение и изменение

ads:read

Раздел Meta / TikTok: профили, рекламные кабинеты, кампании, адсеты, объявления и их статистика. Только чтение; по умолчанию выключен

billing:read

Транзакции биллинга

knowledge:read

Поиск и чтение статей базы знаний

Базовый URL MCP-сервера: https://app.adset.pro/mcp

Поддерживаются два способа аутентификации:

  • OAuth 2.0 (PKCE) — для ChatGPT, Claude (коннекторы) и других клиентов, которые сами проводят пользователя через экран согласия. Токены вручную копировать не нужно.

  • Личный API-ключ (mcp_…) — для Claude Code, Cursor и любых клиентов с фиксированным Bearer-токеном.

Ниже — пошаговые инструкции для обоих сценариев.


Подключение к ChatGPT (OAuth)

ChatGPT устанавливает соединение с MCP-сервером самостоятельно через OAuth 2.0 с PKCE. Никаких токенов вручную копировать не нужно — пользователь авторизуется в Adset.Pro через стандартный экран согласия.

Шаг 1. Включите режим разработчика

Этот шаг обязателен — без режима разработчика пункт «Добавить приложение» в настройках ChatGPT не появляется.

  1. Откройте ChatGPT → Настройки (Settings).

  2. Перейдите в раздел Приложения (Apps & Connectors).

  3. Откройте Дополнительные настройки (Advanced settings).

  4. Включите переключатель Режим разработчика (Developer mode).

Шаг 2. Добавьте приложение Adset.Pro

  1. Вернитесь в Настройки → Приложения.

  2. Нажмите Добавить приложение (Add app / Create).

  3. Заполните поля:

    • Name: Adset.Pro

    • Description: Adset.Pro connector

    • MCP server URL: https://app.adset.pro/mcp

    • Authentication: OAuth

  4. Нажмите Connect / Add.

Шаг 3. Авторизация и согласие

ChatGPT откроет popup-окно с экраном https://app.adset.pro/oauth/authorize:

  1. Если вы ещё не вошли — войдите в свой аккаунт Adset.Pro.

  2. На экране согласия вы увидите имя вашего аккаунта и список запрашиваемых скоупов (что они разрешают — в таблице выше).

  3. Нажмите Approve / Разрешить.

После одобрения окно закроется автоматически. Приложение в настройках ChatGPT перейдёт в статус Connected.

Шаг 4. Использование

Откройте новый чат и попросите ChatGPT воспользоваться инструментом, например:

«Покажи статистику по кампаниям за последние 7 дней через Adset.Pro — клики, расход, ROI».

ChatGPT автоматически вызовет query_stats с правильными параметрами и отрисует таблицу.

Отзыв доступа

Чтобы отозвать токен у ChatGPT:

  • В ChatGPT: Настройки → Приложения → Adset.Pro → Disconnect.

  • На стороне Adset.Pro: Настройки профиля → MCP Keys — выданный OAuth-клиент будет отображаться в списке (раздел OAuth clients появляется только если у вас есть такие подключения).


Подключение к Claude

Claude (веб, Desktop и мобильное приложение) подключается как коннектор через OAuth — токен не нужен:

  1. В Claude откройте Settings → Connectors и нажмите Add custom connector.

  2. Укажите название, например Adset.Pro, и URL https://app.adset.pro/mcp.

  3. Нажмите Connect и подтвердите доступ на экране согласия Adset.Pro (как в шаге 3 для ChatGPT).

Claude Code (CLI) подключается по личному API-ключу (как его выпустить — в следующем разделе):

claude mcp add --transport http adset https://app.adset.pro/mcp \
  --header "Authorization: Bearer mcp_ВАШ_ТОКЕН_ЗДЕСЬ"

Проверка:

claude mcp list

В списке должна появиться запись adset со статусом connected.


Личный API-ключ (Claude Code, Cursor и другие клиенты с Bearer-токеном)

Этот токен вы выпускаете самостоятельно в настройках профиля Adset.Pro. Полный токен показывается только один раз — сразу после создания. Сохраните его в надёжном месте (менеджер паролей). Восстановить его нельзя — только перевыпустить (rotate).

Шаг 1. Выпуск API-ключа в Adset.Pro

  1. Войдите в кабинет Adset.Pro: https://app.adset.pro.

  2. В правом верхнем углу нажмите на аватар → Настройки (Settings).

  3. Откройте вкладку Ключи MCP.

  4. Нажмите кнопку Создать API ключ.

  5. Заполните форму:

    • Name — произвольное имя ключа, например Claude Code.

    • Scopes — отметьте нужные. Для статистики достаточно Query Stats, Get Metadata и Export CSV; для отчётов и дашбордов, объектов кабинета, Meta / TikTok (Read Ads) и других разделов включите соответствующие скоупы (таблица выше).

    • Expires in — срок действия в днях. Оставьте пустым для бессрочного ключа.

  6. Нажмите Create.

  7. Появится диалог с одноразовым показом токена в формате:

    mcp_a1b2c3d4e5f6...

    Скопируйте его кнопкой Copy и закройте диалог.

Шаг 2. Подключение в Cursor

  1. Cursor → Settings → MCP → Add new MCP server.

  2. Введите:

    • Name: adset

    • Type: http

    • URL: https://app.adset.pro/mcp

    • Headers:

      • Key: Authorization

      • Value: Bearer mcp_ВАШ_ТОКЕН_ЗДЕСЬ

  3. Сохраните и перезапустите Cursor.

Шаг 3. Проверка соединения через curl

Если что-то не работает, быстрая проверка из терминала:

curl -i https://app.adset.pro/mcp \
  -H "Authorization: Bearer mcp_ВАШ_ТОКЕН"

Ожидаемый ответ — 200 OK или 400 Bad Request (без тела MCP-запроса). Ответ 401 Unauthorized означает, что токен неверный, отозванный или просроченный.

Управление ключами

В разделе Настройки профиля → MCP Keys доступны:

  • Создание новых ключей (Create API Key).

  • Редактирование скоупов — у выпущенного ключа можно включить новые скоупы, например для отчётов и Meta / TikTok.

  • Перевыпуск (rotate, иконка ↻) — старый токен сразу отзывается, выдаётся новый.

  • Отзыв (Delete, иконка корзины) — токен немедленно перестаёт работать.

  • Просмотр имени, префикса, скоупов, статуса, времени последнего использования и срока истечения.


Скоупы и ограничения

Что разрешает каждый скоуп — в таблице в начале статьи. Скоуп ads:read у MCP-ключей и OAuth-приложений по умолчанию выключен. OAuth-коннектор, подключённый до появления нужного скоупа, для него нужно подключить заново.

Любой запрос автоматически применяет фильтры безопасности по teamId и роли пользователя — клиент получает только те данные, к которым у него есть доступ в кабинете, и может выполнять только действия, разрешённые его роли.

Лимиты:

  • query_stats.limit — максимум 1000 строк за запрос; для больших выборок используйте export_csv.

  • export_csv — мягкий лимит 100 000 строк (можно расширить под отдельные тарифы).


Частые ошибки

Симптом

Причина и решение

401 invalid_token в Claude Code/Cursor

Токен отозван, истёк или скопирован с пробелом. Перевыпустите ключ.

ChatGPT или Claude: «connection error» после Approve

Истёк authorization code (>10 мин), либо клиент сменил redirect_uri. Повторите подключение.

ChatGPT не видит инструменты

Не включён режим разработчика, либо приложение не подтверждено в OAuth-окне.

403 missing required scope или нет нужных инструментов (отчёты, дашборды, Meta / TikTok)

У ключа не включён нужный скоуп. Включите его в редактировании скоупов ключа; OAuth-коннектор, подключённый раньше, подключите заново.

Пустые таблицы в ответах

Учётка не имеет доступа к запрашиваемой команде/teamId — проверьте права в кабинете.

Подробнее о диагностике — в статье FAQ — подключение MCP.


Полезные ссылки