MCP-сервер VK Реклама

VK Реклама MCP

MCP-сервер для VK Рекламы: кампании, группы, объявления, статистика и баланс через диалог, подключение кабинета без ручного OAuth

MCP-сервер

Высокий риск

Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.

Почему такой уровень

  • Создание, обновление и смена статусов кампаний применяются сразу в боевом кабинете без песочницы
  • OAuth-токен дает доступ к бюджету и ставкам рекламного кабинета
Все причины и проверки
Российский стек

askads/mcp-vk-ads

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/vk-reklama-mcp

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

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

Выполните в терминале

claude mcp add --transport stdio mcp-vk-ads -- npx -y mcp-vk-ads@1.5.0

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "mcp-vk-ads": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-vk-ads@1.5.0"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

VK_ADS_TOKENсекрет, необязательная
Optional ready-made VK Ads OAuth2 access token (Bearer) for CI and unattended installs — full account access, treat it as a secret. Without it the server connects from the chat via start_login/finish_login.
VK_ADS_LANGнеобязательная
Language for API responses (Accept-Language header), e.g. ru, en.
VK_ADS_TIMEOUT_MSнеобязательная
Per-request timeout in milliseconds.
VK_ADS_MAX_RETRIESнеобязательная
Max retries for transient errors (429 rate limit, 5xx on GET, network errors on GET).
VK_ADS_API_BASEнеобязательная
API root without a version segment. Defaults to https://ads.vk.com/api.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "mcp-vk-ads": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-vk-ads@1.5.0"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Ключи и настройки

VK_ADS_TOKENсекрет, необязательная
Optional ready-made VK Ads OAuth2 access token (Bearer) for CI and unattended installs — full account access, treat it as a secret. Without it the server connects from the chat via start_login/finish_login.
VK_ADS_LANGнеобязательная
Language for API responses (Accept-Language header), e.g. ru, en.
VK_ADS_TIMEOUT_MSнеобязательная
Per-request timeout in milliseconds.
VK_ADS_MAX_RETRIESнеобязательная
Max retries for transient errors (429 rate limit, 5xx on GET, network errors on GET).
VK_ADS_API_BASEнеобязательная
API root without a version segment. Defaults to https://ads.vk.com/api.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

code --add-mcp '{"name":"mcp-vk-ads","type":"stdio","command":"npx","args":["-y","mcp-vk-ads@1.5.0"]}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "mcp-vk-ads": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-vk-ads@1.5.0"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Ключи и настройки

VK_ADS_TOKENсекрет, необязательная
Optional ready-made VK Ads OAuth2 access token (Bearer) for CI and unattended installs — full account access, treat it as a secret. Without it the server connects from the chat via start_login/finish_login.
VK_ADS_LANGнеобязательная
Language for API responses (Accept-Language header), e.g. ru, en.
VK_ADS_TIMEOUT_MSнеобязательная
Per-request timeout in milliseconds.
VK_ADS_MAX_RETRIESнеобязательная
Max retries for transient errors (429 rate limit, 5xx on GET, network errors on GET).
VK_ADS_API_BASEнеобязательная
API root without a version segment. Defaults to https://ads.vk.com/api.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

codex mcp add mcp-vk-ads -- npx -y mcp-vk-ads@1.5.0

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.mcp-vk-ads]
command = "npx"
args = ["-y", "mcp-vk-ads@1.5.0"]

Если файл уже есть, допишите блок в конец.

Ключи и настройки

VK_ADS_TOKENсекрет, необязательная
Optional ready-made VK Ads OAuth2 access token (Bearer) for CI and unattended installs — full account access, treat it as a secret. Without it the server connects from the chat via start_login/finish_login.
VK_ADS_LANGнеобязательная
Language for API responses (Accept-Language header), e.g. ru, en.
VK_ADS_TIMEOUT_MSнеобязательная
Per-request timeout in milliseconds.
VK_ADS_MAX_RETRIESнеобязательная
Max retries for transient errors (429 rate limit, 5xx on GET, network errors on GET).
VK_ADS_API_BASEнеобязательная
API root without a version segment. Defaults to https://ads.vk.com/api.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "mcp-vk-ads": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-vk-ads@1.5.0"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

VK_ADS_TOKENсекрет, необязательная
Optional ready-made VK Ads OAuth2 access token (Bearer) for CI and unattended installs — full account access, treat it as a secret. Without it the server connects from the chat via start_login/finish_login.
VK_ADS_LANGнеобязательная
Language for API responses (Accept-Language header), e.g. ru, en.
VK_ADS_TIMEOUT_MSнеобязательная
Per-request timeout in milliseconds.
VK_ADS_MAX_RETRIESнеобязательная
Max retries for transient errors (429 rate limit, 5xx on GET, network errors on GET).
VK_ADS_API_BASEнеобязательная
API root without a version segment. Defaults to https://ads.vk.com/api.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "mcp-vk-ads": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-vk-ads@1.5.0"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Ключи и настройки

VK_ADS_TOKENсекрет, необязательная
Optional ready-made VK Ads OAuth2 access token (Bearer) for CI and unattended installs — full account access, treat it as a secret. Without it the server connects from the chat via start_login/finish_login.
VK_ADS_LANGнеобязательная
Language for API responses (Accept-Language header), e.g. ru, en.
VK_ADS_TIMEOUT_MSнеобязательная
Per-request timeout in milliseconds.
VK_ADS_MAX_RETRIESнеобязательная
Max retries for transient errors (429 rate limit, 5xx on GET, network errors on GET).
VK_ADS_API_BASEнеобязательная
API root without a version segment. Defaults to https://ads.vk.com/api.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "mcp-vk-ads": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-vk-ads@1.5.0"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Ключи и настройки

VK_ADS_TOKENсекрет, необязательная
Optional ready-made VK Ads OAuth2 access token (Bearer) for CI and unattended installs — full account access, treat it as a secret. Without it the server connects from the chat via start_login/finish_login.
VK_ADS_LANGнеобязательная
Language for API responses (Accept-Language header), e.g. ru, en.
VK_ADS_TIMEOUT_MSнеобязательная
Per-request timeout in milliseconds.
VK_ADS_MAX_RETRIESнеобязательная
Max retries for transient errors (429 rate limit, 5xx on GET, network errors on GET).
VK_ADS_API_BASEнеобязательная
API root without a version segment. Defaults to https://ads.vk.com/api.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "mcp-vk-ads": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-vk-ads@1.5.0"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

VK_ADS_TOKENсекрет, необязательная
Optional ready-made VK Ads OAuth2 access token (Bearer) for CI and unattended installs — full account access, treat it as a secret. Without it the server connects from the chat via start_login/finish_login.
VK_ADS_LANGнеобязательная
Language for API responses (Accept-Language header), e.g. ru, en.
VK_ADS_TIMEOUT_MSнеобязательная
Per-request timeout in milliseconds.
VK_ADS_MAX_RETRIESнеобязательная
Max retries for transient errors (429 rate limit, 5xx on GET, network errors on GET).
VK_ADS_API_BASEнеобязательная
API root without a version segment. Defaults to https://ads.vk.com/api.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "mcp-vk-ads": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "mcp-vk-ads@1.5.0"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Ключи и настройки

VK_ADS_TOKENсекрет, необязательная
Optional ready-made VK Ads OAuth2 access token (Bearer) for CI and unattended installs — full account access, treat it as a secret. Without it the server connects from the chat via start_login/finish_login.
VK_ADS_LANGнеобязательная
Language for API responses (Accept-Language header), e.g. ru, en.
VK_ADS_TIMEOUT_MSнеобязательная
Per-request timeout in milliseconds.
VK_ADS_MAX_RETRIESнеобязательная
Max retries for transient errors (429 rate limit, 5xx on GET, network errors on GET).
VK_ADS_API_BASEнеобязательная
API root without a version segment. Defaults to https://ads.vk.com/api.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "mcp-vk-ads": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-vk-ads@1.5.0"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Ключи и настройки

VK_ADS_TOKENсекрет, необязательная
Optional ready-made VK Ads OAuth2 access token (Bearer) for CI and unattended installs — full account access, treat it as a secret. Without it the server connects from the chat via start_login/finish_login.
VK_ADS_LANGнеобязательная
Language for API responses (Accept-Language header), e.g. ru, en.
VK_ADS_TIMEOUT_MSнеобязательная
Per-request timeout in milliseconds.
VK_ADS_MAX_RETRIESнеобязательная
Max retries for transient errors (429 rate limit, 5xx on GET, network errors on GET).
VK_ADS_API_BASEнеобязательная
API root without a version segment. Defaults to https://ads.vk.com/api.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "mcp-vk-ads": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-vk-ads@1.5.0"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

VK_ADS_TOKENсекрет, необязательная
Optional ready-made VK Ads OAuth2 access token (Bearer) for CI and unattended installs — full account access, treat it as a secret. Without it the server connects from the chat via start_login/finish_login.
VK_ADS_LANGнеобязательная
Language for API responses (Accept-Language header), e.g. ru, en.
VK_ADS_TIMEOUT_MSнеобязательная
Per-request timeout in milliseconds.
VK_ADS_MAX_RETRIESнеобязательная
Max retries for transient errors (429 rate limit, 5xx on GET, network errors on GET).
VK_ADS_API_BASEнеобязательная
API root without a version segment. Defaults to https://ads.vk.com/api.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Понадобится: Node.js

Сверено с репозиторием 25 сент. 2026, коммит db65e23.

Текст для агента

Подключи сервер через npm-пакет mcp-vk-ads в конфигурации своего MCP клиента, затем напиши агенту «подключи ВК Рекламу», чтобы он провел получение client_id и client_secret и авторизацию.

Другие способы из описания автора
npx -y mcp-vk-ads

Пакет с npm, дальше подключение кабинета происходит в диалоге с агентом.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер дает 22 инструмента для рекламного кабинета VK Ads: полную иерархию кампания (ad_plan), группа (ad_group), объявление (banner), статистику, баланс, лимиты API, регионы и универсальный запрос к API. Подключение кабинета встроено в диалог: по фразе вроде «подключи ВК Рекламу» сервер сам объясняет, где взять client_id и client_secret, получает токен и потом продлевает его сам. Списки, отчеты, баланс и статусы доступны только на чтение, а создание, обновление и смена статусов применяются сразу в боевом кабинете, песочницы у VK Ads нет.

Для кого. Для таргетологов и маркетологов, которые ведут рекламу в VK Рекламе и хотят следить за кампаниями и статистикой через агента.

Подходит, если

  • Нужно быстро посмотреть, какие кампании тратят бюджет без результата
  • Нужно сравнить группы и объявления по статистике за период
  • Нужно подготовить новую кампанию или изменить ставку прямо из чата

Не подходит, если

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

Пример запроса к агенту

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

Ограничения

У VK Ads нет тестового кабинета: создание, обновление и смена статуса кампаний, групп и объявлений выполняются сразу в боевом кабинете. Это неофициальный проект сообщества, а не сервер от VK.

Как отключить. Удалите сервер из конфигурации MCP клиента.

MCP

Транспорт
stdio
Авторизация
OAuth

Проверка безопасности

  • Создание, обновление и смена статусов кампаний применяются сразу в боевом кабинете без песочницы
  • OAuth-токен дает доступ к бюджету и ставкам рекламного кабинета

Коротко о README

README на русском описывает сервер как способ спросить агента про кампании, которые тратят бюджет без результата, сравнить группы и объявления и подготовить новую кампанию, перечисляет 22 инструмента по темам: кампании, группы, объявления, статистика, баланс, лимиты, регионы, подключение кабинета и произвольный запрос. Отдельно подчеркивается отсутствие песочницы у VK Ads.

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

Нужно вручную настраивать OAuth?

Нет, сервер объясняет в диалоге, откуда взять client_id и client_secret, получает токен сам и дальше продлевает его без участия пользователя.

Можно только смотреть кампании или и менять?

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

Выбор редакции

Скилл, который убирает из текста приметы ИИ-письма по списку Википедии и не добавляет выдуманных фактов

СкиллНизкий рискБез VPN52,7 тыс.Звезды репозитория
Выбор редакции

Около пятидесяти скиллов по CRO, копирайтингу, SEO, аналитике, рекламе и запуску продукта для кодовых агентов

СкиллНизкий риск51,8 тыс.Звезды репозитория
Официальный

Официальный удаленный MCP-сервер SendPulse: статистика, рассылки и данные пользователей через чат с агентом

MCP-серверВысокий рискРоссийский стек1Звезды репозитория
Выбор редакции

MCP-сервер и CLI на всех 113 методах API v5 Яндекс Директа, собранных из WSDL: по умолчанию только 9 читающих, запись включается явно

MCP-серверВысокий рискРоссийский стекБез VPN1Звезды репозитория
Foxx AIMCP-сервер VK Реклама

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.