VK Ads MCP: кабинет VK Рекламы для агента в Claude и Codex

askads/mcp-vk-ads· Проверено 12.11.2026· 13на GitHub

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

3 реализации:

22 инструмента, кабинет подключается прямо в диалоге по client_id и client_secret, токен продлевается сам; ставки и бюджеты в валюте кабинета.

Как подключить

Что сделать до подключения

1

Node.js 20 или новее

2

В ads.vk.com: Настройки → Доступ к API → создать приложение; client_id и client_secret прислать агенту после фразы «Подключи ВК Рекламу»

3
client_id и client_secret

ads.vk.com → Настройки → Доступ к API → создать приложение; сервер хранит их в ~/.config/mcp-vk-ads/credentials.json

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio vk-reklama \
  -- npx -y mcp-vk-ads@latest

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Собрать вместе с другими серверами в одном mcp.json →

Инструменты сервера

start_loginначинает подключение кабинета
finish_loginзавершает подключение
auth_statusпоказывает статус подключения
get_balanceпоказывает баланс кабинета
get_throttlingпоказывает остаток лимитов API
get_regionsищет ID регионов
list_ad_plansперечисляет кампании
list_ad_groupsперечисляет группы объявлений
list_bannersперечисляет объявления
get_statisticsвыдаёт статистику за период
create_ad_planсоздаёт кампанию
update_ad_groupменяет группу, бюджет и ставку
create_bannerсоздаёт объявление
banner_actionзапускает или останавливает объявление
upload_imageзагружает картинку
raw_requestвызывает любой метод API

Показано 16 из 22.

Что попросить агента

«Покажи кампании моего аккаунта VK Рекламы и расход за прошлую неделю по группам объявлений»VK Реклама MCP вызовет list_ad_plans, list_ad_groups и get_statistics
«Какие объявления тратят больше всего и не приносят результата?»Агент сопоставит list_banners и get_statistics по объявлениям
«Найди объявления, которые не прошли модерацию»VK Реклама MCP вызовет list_banners и проверит moderation_status
«Измени дневной бюджет этой группы на 1 500 рублей»VK Реклама MCP вызовет update_ad_group; правка сразу применится в кабинете
«Покажи баланс кабинета и сколько запросов к API осталось»VK Реклама MCP вызовет get_balance и get_throttling

Для каких задач

Показать расход, показы, клики и CTR по кампаниям за последние 7 дней
Найти объявления, которые тратят больше всего без результата или не прошли модерацию
Создать кампанию с дневным бюджетом или поменять бюджет группы
Остановить или запустить объявление по ID
Проверить баланс кабинета и остаток лимитов API
Разбить статистику по полу, возрасту и площадкам и собрать похожую аудиторию

Ограничения

!

У VK Рекламы нет песочницы: создание, правка и смена статуса сразу меняют боевой кабинет и могут тратить бюджет

!

client_id и client_secret дают полный доступ к кабинету, включая трату бюджета

!

Все три проекта небольшие: 12, 5 и 3 звезды; lexamarketolog в статусе v0.4-dev, последнее обновление в мае 2026 года

!

VK Реклама MCP по умолчанию шлёт анонимную телеметрию; отключается переменной ASKADS_TELEMETRY=0

Если не работает

Группа объявлений создалась, но её не видно в интерфейсе
У lexamarketolog группа без ad_plan_id становится сиротой и не видна в новом интерфейсе. Создавайте её через create_ad_plan с вложенным campaigns.
После сетевой ошибки или 5xx непонятно, создался ли объект
Не повторяйте создание вслепую: операция могла пройти. Сначала проверьте список кампаний, групп или объявлений.
Токен перестал работать, ответ invalid_token
Токен, выпущенный вручную, живёт около суток и сам не продлевается: выпустите новый. У одного пользователя не больше 5 активных токенов на приложение.

Какую реализацию выбрать

РеализацияКто делаетЗвёздыЗапускКлючИнструментыОбновлён
VK Реклама MCPAsk Ads13локальнотокен221 ноября 2026
VK Ads MCP (theYahia)theYahia5локальнотокен86 сентября 2026
vk-ads-mcp (lexamarketolog)lexamarketolog3локальнотокен5510 мая 2026

Частые вопросы

Где взять доступ к API VK Рекламы?
В ads.vk.com откройте Настройки → Доступ к API и создайте приложение: оно выдаст client_id и client_secret. VK Реклама MCP получит по ним токен сам, остальным серверам нужен готовый access_token или те же client_id и client_secret в переменных.
Почему нельзя войти через браузер?
Сценарий authorization_code VK выдаёт только партнёрам с согласованным redirect_uri, поэтому подключение идёт через приложение самого пользователя.
Сколько живёт токен?
Около суток. VK Реклама MCP продлевает его сам по refresh_token. VK Ads MCP от theYahia обновляет токен при ошибке 401, если заданы VK_ADS_CLIENT_ID, VK_ADS_CLIENT_SECRET и VK_ADS_REFRESH_TOKEN.
Можно ли работать с кабинетами клиентов агентства?
У lexamarketolog есть режим агентства: задайте VK_ADS_AGENCY_CLIENT_NAME с логином клиента, и сервер получает токен через agency_client_credentials. В VK Ads v2 кабинет выбирается токеном, без параметра account_id.
Чем кампания отличается от группы в API?
В VK Рекламе кампания — ad_plan, группа объявлений — ad_group, объявление — banner. У lexamarketolog группы называются campaign по старым именам myTarget: группу без ad_plan_id новый интерфейс не покажет.
Как подключить VK Ads MCP к Codex?
Выполните codex mcp add vk-ads -- npx -y mcp-vk-ads@latest и скажите агенту «Подключи ВК Рекламу». Переменные окружения не нужны, кабинет подключается в диалоге.
Как подключить VK Ads MCP к Claude Code?
Для VK Реклама MCP: claude mcp add --transport stdio --scope user vk-ads -- npx -y mcp-vk-ads@latest. Для theYahia: claude mcp add vk-ads -e VK_ADS_TOKEN=<токен> -- npx -y @theyahia/vk-ads-mcp.
Работает ли сервер из России?
Серверы запускаются на вашем компьютере и работают с API ads.vk.com по вашему токену, зарубежные аккаунты не нужны.

Похожие серверы