Обзор
Обновлено
Что делает плагин
«VK Реклама для MCP» подключает кабинет ads.vk.com к приложению MCP в Webasyst. ИИ-агент получает инструменты, с помощью которых читает данные рекламы и выполняет разрешённые изменения через API VK.
Владельцу сайта или магазина плагин помогает получать сводки о расходах, кликах и конверсиях и готовить изменения рекламы. Разработчик настраивает подключение и доступ MCP-клиента: например, Claude Desktop, Cursor или собственного клиента протокола MCP.
Основные возможности
- Подключённый кабинет, баланс, валюта, уведомления и лимиты API.
- Кампании, группы объявлений, объявления, их статусы и сведения о модерации.
- Статистика за период и по дням, конверсии по целям пикселя, расход сегодня и рейтинги объектов.
- Пиксели и цели, аудитории, лид-формы и заявки, клиенты агентства.
- Справочники регионов, интересов и пакетов размещения.
- Чтение и изменение названия рекламодателя, сайта и телефона в данных маркировки.
- Создание остановленных кампаний, групп и объявлений, загрузка картинок.
- Правка, запуск и остановка, изменение бюджетов и ставок, удаление объектов.
В плагине 32 инструмента и девять групп прав. Настройки общие для подключения: клиент агентства выбирается в настройках плагина, отдельного переключателя кабинета в каждом запросе нет.
Как устроены изменения
Инструменты создания рекламных объектов, правки, запуска, остановки, бюджетов, ставок и записи данных маркировки требуют confirm=true. Без этого при корректных параметрах возвращается предпросмотр preview. Удаление дополнительно требует контрольную фразу.
Изображения загружаются без confirm. Подготовка ссылки для объявления также может обращаться в VK до подтверждения. Подробности — в статье «Изменения кабинета».
Плагин проверяет параметр подтверждения в запросе. Показывать предпросмотр человеку и получать его согласие должен агент: отдельного диалога подтверждения внутри плагина нет.
Совместимость и требования
| Требование | Что необходимо |
|---|---|
| Приложение MCP | Версия 1.3.0 или новее; обязательная зависимость |
| Расширения PHP | mbstring, json, curl, filter |
| Кабинет VK Рекламы | Доступ к API, ID и секрет клиента API |
| Сеть сервера | Исходящие HTTPS-запросы к ads.vk.com |
| Клиент агента | Подключение к серверу приложения MCP и разрешения на нужные инструменты |
Отдельная минимальная версия PHP для плагина не установлена. Учитывайте требования установленного приложения MCP и Webasyst.
Плагину не нужны собственные задания cron, CLI-команды или Node.js. Он работает по запросам MCP-клиента. Поддержка конкретной темы оформления и установка Shop-Script не являются зависимостями плагина. Вывод на витрине и Smarty-хелперы не предусмотрены.
Редакции
Плагин доступен в одной редакции со всеми описанными возможностями. Набор доступных агенту инструментов определяется правами его подключения.