Power your agent
The publisher's own command. Not a PlugMCP endpoint.
Host a copy with our keys and logs.
npx -y [email protected]Claude Code has no install link for a local command. Copy the command below and run it in a terminal.
VK_ADS_TOKEN=<secret> VK_ADS_LANG=<value> VK_ADS_TIMEOUT_MS=<value> VK_ADS_MAX_RETRIES=<value> VK_ADS_API_BASE=<value> claude mcp add askads-mcp-vk-ads -- npx -y mcp-vk-ads@1.8.3Run in a terminal.
{ "mcpServers": { "askads-mcp-vk-ads": { "command": "npx", "args": [ "-y", "[email protected]" ], "env": { "VK_ADS_TOKEN": "<secret>", "VK_ADS_LANG": "<value>", "VK_ADS_TIMEOUT_MS": "<value>", "VK_ADS_MAX_RETRIES": "<value>", "VK_ADS_API_BASE": "<value>" } } }}claude_desktop_config.json
Remote URL or a command on your machine? How the two installs differ
Run on PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
LaunchVK Реклама MCP подключает AI-приложение к рекламному кабинету VK Ads. Можно спросить, какие кампании тратят бюджет без результата, сравнить группы и объявления, подготовить новую кампанию или изменить ставку. В отличие от ручного перехода по разделам кабинета, ассистент сопоставляет кампании, статистику, баланс и статусы в одном диалоге.
client_id и client_secret, получит токен и дальше продлевает его сам.ad_plan) → группа (ad_group) → объявление (banner).Начните с безопасного запроса:
Покажи кампании моего аккаунта VK Рекламы и расход за прошлую неделю по группам объявлений.
Нужен Node.js 20 или новее. Сервер запускается через npx, поэтому отдельно устанавливать пакет не требуется; токен при установке не нужен.
Через интерфейс приложения:
npx -y mcp-vk-ads@latest. Переменные окружения не нужны: кабинет подключается в диалоге.Через командную строку:
codex mcp add vk-ads -- npx -y mcp-vk-ads@latest
Проверьте подключение:
codex mcp list
claude mcp add \
--transport stdio \
--scope user \
vk-ads \
-- npx -y mcp-vk-ads@latest
Проверьте сервер:
claude mcp list
Откройте Settings → Developer → Edit Config и добавьте сервер в claude_desktop_config.json:
{
"mcpServers": {
"vk-ads": {
"command": "npx",
"args": ["-y", "mcp-vk-ads@latest"]
}
}
}
Если 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"]
}
}
}
Откройте палитру команд и выполните MCP: Open User Configuration. Добавьте в mcp.json:
{
"servers": {
"vk-ads": {
"type": "stdio",
"command": "npx",
"args": ["-y", "mcp-vk-ads@latest"]
}
}
}
Проверьте запуск командой MCP: List Servers.
Такие команды меняют боевой кабинет. Перед вызовом убедитесь, что ассистент правильно определил кампанию, группу, объявление и сумму.
У объекта есть три разных состояния. status можно менять: active, blocked или deleted. delivery и moderation_status только объясняют, почему объект показывается или нет; напрямую их изменить нельзя.
У типизированных инструментов создания, обновления и смены статуса нет внутреннего параметра confirmWrite. Как AI-приложение запрашивает подтверждение, зависит от его настроек. После сетевой ошибки или 5xx не повторяйте создание вслепую: операция могла успеть примениться, сначала проверьте список объектов.
Скажите ассистенту:
Подключи ВК Рекламу
Он покажет, что сделать: в ads.vk.com открыть Настройки → Доступ к API, создать приложение и прислать в чат client_id и client_secret. Дальше сервер сам получит токен и проверит, в какой кабинет попал. Перезапускать AI-приложение и править его конфигурацию не нужно. Если раздел «Доступ к API» недоступен, запросите доступ у поддержки VK Рекламы.
Дальше подключение живёт само: токен VK действует около суток и продлевается автоматически по refresh_token. Проверить состояние — «покажи статус подключения», отключить — «отключи ВК Рекламу».
client_id и client_secret дают полный доступ к рекламному кабинету, включая трату бюджета. Сервер хранит их в ~/.config/mcp-vk-ads/credentials.json с правами только для владельца (0600) — client_secret нужен потому, что VK требует его при каждом продлении токена. Ни один инструмент их не возвращает.
Браузерного «войти и подтвердить» у VK Рекламы для сторонних серверов нет: сценарий authorization_code VK выдаёт только партнёрам с согласованным redirect_uri, поэтому подключение идёт через приложение самого пользователя. Кабинеты клиентов агентства требуют гранта agency_client_credentials — для них нужен готовый токен в VK_ADS_TOKEN (см. документацию VK Ads API).
Настраивать нечего: всё нужное сервер спрашивает в диалоге. Переменные окружения пригодятся только для CI и автоматических установок, где диалога нет. Все они необязательные — сервер работает без единой из них.
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
Из ответа возьмите access_token. Он живёт около суток и сам не продлевается: при invalid_token выпустите новый. У одного пользователя не больше 5 активных токенов на приложение; старые отзываются запросом POST /api/v2/oauth2/token/delete.json — он удаляет все токены этого пользователя для данного client_id.
autoPaginate сервер возвращает не более 1 000 объектов и помечает неполный результат полем _truncated.get_throttling показывает текущий остаток лимитов. Проверяйте его перед массовыми операциями.429, а для чтения ещё при сетевой ошибке, тайм-ауте и 5xx. Задержка учитывает Retry-After и не превышает 30 секунд.ASKADS_TELEMETRY=0.Нашли ошибку или не хватает сценария? Создайте issue или напишите в Telegram.
MCP-сервер для VK Ads — управляйте рекламой (кампании, группы, объявления, статистика) из Claude, Cursor, Codex и других AI-клиентов.
{ "mcpServers": { "askads-mcp-vk-ads": { "command": "npx", "args": [ "-y", "[email protected]" ], "env": { "VK_ADS_TOKEN": "<secret>", "VK_ADS_LANG": "<value>", "VK_ADS_TIMEOUT_MS": "<value>", "VK_ADS_MAX_RETRIES": "<value>", "VK_ADS_API_BASE": "<value>" } } }}Tools
No tool list yet. Remote servers get one after the first health check.
FAQ
Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
The publisher lists these environment variables: VK_ADS_TOKEN, VK_ADS_LANG, VK_ADS_TIMEOUT_MS, VK_ADS_MAX_RETRIES, VK_ADS_API_BASE.
MCP Vk Ads runs locally over stdio.
Last checked 2026-10-27. MCP-сервер для VK Ads — управляйте рекламой (кампании, группы, объявления, статистика) из Claude, Cursor, Codex и других AI-клиентов.