AdsMCP

Установка

Работает в

• Cursor
• Claude Desktop
• SourceCraft
• Koda
• Coddy

Сервисы

• Яндекс Директ
• Авито
• click.ru
• ВКонтакте

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

npm install && npm run build:mcp

Что делает

AdsMCP собирает рекламные кампании, расход и конверсии в локальную базу SQLite и считает CTR, CPC, CPA и ROAS по каналам. Сервер запускается командой `node` из собранного каталога `dist`, данные лежат в папке `data/`. Подключаются только нужные платформы, остальные модули отключены. По российским площадкам картина такая. Яндекс Директ работает через модуль ZAI.ONE `yandex-mcp`: импорт метрик, правка кампаний, остановка и возобновление, а также отдельный инструмент создания кампании с выключенными показами. Удаление закрыто. Авито Реклама подключена только на чтение через официальный API и локальный список разрешенных инструментов. VK Ads идет через посредника Click.ru и тоже только на чтение. Telegram Ads умеет отчеты, создание объявлений, бюджеты, отправку на модерацию и паузу. Первый запуск требует принять правила бесплатного использования через `ads_free_use_accept` с `confirm=true`. Внешние действия идут сначала пробным прогоном, затем после явного подтверждения. Есть локальная панель для подключения кабинетов, а токен Директа записывается в `ADS_MCP_DATA/secrets/yandex-direct.token` и не попадает в чат.

Для кого. Директологам, маркетологам и владельцам малого бизнеса, которые ведут рекламу в нескольких кабинетах и хотят анализировать расход в чате, а данные держать у себя.

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

Сведи расход и конверсии по Директу и Telegram Ads за неделю, посчитай CPA и покажи, какую кампанию Директа стоит остановить.

MCP

Транспорт

stdio

Авторизация

OAuth

Ограничения

Нужен Node.js 22.5 или новее и клиент MCP со stdio, например Cursor или Claude Desktop. Сборка идет командами `npm install` и `npm run build:mcp`. Рекламные кабинеты и доступы настраиваются отдельно, сам сервер их не создает.

Директом управляют через сторонний модуль ZAI.ONE `yandex-mcp`, для живого импорта нужен токен Яндекса. Для VK Ads требуется ручная первая привязка аккаунта к Click.ru. Платформы вроде Meta, TikTok, Reddit, Spotify и X подключены только на чтение.

Проект раз в сутки проверяет GitHub на новый релиз, а раз в неделю смотрит локальные изменения репозитория. Эти проверки отключают переменные `ADSMCP_UPDATE_ENABLED=false` и `ADSMCP_WEEKLY_PR_ENABLED=false`.

Как отключить. Уберите сервер из конфигурации клиента MCP. Токены кабинетов лежат в `ADS_MCP_DATA/secrets/`, их можно удалить вместе с папкой данных, а доступ приложения отозвать в самих рекламных кабинетах.

Коротко о README

README описан на английском, русская версия лежит в `README.ru.md`. В нем таблица интеграций с готовностью, матрица возможностей по чтению, записи и созданию кампаний, быстрый старт, обновления через GitHub и ссылки на документацию в `docs/`. Лицензия MIT, версия 1.1.1.