Штурман: MCP Директа с красной линией
Shturman Direct MCP
12 инструментов Яндекс Директа без зависимостей: план и подтверждение вместо прямой записи, а запуск и удаление кампаний не реализованы вовсе
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- direct_apply реально меняет боевой аккаунт с настоящими деньгами
- Создает гео-сегменты Аудиторий и цели Метрики, влияющие на будущие кампании
Установка
Ручная установка
git clone https://github.com/seer22/shturman-direct-mcp.gitZero dependencies: только стандартная библиотека Python 3.11+, без npm install или pip install.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер на чистой стандартной библиотеке Python дает всего 12 инструментов вместо привычных для этой ниши 111-155: статус конфигурации, чтение с проверкой цены запроса в единицах API до вызова, планирование изменения с возвратом только идентификатора, применение плана по этому идентификатору с обязательной подтверждающей фразой, отчеты, локальный аудит по 14 пунктам официального чек-листа Директа, прикрепление медиа к объявлению, Вордстат через API Yandex Cloud, чтение Метрики и создание недостающих целей, чтение и создание гео-сегментов Аудиторий. Одиннадцать методов (запуск и снятие с паузы кампаний, групп, объявлений и ключевых слов, разархивация, удаление) сервер принципиально не реализует: не за флагом, а вообще. Каждая запись идет в два шага: direct_plan описывает изменение и ничего не отправляет, direct_apply выполняет план только по идентификатору с точной подтверждающей фразой и обязательным read-back после.
Для кого. Для тех, кто хочет управлять статистикой, отчетами и осторожными правками Яндекс Директа через агента, но не готов доверить ему запуск показов или удаление кампаний.
Подходит, если
- Нужен локальный аудит аккаунта по официальному чек-листу Директа с указанием источника каждой проверки
- Нужно создать гео-сегмент Аудиторий по кругам или подтянуть Вордстат перед планированием кампании
- Нужна защита от необратимых действий встроенная в сам сервер, а не только в клиента
Не подходит, если
- Нужно возобновлять остановленные кампании, объявления или ключевые слова через MCP: этого метода в сервере нет и не будет
- Нужно удалять или разархивировать объекты через агента: тоже отсутствует принципиально
- Нужен широкий охват API v5 в одном сервере: здесь всего 12 инструментов, а не сотня с лишним
Пример запроса к агенту
Прогони официальный чек-лист аудита по моему аккаунту и покажи, какие проверки он не делаетОграничения
Тестовой среды у Яндекс Директа больше нет с июля 2026, любая запись идет по боевому аккаунту с реальными деньгами. Одиннадцать методов из красной линии (resume, unarchive, delete для кампаний, групп, объявлений и ключевых слов) не реализованы принципиально, добавить их через настройку нельзя. План живет один час, устаревший план отклоняется и требует нового.
Как отключить. Удалите блок yandex-direct из конфигурации MCP клиента и остановите процесс сервера.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| YANDEX_DIRECT_TOKEN обязательная, секрет | OAuth-токен Яндекс Директа |
Проверка безопасности
- direct_apply реально меняет боевой аккаунт с настоящими деньгами
- Создает гео-сегменты Аудиторий и цели Метрики, влияющие на будущие кампании
Коротко о README
README объясняет, зачем еще один сервер для Директа: 36 задокументированных случаев, когда API отвечает success, но делает другое, посчитанная заранее цена ошибки в единицах API и осознанный отказ от resume, unarchive и delete как красной линии, со ссылкой на то, что официальный Google Ads MCP вообще не пишет, а Meta создает кампании только на паузе. Дает таблицу из 12 инструментов и 14 ресурсов знаний, раздел о двухфазной записи с часовым временем жизни плана и раздел о том, что именно попадает на диск в виде кассет для отладки.
Частые вопросы
Может ли сервер запустить остановленную кампанию?
Нет, resume, unarchive и delete для кампаний, групп, объявлений и ключевых слов не реализованы принципиально, это часть красной линии, а не настройки.
Что мешает модели случайно применить план?
direct_apply принимает только идентификатор плана и требует точную подтверждающую фразу целиком, а обязательный read-back проверяет реальный результат после вызова, ведь зеленый ответ API здесь ничего не доказывает.
Похожие
Скилл, который убирает из текста приметы ИИ-письма по списку Википедии и не добавляет выдуманных фактов
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 читающих, запись включается явно