VK Ads MCP

VK Реклама MCPподключает AI-приложение к рекламному кабинету VK Ads. Можно спросить, какие кампании тратят бюджет без результата, сравнить группы и объявления, подготовить новую кампанию или изменить ставку. В отличие от ручного перехода по разделам кабинета, ассистент сопоставляет кампании, статистику, баланс и статусы в одном диалоге.

- 18 инструментов.Кампании, группы, объявления, статистика, баланс, лимиты API, регионы и универсальный запрос к API.
- Живая реклама.Ставки, бюджеты и расход отображаются в валюте рекламного кабинета — без пересчёта микроединиц.
- Полная иерархия.Кампания (ad_plan) → группа (ad_group) → объявление (banner).
- Сначала анализ.Списки, отчёты, баланс и статусы доступны только на чтение.
- Изменения — в боевом кабинете.Создание, обновление и действия со статусами применяются сразу; у VK Ads нет песочницы.

Покажи кампании моего аккаунта VK Рекламы и расход за прошлую неделю по группам объявлений.

Подключить сервер·Посмотреть сценарии·Открыть техническую документацию

- Быстрый старт
- Что можно поручить
- Как устроены объекты VK Рекламы
- Что может изменить данные
- Как получить токен
- Настройка
- Данные, лимиты и работа в фоне
- Техническая документация
- Поддержка

Нужны Node.js 20 или новее и access-токен VK Ads. Сервер запускается черезnpx, поэтому отдельно устанавливать пакет не требуется.
- Получите токени добавьте сервер в AI-приложение — инструкции для пяти приложений ниже.
- Спросите: «Покажи кампании моего аккаунта VK Рекламы и расход за прошлую неделю по группам объявлений».
- ОткройтеSettings → Plugins → MCP servers.
- НажмитеAdd server.
- Добавьте команду запускаnpx -y mcp-vk-ads@latestи переменную окруженияVK_ADS_TOKENсо своим токеном.

codex mcp add vk-ads \ --env VK_ADS_TOKEN=ваш_токен \ -- npx -y mcp-vk-ads@latest

claude mcp add \ --env VK_ADS_TOKEN=ваш_токен \ --transport stdio \ --scope user \ vk-ads \ -- npx -y mcp-vk-ads@latest

{ "mcpServers": { "vk-ads": { "command": "npx", "args": ["-y", "mcp-vk-ads@latest"], "env": { "VK_ADS_TOKEN": "ваш_токен" } } } }

ЕслиEdit Configнедоступна, отредактируйте~/Library/Application Support/Claude/claude_desktop_config.jsonна macOS или%APPDATA%\Claude\claude_desktop_config.jsonна Windows.

Для всех проектов создайте~/.cursor/mcp.json; только для текущего проекта —.cursor/mcp.json:

{ "mcpServers": { "vk-ads": { "command": "npx", "args": ["-y", "mcp-vk-ads@latest"], "env": { "VK_ADS_TOKEN": "ваш_токен" } } } }

Откройте палитру команд и выполнитеMCP: Open User Configuration. Добавьте вmcp.json:

{ "servers": { "vk-ads": { "type": "stdio", "command": "npx", "args": ["-y", "mcp-vk-ads@latest"], "env": { "VK_ADS_TOKEN": "${input:vk_ads_token}" } } }, "inputs": [ { "type": "promptString", "id": "vk_ads_token", "description": "Access-токен VK Ads", "password": true } ] }

Проверьте запуск командойMCP: List Servers.

- «Покажи расход, показы, клики и CTR по кампаниям за последние 7 дней».
- «Какие объявления тратят больше всего и не приносят результата?»
- «Сравни группы объявлений внутри этой кампании по расходу и кликам».

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

- «Создай текстовую кампанию с дневным бюджетом 5 000 рублей».
- «Измени дневной бюджет этой группы на 1 500 рублей».
- «Останови объявление 12345».

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

- «Покажи баланс и валюту моего кабинета».
- «Сколько запросов к API осталось?»
- «Найди ID региона Москва для таргетинга».

У объекта есть три разных состояния.statusможно менять:active,blockedилиdeleted.deliveryиmoderation_statusтолько объясняют, почему объект показывается или нет; напрямую их изменить нельзя.

У типизированных инструментов создания, обновления и смены статуса нет внутреннего параметраconfirmWrite. Как AI-приложение запрашивает подтверждение, зависит от его настроек. После сетевой ошибки или5xxне повторяйте создание вслепую: операция могла успеть примениться, сначала проверьте список объектов.
-

Вads.vk.comоткройтеНастройки → Доступ к APIи создайте приложение. Сохранитеclient_idиclient_secret. Если раздел недоступен, запросите доступ к API у поддержки VK Ads.

curl -X POST https://ads.vk.com/api/v2/oauth2/token.json \ -d grant_type=client_credentials \ -d client_id=ВАШ_CLIENT_ID \ -d client_secret=ВАШ_CLIENT_SECRET

Для агентств, работающих с кабинетами клиентов, нужен сценарийauthorization_code— см.документацию VK Ads API.

- Каталог MCP-возможностей— страницы по пользовательским задачам для каждого инструмента.
- Все инструменты и параметры
- Документация по разработке
- Пакет в npm
- Документация VK Ads API

Нашли ошибку или не хватает сценария?Создайте issueили напишите вTelegram.

Interact with the Taboola advertising platform using natural language via the Taboola Realize API.