MCP для VK Рекламы

Как подключить рекламный кабинет к ИИ-агенту: выбрать способ доступа, собрать адрес, добавить его в агентную среду и проверить доступ чтением.

Задача

Агент должен работать в вашем кабинете VK Рекламы: видеть настоящие кампании, снимать статистику, собирать аудитории и заводить группы объявлений — а не описывать, как это сделать руками. Связь между агентом и кабинетом даёт MCP: так называется подключение агента к рекламной системе. Эта статья доводит до момента, когда агент по просьбе показывает ваши кабинеты и кампании с их статусами.

Что понадобится

• Агентная среда — программа, в которой работает агент. Она должна поддерживать подключение MCP по адресу.
• Кабинет VK Рекламы — заведённый в click.ru (создать кабинет, доступ к нему из интерфейса VK Рекламы) либо кабинет с прямым доступом в самой VK Рекламе.
• Ключ доступа. Какой именно, зависит от способа: для кабинета в click.ru — API-токен из профиля click.ru, готовить заранее не нужно; для кабинета с прямым доступом — ключи приложения из настроек VK Рекламы.

Устанавливать на компьютер ничего не требуется: в агентную среду добавляется только адрес, сам сервер подключения работает на стороне click.ru.

Какой адрес выбрать

Способа доступа три; у первого две записи — без кабинета и с кабинетом. От ключа в адресе зависит, надолго ли адрес живёт, к скольким кабинетам дотянется агент и как быстро закроется доступ при отзыве.

https://vkads-mcp.aihub.click.ru/c/<токен click.ru>
https://vkads-mcp.aihub.click.ru/c/<токен click.ru>/<кабинет>
https://vkads-mcp.aihub.click.ru/o/<client_id>/<client_secret>
https://vkads-mcp.aihub.click.ru/t/<токен VK Рекламы>

Через click.ru — /c/<токен> и /c/<токен>/<кабинет>. Основной способ для кабинетов, заведённых в click.ru: свои ключи VK Рекламы не нужны, доступ к кабинету сервер запрашивает у click.ru и продлевает, когда срок истекает. Адрес без кабинета открывает все кабинеты VK Рекламы, доступные токену: если кабинет один, агент работает в нём; если их несколько, агент перечислит их и спросит, в каком работать. Дальше кабинет меняется репликой — «перейди в кабинет такой-то» — и агент подставляет его в каждый вызов. Форма с кабинетом закрепляет один кабинет как рабочий по умолчанию; кабинет задаётся так, как он показан в списке аккаунтов click.ru, — логином вида a1b2c3d4e5@agency_client, названием или ID.

По ключам приложения — /o/<client_id>/<client_secret>. Для кабинета, который ведётся напрямую в VK Рекламе, минуя click.ru. Секрет приложения открывает аккаунт VK Рекламы целиком, у агентства — все клиентские кабинеты, кампании и финансовые документы, поэтому клиенту такой адрес не передают: для клиентского кабинета есть путь через click.ru. Зато адрес живёт, пока ключи не отозваны: по ним сервер выпускает и продлевает токен доступа без вашего участия.

По готовому токену — /t/<токен VK Рекламы>. Временный вариант: токен, выданный кабинетом VK Рекламы, живёт 24 часа, после чего адрес перестаёт отвечать и его нужно собирать заново. Подходит для разовой проверки; для постоянной работы берите одну из форм выше.

Хвост /mcp в конце адреса допускается в любой форме — если среда подставляет его сама, исправлять ничего не нужно. Если в ключе есть символы /, ?, # или %, в адресе их записывают кодом: / как %2F, ? как %3F, # как %23, % как %25. Логин кабинета кодировать не нужно.

Адрес подключения равносилен паролю. Ключ зашит прямо в строку, поэтому любой, у кого есть адрес, подключится к кабинету без пароля и подтверждений. Адрес не пересылают в переписке и не публикуют. Если он всё-таки ушёл — замените ключ там, где он выдан: токен click.ru пересоздайте в профиле click.ru (новый заменит прежний, и остальные подключения на нём придётся собрать заново), ключи приложения перевыпустите в настройках VK Рекламы. Доступ закрывается не сразу: уже выданный токен VK Рекламы действует до 24 часов, и всё это время старый адрес продолжает работать. По ключам приложения сначала попросите агента отозвать токены — в подключении есть инструмент отзыва, — и только потом меняйте секрет: с отозванным секретом инструмент не сработает.

Что безопаснее. Для кабинетов в click.ru — форма с кабинетом: агент по умолчанию работает в нём и не ошибётся кабинетом по невнимательности. Это не запрет — вызов можно направить в любой кабинет, доступный тому же токену; из мастер-аккаунта адрес без кабинета открывает кабинеты всех его пользователей. Нужен именно запрет: выпускайте токен в том аккаунте click.ru, где чужих кабинетов нет. Для клиентских кабинетов — путь через click.ru вместо секрета приложения: токен click.ru открывает рекламные кабинеты аккаунта и его API, секрет — весь аккаунт VK Рекламы с финансами.

Шаги

Шаг 1. Получите ключ доступа

Кабинет в click.ru. Откройте профиль того аккаунта click.ru, где виден кабинет VK Рекламы, и найдите поле «API Token»: токен из другого аккаунта выглядит рабочим, но кабинета не откроет. Если в поле уже есть токен, используйте его: токен один на все подключения через click.ru из этого аккаунта — к Директу, Вордстату и VK Рекламе. Новый токен заменяет прежний, и все подключения на старом перестают работать, их приходится собирать заново. Поэтому «пересоздать» нажимают только при утечке. Если поле пустое, нажмите «Создать».

Результат: в поле «API Token» есть строка — её можно скопировать.

Кабинет с прямым доступом. В кабинете VK Рекламы откройте настройки, раздел «Доступ к API», и запросите доступ. client_id виден в настройках всегда, client_secret доступен для копирования 10 минут — сохраните его сразу в надёжное место.

Результат: у вас сохранены оба значения.

Шаг 2. Найдите логин кабинета

Шаг нужен, только если вы закрепите в адресе один кабинет из нескольких в click.ru. В том же аккаунте click.ru откройте список рекламных аккаунтов: логин кабинета VK Рекламы виден в его строке. Название кабинета тоже подходит, но логин надёжнее — в нём нет пробелов и кириллицы.

Результат: логин кабинета скопирован.

Шаг 3. Соберите адрес подключения

Возьмите форму из раздела «Какой адрес выбрать» и подставьте свои значения вместо <…>, угловые скобки уберите. Для кабинета в click.ru базовая форма выглядит так:

https://vkads-mcp.aihub.click.ru/c/<токен click.ru>

Результат: адрес собран одной строкой, без пробелов и переносов.

Шаг 4. Добавьте подключение в агентную среду

Добавьте собранный адрес в среду как MCP. Где именно это делается, зависит от среды.

Результат: подключение появилось в списке подключений среды, у него виден набор инструментов VK Рекламы.

ClaudeCodex

В приложении Claude: Настройки → Connectors → Add custom connector. Имя любое, в поле адреса вставьте собранный адрес и нажмите Continue, затем Add. Способ аутентификации оставьте тем, который приложение определит само.

В приложении ChatGPT откройте Codex, затем настройки → Плагины → Добавить → Добавить сервер MCP. Тип — «Потоковая передача HTTP», имя любое, в поле URL вставьте собранный адрес, остальные поля оставьте пустыми и нажмите «Сохранить».

Шаг 5. Перезапустите агентную среду, если инструменты не появились

Закройте среду и откройте заново. В части сред новое подключение появляется в списке инструментов только после перезапуска.

Результат: подключение отмечено как доступное, инструменты VK Рекламы видны.

Как убедиться, что получилось

Первые команды берите на чтение: они ничего не меняют в кабинете и не тратят бюджет.

• Проверь доступ к VK Рекламе и покажи мои кабинеты. — агент назовёт кабинеты, доступные ключу. Если при адресе без кабинета их несколько, агент сообщит, что нужно выбрать, и перечислит их — это не ошибка.
• Покажи мои кампании в VK Рекламе и их статусы. — придёт список кампаний с названиями и статусами. Сверьте две-три строки с кабинетом.
• Собери статистику по группам объявлений за последнюю неделю. — придут показы, клики и расход по дням или итогом.

Ответ пришёл и сошёлся с кабинетом — подключение работает.

Что агент умеет через это подключение

• Создавать кампании — кампанию, группы объявлений и объявления в них: бюджеты, сроки, таргетинги, форматы под цель. Объявления заводятся вместе с группой; в уже созданную группу объявление не добавить — группу пересоздают. Готовые объявления агент правит и отправляет на повторную модерацию.
• Загружать креативы — изображения и видео по публичной ссылке, с привязкой к объявлениям.
• Собирать аудитории — сегменты ремаркетинга, пиксели и списки контактов.
• Снимать статистику — показы, клики, расход и результаты по группам объявлений, объявлениям и кабинету целиком, по дням и итогом за период. По кампании верхнего уровня агент складывает цифры из её групп.

Чего подключение не делает

• Само ничего не начинает. Инструмент срабатывает, только когда агент его вызвал, а агента ведёт специалист.
• Не ставит паузу за вас. Кампания и группа создаются с тем статусом, который агент передал в вызове, а включить показы агент может отдельной командой — поэтому просите его создавать всё остановленным и запускать только по вашему слову. Скилл «Таргетолог» — папка с инструкциями для агента — делает это сам. Включает показы человек: в кабинете или отдельной командой агенту.
• Встроенного подтверждения у MCP нет. Вызов на изменение уходит в кабинет сразу: подключение не переспрашивает. Паузу перед изменением держат двое: агентная среда, если в ней включён запрос разрешения на вызов инструмента (проверьте эту настройку в своей), и сам специалист — попросите агента показывать запрос до отправки.
• Удалённое возвращается не всегда. Кампании, группы и объявления после удаления попадают в архив кабинета, откуда их можно восстановить. Сегменты, пиксели и списки контактов удаляются безвозвратно на стороне VK Рекламы: такие команды давайте осознанно.
• Не даёт больше, чем отдаёт API VK Рекламы:
  • лид-формы заводятся только в кабинете;
  • статистика приходит без разбивок по полу, возрасту, регионам и устройствам;
  • похожие аудитории через API не создаются — их собирают в кабинете; через подключение доступны сегменты, пиксели и списки;
  • список уже загруженных картинок API не показывает.
• Не берёт файлы с вашего компьютера. Сервер работает на стороне click.ru: картинка и видео нужны по публичной ссылке. Для изображений скилл «Таргетолог» решает это временным хранилищем — подробнее в статье о скилле.

Работа без скилла

Подключение открывает агенту кабинет и объясняет, какие параметры есть у каждого инструмента. Что именно делать в кабинете, оно не подсказывает. Готовый маршрут даёт скилл «Таргетолог»: он ведёт от брифа до кампании, создаёт всё остановленным, показывает план до каждого изменения и ничего не удаляет. Вести агента можно и своими инструкциями. А для точечных задач — снять статистику, загрузить креативы, собрать сегмент, проверить статусы — хватает одного подключения.

Если не получилось

Агент не видит инструменты VK Рекламы. Сломана структура адреса: в секрете не закодирован /, пропущен или добавлен лишний сегмент. Сверьте адрес с формой из раздела «Какой адрес выбрать», исправьте и перезапустите агентную среду.

Ошибка доступа. Ключ скопирован не полностью, остались угловые скобки, токен click.ru пересоздан после сборки адреса или ключи приложения перевыпущены в VK Рекламе. Сверьте ключ с действующим и пересоберите адрес; пересозданный токен click.ru требует пересобрать и остальные подключения на нём.

Агент отвечает, что у токена нет ни одного кабинета. Токен верный, но в этом аккаунте click.ru кабинета VK Рекламы нет. Выпустите токен в аккаунте, где кабинет виден, или создайте кабинет.

Агент говорит, что кабинет не найден, и перечисляет доступные. В адресе закреплён кабинет, которого у токена нет, или логин записан с ошибкой. Возьмите логин из списка, который прислал агент, и пересоберите адрес. Если рядом с кабинетом стоит пометка, что он не заведён на стороне VK Рекламы, — завершите его создание в click.ru по той же статье.

Подключение работало и перестало отвечать через сутки. В адресе стоит готовый токен VK Рекламы, а он живёт 24 часа. Выпустите новый или перейдите на долгоживущую форму — через click.ru или по ключам приложения.

Слишком много активных токенов. VK Реклама разрешает не больше 5 активных токенов на приложение и пользователя; подключение по ключам приложения в норме занимает одно место, остальные могут выбрать другие интеграции на тех же ключах. Попросите агента отозвать токены приложения: инструмент отзывает все активные токены этого приложения, после чего подключение выпустит себе новый, а другие интеграции придётся переподключить.

Группа объявлений не видна в кабинете. Скорее всего, она создана без привязки к кампании: группа без кампании в кабинете не показывается. Попросите агента пересобрать структуру: кампания, внутри неё группы.

Агент работает не в том кабинете. Так бывает при адресе через click.ru без кабинета, когда токену доступно несколько. Назовите нужный кабинет репликой — «перейди в кабинет такой-то» — или закрепите его в адресе формой /c/<токен>/<кабинет>.

Ничего из этого не помогло. Опишите ситуацию в Telegram-сообществе. Приложите текст ошибки и адрес подключения без ключа: адрес целиком равносилен паролю.

Частые вопросы

Нужно ли уметь программировать?

Нет. Подключение — это адрес в настройках агентной среды, дальше работа идёт обычными словами в диалоге. Какой инструмент вызвать и с какими параметрами, агент подбирает сам; от специалиста нужны рекламные решения. Начните с команд на чтение из раздела «Как убедиться, что получилось».

Нужен ли аккаунт click.ru?

Необязательно. Кабинет с прямым доступом подключается ключами приложения из самой VK Рекламы. А вот агентский кабинет, созданный через click.ru, прямого входа по логину и паролю не имеет — для него путь один, через click.ru, и одного токена из профиля хватает на все такие кабинеты сразу.

Придётся ли давать агенту пароль от VK?

Нет. Через click.ru доступ идёт по API-токену click.ru, по прямому доступу — по ключам приложения или токену кабинета. Пароль от аккаунта не участвует ни в одной форме адреса. Закрыть агенту доступ можно без смены пароля: ключ перевыпускается там, где выдан, но уже выданный токен действует до суток — см. «Адрес подключения равносилен паролю».

Может ли агент что-то испортить в кабинете?

Может, если ему это разрешить: изменения уходят в кабинет сразу, и статус созданной кампании задаёт агент. Две привычки закрывают риск: просить запрос до отправки и создавать всё остановленным. Что восстанавливается, а что нет, — в разделе «Чего подключение не делает».