К содержимому
Начало работы

Установка и первые шаги

Обновлено

Установите плагин

  1. Убедитесь, что в Webasyst установлено приложение MCP версии 1.3.0 или новее.
  2. Откройте карточку «VK Реклама для MCP» в маркете Webasyst и установите продукт через «Инсталлер» в нужный аккаунт.
  3. В бэкенде откройте MCP → Плагины → VK Реклама для MCP.

Плагин устанавливается для приложения MCP. Настраивать его в разделе плагинов магазина не требуется.

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

Получите ID и секрет клиента API в кабинете VK Рекламы: Настройки → Доступ к API. Доступ выдаётся по заявке. Подробности — в статье «Подключение VK».

В настройках плагина заполните:

  • ID клиента API (client_id);
  • Секрет клиента API (client_secret);
  • Логин клиента агентства, если работаете от имени клиента агентства или менеджера. Для своего кабинета оставьте пустым.

На первом этапе можно оставить Предел изменения бюджета и ставки, % равным 50. Сохраните настройки.

Разрешите доступ агенту

При выдаче токена в приложении MCP выберите нужные инструменты раздела VK Реклама. Для проверки подключения нужен Кабинет VK Рекламы (vkads_get_account). Для просмотра рекламы добавьте инструменты чтения. Полный перечень приведён в статье «MCP-инструменты и права».

Подключите MCP-клиент способом, который предоставляет установленное приложение MCP. Плагин добавляет инструменты в его сервер и не создаёт собственный адрес подключения.

Проверьте результат

Попросите агента:

Покажи подключённый кабинет VK Рекламы: логин, баланс, валюту и шаг бюджета.
Ничего не меняй.

Для разработчика: это вызов vkads_get_account с пустым объектом аргументов {}. Успешный ответ имеет ok=true и сведения кабинета. Отсутствующие в ответе VK сведения могут быть null; это не то же самое, что нулевой баланс.

Сверьте кабинет с нужным аккаунтом VK. Затем попросите:

Покажи кампании VK Рекламы и их статусы. Если список не помещается
на одной странице, получи следующие страницы. Ничего не меняй.

Пустой список кампаний сам по себе не означает ошибку подключения. Если вернулся not_configured, проверьте заполнение ID и секрета клиента API. Если инструмента нет у агента, проверьте права токена и обновите список инструментов в MCP-клиенте.