MCP для Яндекс Директа с 80 инструментами

Установка

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

git clone https://github.com/gmen1057/yandex-direct-mcp.git
cd yandex-direct-mcp
npm install
cp .env.example .env
npm run smoke

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

Что делает

Сервер публикует около 80 инструментов для API Яндекс Директа v5: чтение кампаний, групп, ключевых слов, объявлений, минус-слов и исключенных площадок, отчеты со статистикой по расходу, кликам и CTR с разбивкой и поисковыми запросами, а также запись, включая бюджет, паузу и возобновление, ставки, автотаргетинг, стратегию max-conv, тексты и изображения объявлений и пакетный запуск кампании от группы до модерации. Есть escape-инструмент direct_rpc для вызова любого метода API. Все пишущие вызовы требуют явного флага allow_write и привязки к проекту из projects.json, чтобы не задеть чужой бренд на общем токене, и по умолчанию отдают только dry-run план.

Для кого. Для агентств и специалистов по контекстной рекламе, которые ведут несколько брендов на одном токене Яндекс Директа.

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

Покажи отчет по кампаниям проекта shop за неделю и предложи, какие минус-слова добавить

Ограничения

Один OAuth-токен открывает весь рекламный кабинет, изоляция брендов держится на дисциплине заполнения projects.json, а не на правах API. Нет пакета в npm, установка из исходников. Автор прямо пишет, что проект не аффилирован с Яндексом. Суммы в API считаются в микросах, инструменты работают в рублях, а связка DailyBudget и WeeklySpendLimit в одном вызове дает ошибку 4004.

Как отключить. Удалите сервер из конфигурации MCP клиента и отзовите OAuth-токен Яндекс Директа в oauth.yandex.ru.

MCP

Транспорт

stdio

Авторизация

API-ключ

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

• Пишущие инструменты меняют бюджет, ставки, статус кампаний и тексты объявлений
• Escape-инструмент direct_rpc вызывает любой метод API без дополнительных ограничений
• Один OAuth-токен дает доступ ко всему рекламному кабинету со всеми брендами

Коротко о README

README на русском описывает сервер как сделанный в проде AI-студии Arckep, с быстрым стартом через npm install и npm run smoke, примерами конфигурации для Claude Desktop, Claude Code и Cursor в папке examples и инструкцией AGENTS.md для самостоятельной установки агентом. Отдельно описаны правила безопасности write, формат projects.json для разметки брендов и список особенностей API Директа: микросы, лимит 4004, модерация по словам в заголовках, точность int64 для Ad Id. Лицензия MIT, автор указывает на отсутствие аффилиации с Яндексом.

Похожие