MCP-сервис Adset
Платформа Adset.Pro предоставляет публичный MCP-сервис (Model Context Protocol), через который языковые модели (ChatGPT, Claude и совместимые клиенты) работают с вашим кабинетом Adset.Pro: запрашивают статистику, собирают отчёты и дашборды, читают кампании, потоки, офферы, PWA, push, автоправила, раздел Meta / TikTok и биллинг.
Набор инструментов (tools), который увидит клиент, зависит от скоупов ключа или OAuth-подключения:
Скоуп | Что разрешает |
|---|---|
| Статистика ( |
| Пресеты отчётов и кастомные дашборды: чтение и создание/изменение. Удалять отчёты и дашборды через MCP нельзя |
| Чтение объектов кабинета (кампании, потоки, офферы, партнёрские сети, лендинги, PWA, пиксели, домены, источники и др.) и поиск их по названию или id |
| Создание объектов соответствующего типа и изменение кампаний |
| Чтение push-уведомлений и push-групп |
| Автоправила: чтение и изменение |
| Раздел Meta / TikTok: профили, рекламные кабинеты, кампании, адсеты, объявления и их статистика. Только чтение; по умолчанию выключен |
| Транзакции биллинга |
| Поиск и чтение статей базы знаний |
Базовый 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 не появляется.
Откройте ChatGPT → Настройки (Settings).

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

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

Включите переключатель Режим разработчика (Developer mode).
Шаг 2. Добавьте приложение Adset.Pro
Вернитесь в Настройки → Приложения.
Нажмите Добавить приложение (Add app / Create).

Заполните поля:
Name:
Adset.ProDescription:
Adset.Pro connectorMCP server URL:
https://app.adset.pro/mcpAuthentication:
OAuth
Нажмите Connect / Add.
Шаг 3. Авторизация и согласие
ChatGPT откроет popup-окно с экраном https://app.adset.pro/oauth/authorize:
Если вы ещё не вошли — войдите в свой аккаунт Adset.Pro.
На экране согласия вы увидите имя вашего аккаунта и список запрашиваемых скоупов (что они разрешают — в таблице выше).
Нажмите 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 — токен не нужен:
В Claude откройте Settings → Connectors и нажмите Add custom connector.
Укажите название, например
Adset.Pro, и URLhttps://app.adset.pro/mcp.Нажмите 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
Войдите в кабинет Adset.Pro: https://app.adset.pro.
В правом верхнем углу нажмите на аватар → Настройки (Settings).

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

Нажмите кнопку Создать API ключ.
Заполните форму:
Name — произвольное имя ключа, например
Claude Code.Scopes — отметьте нужные. Для статистики достаточно
Query Stats,Get MetadataиExport CSV; для отчётов и дашбордов, объектов кабинета, Meta / TikTok (Read Ads) и других разделов включите соответствующие скоупы (таблица выше).Expires in — срок действия в днях. Оставьте пустым для бессрочного ключа.
Нажмите Create.

Появится диалог с одноразовым показом токена в формате:
mcp_a1b2c3d4e5f6...Скопируйте его кнопкой Copy и закройте диалог.
Шаг 2. Подключение в Cursor
Cursor → Settings → MCP → Add new MCP server.
Введите:
Name:
adsetType:
httpURL:
https://app.adset.pro/mcpHeaders:
Key:
AuthorizationValue:
Bearer mcp_ВАШ_ТОКЕН_ЗДЕСЬ
Сохраните и перезапустите 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 строк (можно расширить под отдельные тарифы).
Частые ошибки
Симптом | Причина и решение |
|---|---|
| Токен отозван, истёк или скопирован с пробелом. Перевыпустите ключ. |
ChatGPT или Claude: «connection error» после Approve | Истёк authorization code (>10 мин), либо клиент сменил |
ChatGPT не видит инструменты | Не включён режим разработчика, либо приложение не подтверждено в OAuth-окне. |
| У ключа не включён нужный скоуп. Включите его в редактировании скоупов ключа; OAuth-коннектор, подключённый раньше, подключите заново. |
Пустые таблицы в ответах | Учётка не имеет доступа к запрашиваемой команде/teamId — проверьте права в кабинете. |
Подробнее о диагностике — в статье FAQ — подключение MCP.
Полезные ссылки
Публичная OpenAPI-спецификация: https://app.adset.pro/openapi.json
OAuth Authorization Server Metadata: https://app.adset.pro/.well-known/oauth-authorization-server
OAuth Protected Resource Metadata: https://app.adset.pro/.well-known/oauth-protected-resource
