Защищенный MCP для VK Рекламы
vk-ads-mcp
Hardened-форк MCP для VK Рекламы: read-only по умолчанию, мутации только через VK_ADS_ENABLE_WRITES, защита от SSRF при загрузке файлов
- 0 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- При включении VK_ADS_ENABLE_WRITES может создавать, менять и удалять кампании и тратить рекламный бюджет
- Загрузка файлов в кампании обращается к внешним адресам, хотя и с защитой от SSRF
Установка
- Работает в
- Сервисы
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/nikolaymokh-dev-vk-ads-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- При включении VK_ADS_ENABLE_WRITES может создавать, менять и удалять кампании и тратить рекламный бюджет
- Загрузка файлов в кампании обращается к внешним адресам, хотя и с защитой от SSRF
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер управляет рекламными кампаниями VK Рекламы (myTarget API v2): 24 инструмента для чтения планов, кампаний, групп объявлений, баннеров, статистики, ремаркетинга и справочников доступны всегда, а 31 мутирующий инструмент для создания, изменения и удаления объектов, загрузки файлов и трат бюджета скрыт из списка инструментов, пока явно не задана переменная VK_ADS_ENABLE_WRITES=true. Это форк lexamarketolog/vk-ads-mcp, который добавляет поверх исходных инструментов слой защиты: блокировку загрузки файлов с непубличных адресов и по локальным путям с защитой от path-traversal, блокировку адреса API на ads.vk.com и защиту пользовательских значений, попадающих в URL. Установка через uvx с закрепленным тегом версии и uv.lock.
Для кого. Для маркетологов и агентств, которые хотят дать агенту доступ к VK Рекламе, но с гарантией, что он не потратит бюджет без явного включения записи.
Подходит, если
- Нужен доступ к статистике и структуре кампаний VK Рекламы только на чтение по умолчанию
- Нужна защита от SSRF и path-traversal при загрузке изображений и видео в кампании
- Важна воспроизводимая установка по закрепленному тегу версии, а не по ветке main
Не подходит, если
- Нужен сразу полный доступ на запись без отдельного шага включения: понадобится VK_ADS_ENABLE_WRITES=true
- Нужна не VK Реклама, а обычный VK.com: у сервера нет инструментов для постов или сообщества
Пример запроса к агенту
Покажи статистику моих кампаний VK Рекламы за неделю, ничего не меняя в кабинетеMCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
VK_ADS_CLIENT_IDобязательная- Client ID приложения VK Рекламы.
VK_ADS_CLIENT_SECRETобязательная, секрет- Client secret приложения VK Рекламы.
VK_ADS_ENABLE_WRITES- Включает 31 мутирующий инструмент, по умолчанию выключено.
Ограничения
Проект молодой, версия 0.1.1 и статус alpha по классификаторам PyPI. Термины API используют устаревшие названия myTarget, которые не совпадают с интерфейсом нового кабинета ads.vk.com, README дает таблицу соответствий. У каждого партнера должны быть свои API-ключи VK Рекламы. Форк добавляет защиту, но не меняет поведение самих инструментов lexamarketolog/vk-ads-mcp.
Как отключить. Удалите сервер из конфигурации MCP клиента, например claude mcp remove vk-ads.
Частые вопросы
Может ли агент сразу менять кампании?
Нет, 31 мутирующий инструмент скрыт из списка, пока не задана переменная VK_ADS_ENABLE_WRITES=true.
Чем этот сервер отличается от оригинала lexamarketolog/vk-ads-mcp?
README перечисляет добавленное: read-only по умолчанию, защиту загрузки файлов от SSRF, блокировку адреса API и защиту от path-traversal, не меняя сами инструменты.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ВКонтакте — все инструментыMCP-сервер VK Ads поверх myTarget API v2
vk-ads-mcp
MCP-сервер для VK Ads на базе myTarget API v2 с 49-55 инструментами: кампании, ремаркетинг, look-alike, товарные фиды и агентский доступ
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 API
full-vk-mcp
MCP-сервер, автогенерируемый из схемы VK API: больше 180 инструментов с фильтрами по режиму чтение, запись, деньги и по разделам API
MCP-сервер VK API для бизнеса: магазин сообщества, посты, реклама, статистика, диалоги и лид-формы с подтверждением записи
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Защищенный MCP для VK Рекламы (эта карточка) | нет | API-ключ | 0 | |
| MCP-сервер VK Реклама, только чтение | нет | API-ключ | 1 | только чтение статистики и структуры |
| MCP VK Реклама, все в одном | нет | API-ключ | 0 | 136 инструментов |
Коротко о README
README на русском объясняет, что это hardened-форк оригинального сервера для VK Рекламы, дает таблицу соответствий устаревшей терминологии myTarget новому кабинету, инструкции установки для Claude Code и других MCP-клиентов через uvx с закрепленным тегом, отдельный шаг включения мутирующих инструментов через VK_ADS_ENABLE_WRITES и список добавленных фортом мер безопасности со ссылками на docs/SETUP.md и docs/SECURITY.md.