
VK Ads MCP: кабинет VK Рекламы для агента в Claude и Codex
Подключает агента к кабинету VK Рекламы через API: смотреть расход и статистику кампаний, групп и объявлений, баланс, создавать кампании и менять бюджеты. Правки сразу уходят в боевой кабинет.
22 инструмента, кабинет подключается прямо в диалоге по client_id и client_secret, токен продлевается сам; ставки и бюджеты в валюте кабинета.
Как подключить
Что сделать до подключения
Node.js 20 или новее
В ads.vk.com: Настройки → Доступ к API → создать приложение; client_id и client_secret прислать агенту после фразы «Подключи ВК Рекламу»
client_id и client_secretads.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.
Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex
[mcp_servers.vk-reklama]
command = "npx"
args = ["-y", "mcp-vk-ads@latest"]Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.
Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor
{
"mcpServers": {
"vk-reklama": {
"command": "npx",
"args": ["-y", "mcp-vk-ads@latest"]
}
}
}Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.
Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code
{
"mcpServers": {
"vk-reklama": {
"type": "stdio",
"command": "npx",
"args": ["-y", "mcp-vk-ads@latest"]
}
}
}Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.
Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code
{
"mcpServers": {
"vk-reklama": {
"command": "npx",
"args": ["-y", "mcp-vk-ads@latest"]
}
}
}Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.
Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI
{
"mcpServers": {
"vk-reklama": {
"command": "npx",
"args": ["-y", "mcp-vk-ads@latest"]
}
}
}Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.
Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servers": {
"vk-reklama": {
"type": "local",
"command": ["npx", "-y", "mcp-vk-ads@latest"]
}
}
}
}Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.
Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop
{
"mcpServers": {
"vk-reklama": {
"command": "npx",
"args": ["-y", "mcp-vk-ads@latest"]
}
}
}Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.
Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio
{
"mcpServers": {
"vk-reklama": {
"command": "npx",
"args": ["-y", "mcp-vk-ads@latest"]
}
}
}Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.
Инструменты сервера
start_loginначинает подключение кабинетаfinish_loginзавершает подключениеauth_statusпоказывает статус подключенияget_balanceпоказывает баланс кабинетаget_throttlingпоказывает остаток лимитов APIget_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.
8 инструментов по готовому токену: кампании, группы, объявления, статистика и баланс; запуск через npx.
Как подключить
Что сделать до подключения
Node.js с командой npx
VK_ADS_TOKENOAuth2 access_token VK Ads API; живёт около суток, для автообновления задайте VK_ADS_CLIENT_ID, VK_ADS_CLIENT_SECRET и VK_ADS_REFRESH_TOKEN
Конфиг для вашего клиента
Впишите ключи, и они встанут во все конфиги ниже. Конфиг собирается в браузере.
Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code
claude mcp add --env 'VK_ADS_TOKEN=<access_token VK Ads>' --transport stdio vk-ads-mcp \
-- npx -y @theyahia/vk-ads-mcpПроверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.
Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex
[mcp_servers.vk-ads-mcp]
command = "npx"
args = ["-y", "@theyahia/vk-ads-mcp"]
[mcp_servers.vk-ads-mcp.env]
VK_ADS_TOKEN = "<access_token VK Ads>"Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.
Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor
{
"mcpServers": {
"vk-ads-mcp": {
"command": "npx",
"args": ["-y", "@theyahia/vk-ads-mcp"],
"env": {
"VK_ADS_TOKEN": "<access_token VK Ads>"
}
}
}
}Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.
Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code
{
"mcpServers": {
"vk-ads-mcp": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@theyahia/vk-ads-mcp"],
"env": {
"VK_ADS_TOKEN": "<access_token VK Ads>"
}
}
}
}Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.
Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code
{
"mcpServers": {
"vk-ads-mcp": {
"command": "npx",
"args": ["-y", "@theyahia/vk-ads-mcp"],
"env": {
"VK_ADS_TOKEN": "<access_token VK Ads>"
}
}
}
}Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.
Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI
{
"mcpServers": {
"vk-ads-mcp": {
"command": "npx",
"args": ["-y", "@theyahia/vk-ads-mcp"],
"env": {
"VK_ADS_TOKEN": "<access_token VK Ads>"
}
}
}
}Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.
Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servers": {
"vk-ads-mcp": {
"type": "local",
"command": ["npx", "-y", "@theyahia/vk-ads-mcp"],
"environment": {
"VK_ADS_TOKEN": "<access_token VK Ads>"
}
}
}
}
}Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.
Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop
{
"mcpServers": {
"vk-ads-mcp": {
"command": "npx",
"args": ["-y", "@theyahia/vk-ads-mcp"],
"env": {
"VK_ADS_TOKEN": "<access_token VK Ads>"
}
}
}
}Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.
Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio
{
"mcpServers": {
"vk-ads-mcp": {
"command": "npx",
"args": ["-y", "@theyahia/vk-ads-mcp"],
"env": {
"VK_ADS_TOKEN": "<access_token VK Ads>"
}
}
}
}Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.
Инструменты сервера
list_campaignsперечисляет кампанииcreate_campaignсоздаёт кампаниюupdate_campaignменяет бюджет, запускает и останавливаетlist_ad_groupsперечисляет группы объявленийlist_adsперечисляет объявленияcreate_adсоздаёт объявлениеget_statisticsвыдаёт показы, клики и расходget_accountпоказывает кабинет и баланс55 инструментов на Python: кроме кампаний и статистики с разбивкой по полу, возрасту и площадкам — ретаргетинг, пиксели, свои аудитории, похожие аудитории, фиды и клиенты агентства.
Как подключить
Что сделать до подключения
Python 3.11 и uv
Склонировать репозиторий и выполнить uv sync
VK_ADS_ACCESS_TOKENads.vk.com → Настройки профиля → Получить токен / API
VK_ADS_CLIENT_ID и VK_ADS_CLIENT_SECRETвместо токена: приложение на target.vk.ru → API → Приложения → Создать, после модерации
Конфиг для вашего клиента
Впишите ключи, и они встанут во все конфиги ниже. Конфиг собирается в браузере.
Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code
claude mcp add --env 'VK_ADS_ACCESS_TOKEN=<токен VK Ads>' --transport stdio vk-ads-mcp \
-- uvx --from '<путь к vk-ads-mcp>' vk-ads-mcpПроверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.
Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex
[mcp_servers.vk-ads-mcp]
command = "uvx"
args = ["--from", "<путь к vk-ads-mcp>", "vk-ads-mcp"]
[mcp_servers.vk-ads-mcp.env]
VK_ADS_ACCESS_TOKEN = "<токен VK Ads>"Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.
Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor
{
"mcpServers": {
"vk-ads-mcp": {
"command": "uvx",
"args": ["--from", "<путь к vk-ads-mcp>", "vk-ads-mcp"],
"env": {
"VK_ADS_ACCESS_TOKEN": "<токен VK Ads>"
}
}
}
}Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.
Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code
{
"mcpServers": {
"vk-ads-mcp": {
"type": "stdio",
"command": "uvx",
"args": ["--from", "<путь к vk-ads-mcp>", "vk-ads-mcp"],
"env": {
"VK_ADS_ACCESS_TOKEN": "<токен VK Ads>"
}
}
}
}Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.
Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code
{
"mcpServers": {
"vk-ads-mcp": {
"command": "uvx",
"args": ["--from", "<путь к vk-ads-mcp>", "vk-ads-mcp"],
"env": {
"VK_ADS_ACCESS_TOKEN": "<токен VK Ads>"
}
}
}
}Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.
Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI
{
"mcpServers": {
"vk-ads-mcp": {
"command": "uvx",
"args": ["--from", "<путь к vk-ads-mcp>", "vk-ads-mcp"],
"env": {
"VK_ADS_ACCESS_TOKEN": "<токен VK Ads>"
}
}
}
}Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.
Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servers": {
"vk-ads-mcp": {
"type": "local",
"command": ["uvx", "--from", "<путь к vk-ads-mcp>", "vk-ads-mcp"],
"environment": {
"VK_ADS_ACCESS_TOKEN": "<токен VK Ads>"
}
}
}
}
}Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.
Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop
{
"mcpServers": {
"vk-ads-mcp": {
"command": "uvx",
"args": ["--from", "<путь к vk-ads-mcp>", "vk-ads-mcp"],
"env": {
"VK_ADS_ACCESS_TOKEN": "<токен VK Ads>"
}
}
}
}Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.
Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio
{
"mcpServers": {
"vk-ads-mcp": {
"command": "uvx",
"args": ["--from", "<путь к vk-ads-mcp>", "vk-ads-mcp"],
"env": {
"VK_ADS_ACCESS_TOKEN": "<токен VK Ads>"
}
}
}
}Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.
Инструменты сервера
auth_checkпроверяет доступget_account_infoчитает данные кабинетаlist_ad_plansперечисляет кампанииcreate_ad_planсоздаёт кампанию с группамиlist_campaignsперечисляет группы объявленийlist_bannersперечисляет объявленияupload_imageзагружает картинкуget_statistics_dayвыдаёт статистику по днямget_statistics_breakdownразбивает статистику по полу, возрасту, регионуcreate_async_reportзаказывает большой отчётcreate_remarketing_pixelсоздаёт пиксельcreate_users_listсоздаёт список аудиторииupload_users_list_itemsзагружает хеши почт и телефоновcreate_lookalikeстроит похожую аудиториюlist_agency_clientsперечисляет клиентов агентстваsearch_regionsищет регионыПоказано 16 из 55.
Что попросить агента
Для каких задач
Ограничения
У VK Рекламы нет песочницы: создание, правка и смена статуса сразу меняют боевой кабинет и могут тратить бюджет
client_id и client_secret дают полный доступ к кабинету, включая трату бюджета
Все три проекта небольшие: 12, 5 и 3 звезды; lexamarketolog в статусе v0.4-dev, последнее обновление в мае 2026 года
VK Реклама MCP по умолчанию шлёт анонимную телеметрию; отключается переменной ASKADS_TELEMETRY=0
Если не работает
Группа объявлений создалась, но её не видно в интерфейсе
После сетевой ошибки или 5xx непонятно, создался ли объект
Токен перестал работать, ответ invalid_token
Какую реализацию выбрать
| Реализация | Кто делает | Звёзды | Запуск | Ключ | Инструменты | Обновлён |
|---|---|---|---|---|---|---|
| VK Реклама MCP | Ask Ads | 13 | локально | токен | 22 | 1 ноября 2026 |
| VK Ads MCP (theYahia) | theYahia | 5 | локально | токен | 8 | 6 сентября 2026 |
| vk-ads-mcp (lexamarketolog) | lexamarketolog | 3 | локально | токен | 55 | 10 мая 2026 |