MCPHIVE

VK Реклама MCP: Документация

Обновлено:

Подключение

npx -y @theyahia/vk-ads-mcp (только stdio). Auth: VK_ADS_TOKEN — OAuth2 Bearer-токен VK Ads API v2 (живёт ~1 день); опционально VK_ADS_CLIENT_ID + VK_ADS_CLIENT_SECRET + VK_ADS_REFRESH_TOKEN для автообновления по grant_type=refresh_token при 401 — без них токен придётся обновлять вручную.

Инструменты

8 инструментов: кампании (list_campaigns — с фильтром по статусу, create_campaign — название/цель/бюджет, update_campaign — правки и старт/стоп/удаление), группы объявлений (list_ad_groups — с таргетингом, фильтр по кампании), баннеры (list_ads — с автопагинацией, create_ad — текстовые блоки, ссылки, контент), get_statistics (просмотры/клики/расход по дням) и get_account (данные аккаунта и баланс, нужен скоуп read_payments).

Сценарий для агента

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

Важно

Community-проект (theYahia), не официальный продукт VK. Только stdio-транспорт. Версия 4.0.0 (23.06.2026) — ломающий релиз: убраны параметры account_id из v1, числовые статусы заменены на строковые, переименованы поля бюджета — старые сценарии нужно проверить заново.