MCP-сервер VK Реклама, только чтение

vk-ads-mcp

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

MCP-сервер

Средний риск

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

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

  • Ходит в рекламный кабинет с деньгами клиента, хотя только читает данные
  • Токен приложения может иметь более широкие права, чем использует сервер
Все причины и проверки
Российский стек

qusto/vk-ads-mcp

Установка

Ручная установка

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

Установи и запусти vk-ads-mcp с client_id и client_secret OAuth-приложения VK Реклама, подключи сервер к MCP-клиенту по stdio и используй промпт campaign_analysis для разбора кампаний.

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

Что делает

Сервер отдает структуру рекламного кабинета VK Реклама (ads.vk.com): списки кампаний, групп объявлений и баннеров с фильтрами и пагинацией, дневную и сводную статистику за период, топ объектов по метрике вроде CTR, CPC, CPA или расхода. Сам разбивает период больше 92 дней и список больше 50 id на части, чтобы не упереться в лимиты API. Есть инструмент describe_fields, который на лету узнает у API допустимые поля для каждого типа объекта, ресурсы со справочником метрик и иерархией кампаний, и промпт campaign_analysis с готовым сценарием разбора на русском. Ничего не создает и не меняет.

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

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

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

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

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

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

Покажи топ-5 групп объявлений по CPA за последние две недели, от худшего к лучшему

Ограничения

Сервер только читает данные, для запуска или остановки рекламы нужен другой инструмент. Нужны client_id и client_secret OAuth-приложения VK Реклама с доступом к своему кабинету. Проект небольшой, без готовых релизов на PyPI по данным репозитория.

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

MCP

Транспорт
stdio
Авторизация
API-ключ
Переменные окружения
Переменные окружения
client_id
обязательная, секрет
Client ID OAuth-приложения VK Реклама.
client_secret
обязательная, секрет
Client secret OAuth-приложения VK Реклама.

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

  • Ходит в рекламный кабинет с деньгами клиента, хотя только читает данные
  • Токен приложения может иметь более широкие права, чем использует сервер

Коротко о README

README описывает сервер как MCP-обертку над новым кабинетом ads.vk.com, только для чтения и своего кабинета. Перечислены восемь инструментов: списки кампаний, групп и баннеров, статистика с автоматическим разбиением больших периодов, топ объектов, описание полей, экспорт в CSV и остаток квоты API. Отдельно описаны ресурсы со справочником метрик и иерархией объектов, а также промпт campaign_analysis по схеме анализ, ранжирование, рекомендации.

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

Может ли сервер случайно изменить кампанию?

Нет, README прямо говорит: только чтение, сервер ничего не создает и не меняет.

Какой движок использует VK Реклама под капотом?

По словам автора, тот же, что и myTarget: ad_plans, ad_groups и banners это общий словарь объектов нового кабинета ads.vk.com.

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

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

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

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

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

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

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

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

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

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