MCP-сервер VK Ads поверх myTarget API v2
vk-ads-mcp
MCP-сервер для VK Ads на базе myTarget API v2 с 49-55 инструментами: кампании, ремаркетинг, look-alike, товарные фиды и агентский доступ
- 3 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Создает и меняет реальные кампании, группы и объявления без песочницы
- Загружает списки пользователей по email и телефонам для аудиторий ремаркетинга
Установка
- Работает в
- Сервисы
Ручная установка
git clone https://github.com/lexamarketolog/vk-ads-mcp.git && cd vk-ads-mcp && uv syncУстановка из README, ключ задается в .env как VK_ADS_ACCESS_TOKEN.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Создает и меняет реальные кампании, группы и объявления без песочницы
- Загружает списки пользователей по email и телефонам для аудиторий ремаркетинга
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер оборачивает myTarget API v2, на котором технически работает VK Ads, в инструменты для кампаний, групп объявлений, баннеров, загрузки контента, статистики (по дням, сводной, в разбивке по возрасту, полу, региону, площадке, ОС и устройству, включая асинхронные отчеты), групп ремаркетинга, пикселей, списков пользователей по хешированным email и телефонам, look-alike аудиторий, товарных фидов и агентского доступа к клиентским кабинетам. Отдельно объясняет путаницу терминов: то, что в новом интерфейсе ads.vk.com называется «Кампания», в API это ad_plan, а «Группа объявлений» это campaign, и предупреждает, что campaign без ad_plan_id создается, но становится невидимым в новом интерфейсе сиротой.
Для кого. Для разработчиков и агентств, которым нужен более полный набор инструментов VK Ads, чем базовые серверы, включая ремаркетинг и товарные фиды.
Подходит, если
- Нужны ремаркетинг, пиксели и look-alike аудитории, а не только кампании и статистика
- Нужна работа с товарными фидами для динамических объявлений
- Нужен агентский доступ к нескольким клиентским кабинетам через один сервер
Не подходит, если
- Путаница между UI-терминами и API-терминами критична для вас: нужно внимательно читать документацию сервера, иначе легко создать невидимую группу-сироту
- Нужна стабильная версия: README сам называет проект v0.4-dev
Пример запроса к агенту
Создай look-alike аудиторию по списку клиентов и настрой ремаркетинговый пиксель для сайтаMCP
- Транспорт
- stdio
- Авторизация
- ключ необязателен
Переменные окружения
VK_ADS_ACCESS_TOKENсекрет- Готовый токен доступа из личного кабинета ads.vk.com, вариант авторизации A.
VK_ADS_CLIENT_ID- Client id зарегистрированного приложения VK для OAuth2 client credentials, вариант B.
VK_ADS_CLIENT_SECRETсекрет- Client secret для варианта B.
VK_ADS_AGENCY_CLIENT_NAME- Логин клиента для агентского доступа, вариант C.
Ограничения
Проект в статусе v0.4-dev по собственному определению README. Групповая сущность campaign без указания ad_plan_id создается успешно, но становится невидимой в новом интерфейсе ads.vk.com, это явная и легко допустимая ошибка. Три способа авторизации (готовый токен, OAuth2 client credentials, агентский доступ) можно перепутать.
Как отключить. Удалите сервер из конфигурации MCP клиента.
Частые вопросы
Почему группа объявлений пропала из интерфейса?
Вероятно, она создана инструментом campaign без ad_plan_id и стала сиротой, README советует всегда создавать через create_ad_plan с вложенным списком campaigns.
Какой способ авторизации проще всего?
Готовый access token из личного кабинета ads.vk.com, Настройки профиля, API: вариант A в README, не требует регистрации приложения.
Чем MCP VK Ads отличается от других серверов для VK Ads?
Сервер построен на myTarget API v2, на котором технически работает VK Ads, и дает 49–55 инструментов: кампании, группы объявлений, баннеры, загрузка контента, статистика, ремаркетинг, look-alike, товарные фиды, агентский доступ.
Почему группа объявлений пропала из интерфейса и какая авторизация проще?
Группы, удаленные через API, могут не показываться в интерфейсе, проверьте статус через инструмент статистики. Проще начать с токена клиента, остальные способы описаны в README. Установка: git clone, запуск по инструкции. Работает в Claude Desktop, Claude Code и Cursor. Риск высокий.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ВКонтакте — все инструментыMCP-сервер VK Реклама
VK Реклама MCP
MCP-сервер для VK Рекламы: кампании, группы, объявления, статистика и баланс через диалог, подключение кабинета без ручного OAuth
MCP-сервер VK Реклама, только чтение
vk-ads-mcp
MCP-сервер для VK Реклама только на чтение: статистика, структура кампаний, топ объектов по метрикам и выгрузка в CSV
MCP VK Реклама, все в одном
VK Ads MCP All in One
MCP-сервер для VK Реклама с установщиком под ключ: 136 инструментов, поиск сообществ VK и навык для нескольких агентов сразу
Защищенный MCP для VK Рекламы
vk-ads-mcp
Hardened-форк MCP для VK Рекламы: read-only по умолчанию, мутации только через VK_ADS_ENABLE_WRITES, защита от SSRF при загрузке файлов
MCP-сервер VK API для бизнеса: магазин сообщества, посты, реклама, статистика, диалоги и лид-формы с подтверждением записи
Скилл сборки и запуска кампаний VK Реклама
vk-ads-manager
Скилл, который проводит агента через весь путь запуска кампании VK Реклама: от конкурентов и аудиторий до объявлений и структуры в кабинете на паузе
Коротко о README
README на английском отдельным разделом разбирает несовпадение терминов UI и API VK Ads с таблицей соответствий и явным предупреждением про группы-сироты, дает статус v0.4-dev с числом инструментов и тестов, три способа получения токена и полный список инструментов по темам: кампании, группы, баннеры, контент, статистика, ремаркетинг, пиксели, списки пользователей, look-alike, товарные фиды, агентский доступ.