MCP-сервер VK Ads поверх myTarget API v2
vk-ads-mcp
MCP-сервер для VK Ads на базе myTarget API v2 с 49-55 инструментами: кампании, ремаркетинг, look-alike, товарные фиды и агентский доступ
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Создает и меняет реальные кампании, группы и объявления без песочницы
- Загружает списки пользователей по email и телефонам для аудиторий ремаркетинга
Установка
Ручная установка
git clone https://github.com/lexamarketolog/vk-ads-mcp.git && cd vk-ads-mcp && uv syncУстановка из README, ключ задается в .env как VK_ADS_ACCESS_TOKEN.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер оборачивает 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 аудиторию по списку клиентов и настрой ремаркетинговый пиксель для сайтаОграничения
Проект в статусе v0.4-dev по собственному определению README. Групповая сущность campaign без указания ad_plan_id создается успешно, но становится невидимой в новом интерфейсе ads.vk.com, это явная и легко допустимая ошибка. Три способа авторизации (готовый токен, OAuth2 client credentials, агентский доступ) можно перепутать.
Как отключить. Удалите сервер из конфигурации MCP клиента.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| 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. |
Проверка безопасности
- Создает и меняет реальные кампании, группы и объявления без песочницы
- Загружает списки пользователей по email и телефонам для аудиторий ремаркетинга
Коротко о README
README на английском отдельным разделом разбирает несовпадение терминов UI и API VK Ads с таблицей соответствий и явным предупреждением про группы-сироты, дает статус v0.4-dev с числом инструментов и тестов, три способа получения токена и полный список инструментов по темам: кампании, группы, баннеры, контент, статистика, ремаркетинг, пиксели, списки пользователей, look-alike, товарные фиды, агентский доступ.
Частые вопросы
Почему группа объявлений пропала из интерфейса?
Вероятно, она создана инструментом campaign без ad_plan_id и стала сиротой, README советует всегда создавать через create_ad_plan с вложенным списком campaigns.
Какой способ авторизации проще всего?
Готовый access token из личного кабинета ads.vk.com, Настройки профиля, API: вариант A в README, не требует регистрации приложения.
Похожие
Скилл, который убирает из текста приметы ИИ-письма по списку Википедии и не добавляет выдуманных фактов
Marketing Skills: маркетинговые скиллы для агентов
Marketing Skills for AI Agents
Около пятидесяти скиллов по CRO, копирайтингу, SEO, аналитике, рекламе и запуску продукта для кодовых агентов
MCP-сервер SendPulse
SendPulse MCP
Официальный удаленный MCP-сервер SendPulse: статистика, рассылки и данные пользователей через чат с агентом
MCP Яндекс Директа из машиночитаемой схемы
yandex-direct-mcp
MCP-сервер и CLI на всех 113 методах API v5 Яндекс Директа, собранных из WSDL: по умолчанию только 9 читающих, запись включается явно