VK Ads MCP All in One

Сервер подключает MCP-клиент к VK Рекламе: читает кампании, группы и объявления, получает статистику, работает с аудиториями, креативами, лид-формами, опросами, подписками, прайс-листами и справочниками. Отдельный блок Core VK API ищет и анализирует публичные сообщества.

В текущей версии зарегистрировано 128 инструментов. Из них 102 проверены в VK Рекламе, ещё 26 пока недоступны или не проверены. Все 10 инструментов для работы с сообществами VK имеют статус ⛔️.

Быстрый старт

Нужны:

• Node.js 22 или новее с npm;

• client_id и client_secret приложения VK Ads.

npx --yes github:sergeylopukhov/vk-ads-mcp-all-in-one

Установщик:

1. скачает последнюю версию;

2. установит зависимости и соберёт сервер;

3. запросит client_id;

4. запросит client_secret со скрытым вводом;

5. предложит подключить поиск сообществ через отдельный OAuth VK;

6. сохранит учётные данные и токены в локальном auth.env;

7. подключит сервер к Codex под именем vk-ads;

8. установит навык Codex для безопасной работы с доступными инструментами.

Навык включается автоматически для задач о VK Ads и сообществах VK. Он выбирает подходящие инструменты MCP, помогает восстанавливать токены, проверять подключение, анализировать статистику и сообщества, управлять кампаниями, аудиториями, лидами и опросами. Для анализа по умолчанию используется подробный отчёт. Инструменты записи вызываются только по явному запросу пользователя. Навык и его справочники обновляются вместе с сервером.

После установки перезапустите Codex и отправьте:

Проверь подключение к VK Рекламе и покажи доступные кампании. Ничего не меняй.

Related MCP server: vk-ads-mcp

Обновление

Повторно выполните команду установки. Установщик покажет установленную и доступную версии:

• «обновить» заменит сервер и навык Codex, но сохранит auth.env, токены и локальный аудит;

• «установить заново» повторно запросит client_id и client_secret, а сохранённые токены очистит.

Каталог установки по умолчанию:

• macOS: ~/Library/Application Support/VK Ads MCP;

• Linux: ~/.local/share/vk-ads-mcp;

• Windows: %LOCALAPPDATA%\VK Ads MCP.

Для другой папки или ветки:

npx --yes github:sergeylopukhov/vk-ads-mcp-all-in-one --install-dir "/полный/путь" --ref main

Все параметры:

npx --yes github:sergeylopukhov/vk-ads-mcp-all-in-one --help

Как создаётся и хранится токен

Учётные данные хранятся только в auth.env внутри каталога установки:

VK_ADS_CLIENT_ID=
VK_ADS_CLIENT_SECRET=
VK_ADS_TOKEN=
VK_ADS_REFRESH_TOKEN=
VK_ADS_TOKEN_EXPIRES_AT=
VK_API_TOKEN=
VK_API_TOKEN_TYPE=vk_id
VK_API_CLIENT_ID=
VK_API_DEVICE_ID=
VK_API_REFRESH_TOKEN=
VK_API_TOKEN_EXPIRES_AT=
VK_COMMUNITY_RESEARCH_TTL_DAYS=30

При первом запросе сервер получает токен по client_id и client_secret. Если VK Ads возвращает refresh_token, сервер сохраняет его и заранее обновляет токен доступа.

Токен с истекающим сроком действия обновляется автоматически. После HTTP 401 сервер один раз обновляет отклонённую пару и повторяет запрос. Для ручного обновления используется vk_ads_oauth_token_refresh. Если пара полностью отозвана на другом компьютере и обновить её невозможно, vk_ads_oauth_current_tokens_delete удаляет все токены настроенного аккаунта, очищает локальные значения и запрашивает новую пару.

Инструменты сообществ используют отдельный VK_API_TOKEN. По умолчанию установщик предлагает режим OAuth legacy через встроенное приложение VK с client_id=6270012: достаточно нажать Enter. Для VK ID укажите своё приложение. Также можно сохранить VK_API_CLIENT_ID, VK_API_DEVICE_ID, VK_API_REFRESH_TOKEN и срок действия, чтобы сервер обновлял токен Core VK при запуске.

auth.env исключён из Git и npm-пакета. На macOS и Linux установщик создаёт его с правами 0600. Токены, client_secret и полные приватные ответы VK Ads не выводятся через MCP.

Что умеет сервер

Полный перечень, тип доступа и статусы: docs/tools.md.

Безопасность записи

Записывающие инструменты используют фиксированные API-маршруты и строгие входные схемы. Для операций над существующим объектом сервер сначала читает актуальное состояние. После изменения он повторно читает объект или коллекцию, когда VK Ads предоставляет подходящий контракт.

Успешный HTTP-ответ не считается доказательством изменения. Если контрольное чтение не подтвердило результат, MCP возвращает ошибку или неподтверждённый итог. Например, remoderated=false не превращается в успешную перемодерацию.

Журнал операций хранится локально в .vk-ads-audit.jsonl. В нём нет токенов, содержимого запросов, идентификаторов кампаний, названий или ответов VK Ads.

MCP-клиенты

Установщик автоматически настраивает Codex. Для Claude Code, Gemini CLI, Qwen Code и Kimi Code CLI используйте инструкции по подключению.

• Подключение Codex

• Подключение других MCP-клиентов

Документация

• Каталог инструментов

• Подключение Codex

• Подключение MCP-клиентов

• Политика безопасности

• История изменений

• Лицензия MIT