VK Реклама для MCP для приложения «MCP»

VK Реклама в руках ИИ-агента: от статистики до запуска кампании

Плагин к приложению MCP открывает кабинет VK Рекламы (ads.vk.com) для ИИ-агентов по протоколу Model Context Protocol. Claude, Cursor или свой скрипт подключаются к сайту и отвечают на вопросы о рекламе сами: что сколько стоило, какие объявления тянут бюджет впустую, где кончаются деньги, — а по вашей команде собирают новую кампанию. Тридцать два инструмента в девяти группах прав; всё, что меняет кабинет, — только с вашего подтверждения.

Структура кабинета

Кампании, группы объявлений и сами объявления — со статусом, бюджетами, ставками, стратегией и причинами отклонения на модерации. Агент видит кабинет так же, как вы в интерфейсе, и не путает уровни.

Статистика, цели, расход сегодня

Показы, клики, расход и посчитанные CTR, CPC, CPM и CPA — по кампаниям, группам или объявлениям за любой период; конверсии по каждой цели пикселя; расход за сегодня почти в реальном времени. Длинные периоды плагин сам режет на запросы, которые примет API.

Аудитории, пиксели, лиды

Пиксели и их цели, сегменты ретаргетинга, списки и сообщества, лид-формы и заявки из них, уведомления кабинета — всё, с чего начинается разбор «почему не крутится».

Лучшие и худшие

Топ объектов по расходу, кликам, CTR, CPC или цене цели. Объявления с тремя показами в топ по CTR не попадают: порог отсекает случайные цифры, которые иначе выглядели бы находкой.

Запуск, бюджет, ставка

Остановить или запустить кампанию, группу или объявление, поменять бюджет и ставку. Каждое изменение — сначала предпросмотр «было → станет», и только после подтверждения отправка.

Создание и правка

Агент подбирает пакет размещения, загружает картинки, собирает кампанию с таргетингом по регионам, возрасту, полу и интересам и пишет объявление. Всё создаётся остановленным — запуск только по вашей команде.

Второй рекламный канал рядом с Директом

Если у вас стоит наш плагин Яндекс.Директ для MCP, агент сводит оба кабинета в один ответ: расход, клики и цена заявки за одинаковый период в Директе и в VK. Вопрос «где заявка дешевле и куда перекинуть бюджет» перестаёт быть ручной сверкой двух выгрузок.

Вместе с инструментами плагин отдаёт агенту страницу документации: как устроен кабинет VK, почему CTR нельзя складывать между днями и почему показы двух систем сравнивать «в лоб» нельзя, а цену клика и цели — можно.

Ничего не меняется без вас

Все пишущие инструменты работают в два шага. Без явного подтверждения агент получает только предпросмотр: текущее значение, новое и что произойдёт. Отправка — отдельным вызовом, после которого плагин перечитывает объект и показывает, что получилось на самом деле, а не что было запрошено.

От опечаток — ещё два барьера:

• бюджет или ставку нельзя за один вызов изменить больше чем на 50 % (порог задаётся в настройках) — лишний ноль или «0» вместо «10000» остановятся, пока человек не подтвердит сумму отдельно;
• сумма бюджета должна быть кратна шагу, который требует VK, — плагин проверит и предложит ближайшие допустимые значения до отправки.

Создаётся всё остановленным: деньги начинают тратиться только после отдельной команды «запускай». Удаление необратимо, поэтому оно вынесено в отдельное право и требует, кроме подтверждения, контрольной фразы «удалить N» — случайно его не вызвать.

Токены обновляются сами

Токен доступа VK Рекламы живёт сутки. Плагин получает его сам по client_id и client_secret, хранит в настройках и вовремя обновляет — вам не нужно ничего перевыпускать руками. Обновление защищено от параллельных запросов: два одновременных вопроса агента не «сожгут» токен друг другу.

У VK есть лимит — не больше пяти действующих токенов на одно приложение. Если он исчерпан, плагин отзывает токены этого приложения и получает новый. Поэтому заведите под плагин отдельное приложение API, если тем же client_id уже пользуется другая интеграция.

Вы решаете, что агенту можно

Права разделены на девять групп: «Кабинет и статистика», «Аудитории и пиксели», «Справочники», «Данные маркировки (ОРД)», «Запуск и остановка показов», «Бюджеты и ставки», «Создание кампаний и объявлений», «Правка кампаний и объявлений», «Удаление». Выдавая токен в приложении MCP, вы отмечаете нужные — и агент физически не видит остальных инструментов. Можно выдать только чтение; заявки из лид-форм содержат персональные данные — это право стоит выдавать осознанно.

Что нужно для работы

• приложение MCP версии 1.3.0 или новее — оно держит сервер и токены
• кабинет VK Рекламы (ads.vk.com) с доступом к API — как его получить, ниже
• исходящий HTTPS к ads.vk.com — ни Node, ни cron, ни своих таблиц в базе плагин не требует
• MCP-клиент: Claude Desktop, Cursor, любой другой или собственный скрипт

Как получить доступ к API VK Рекламы

1. Проверьте, что реквизиты в кабинете прошли модерацию: у юрлиц и агентств — раздел «Бюджет», у физлиц — «Настройки».
2. В кабинете ads.vk.com откройте Настройки → Доступ к API и нажмите «Запросить доступ к API». Укажите ФИО и контакты ответственного сотрудника.
3. После одобрения там же появятся client_id и кнопка получения client_secret. Секрет показывается только 10 минут — сразу скопируйте его.
4. Вставьте оба значения в настройки плагина. Агентствам — ещё логин клиента, с кабинетом которого работать.
5. Попросите агента «покажи аккаунт VK Рекламы» — это и есть проверка подключения.

Чтобы агент мог создавать объявления, в данных маркировки рекламы (ОРД) кабинета должно быть указано название рекламодателя — ФИО или название организации. Частая ловушка: профиль «VK для бизнеса» подтверждён, поля в интерфейсе заблокированы, а название для маркировки всё равно пустое, и VK отказывает. Плагин показывает, чего не хватает, и может записать название с вашего подтверждения.

Вопросы по доступу к API VK решает их поддержка: ads_api@vk.team.

Мы в социальных сетях

Узнавайте первыми о наших новых решениях и акциях.

• Вконтакте - https://vk.com/easyweb_su
• Телеграм - https://t.me/easyweb_su