SkillFoxx
Telegram

Штурман: MCP Директа с красной линией

Shturman Direct MCP

12 инструментов Яндекс Директа без зависимостей: план и подтверждение вместо прямой записи, а запуск и удаление кампаний не реализованы вовсе

  • 0 ★ репозитория
  • Последний коммит
  • MIT
MCP-серверВыбор редакции

Широкий доступ

Почему такой уровень

  • direct_apply реально меняет боевой аккаунт с настоящими деньгами
  • Создает гео-сегменты Аудиторий и цели Метрики, влияющие на будущие кампании
Все причины и проверки
Российский стек

seer22/shturman-direct-mcpАвтор:seer22

Установка

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

git clone https://github.com/seer22/shturman-direct-mcp.git

Zero dependencies: только стандартная библиотека Python 3.11+, без npm install или pip install.

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • direct_apply реально меняет боевой аккаунт с настоящими деньгами
  • Создает гео-сегменты Аудиторий и цели Метрики, влияющие на будущие кампании

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

Что делает

Сервер на чистой стандартной библиотеке Python дает всего 12 инструментов вместо привычных для этой ниши 111-155: статус конфигурации, чтение с проверкой цены запроса в единицах API до вызова, планирование изменения с возвратом только идентификатора, применение плана по этому идентификатору с обязательной подтверждающей фразой, отчеты, локальный аудит по 14 пунктам официального чек-листа Директа, прикрепление медиа к объявлению, Вордстат через API Yandex Cloud, чтение Метрики и создание недостающих целей, чтение и создание гео-сегментов Аудиторий. Одиннадцать методов (запуск и снятие с паузы кампаний, групп, объявлений и ключевых слов, разархивация, удаление) сервер принципиально не реализует: не за флагом, а вообще. Каждая запись идет в два шага: direct_plan описывает изменение и ничего не отправляет, direct_apply выполняет план только по идентификатору с точной подтверждающей фразой и обязательным read-back после.

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

Подходит, если

  • Нужен локальный аудит аккаунта по официальному чек-листу Директа с указанием источника каждой проверки
  • Нужно создать гео-сегмент Аудиторий по кругам или подтянуть Вордстат перед планированием кампании
  • Нужна защита от необратимых действий встроенная в сам сервер, а не только в клиента

Не подходит, если

  • Нужно возобновлять остановленные кампании, объявления или ключевые слова через MCP: этого метода в сервере нет и не будет
  • Нужно удалять или разархивировать объекты через агента: тоже отсутствует принципиально
  • Нужен широкий охват API v5 в одном сервере: здесь всего 12 инструментов, а не сотня с лишним

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

Прогони официальный чек-лист аудита по моему аккаунту и покажи, какие проверки он не делает

MCP

Транспорт
stdio
Авторизация
API-ключ

Переменные окружения

YANDEX_DIRECT_TOKEN обязательная, секрет
OAuth-токен Яндекс Директа

Ограничения

Тестовой среды у Яндекс Директа больше нет с июля 2026, любая запись идет по боевому аккаунту с реальными деньгами. Одиннадцать методов из красной линии (resume, unarchive, delete для кампаний, групп, объявлений и ключевых слов) не реализованы принципиально, добавить их через настройку нельзя. План живет один час, устаревший план отклоняется и требует нового.

Как отключить. Удалите блок yandex-direct из конфигурации MCP клиента и остановите процесс сервера.

Частые вопросы

Может ли сервер запустить остановленную кампанию?

Нет, resume, unarchive и delete для кампаний, групп, объявлений и ключевых слов не реализованы принципиально, это часть красной линии, а не настройки.

Что мешает модели случайно применить план?

direct_apply принимает только идентификатор плана и требует точную подтверждающую фразу целиком, а обязательный read-back проверяет реальный результат после вызова, ведь зеленый ответ API здесь ничего не доказывает.

Обсуждение

Вопросов и отзывов пока нет.

Яндекс Директ — все инструменты
Российский стек

MCP-сервер на Python с 48 инструментами Яндекс Директа и частотностью Вордстата, с переключением между песочницей и боевым режимом

MCP-серверШирокий доступ1
Российский стек

MCP-сервер для Яндекс Директа, Метрики, Аудиторий и Wordstat с режимом только чтения и подтверждением изменений

MCP-серверШирокий доступ50
Российский стек

Форк популярного MCP-сервера Яндекс Директа с чтением по умолчанию и явными флагами для записи и финансов

MCP-серверШирокий доступ
Российский стек

20 инструментов Яндекс Директа, где каждая правка по умолчанию только показывает план запроса и требует confirm=True для реальной отправки

MCP-серверШирокий доступ
Российский стек

MCP-сервер Direct API v5 одним файлом на Node.js без зависимостей, с инструментом direct_call на все сервисы API и режимом только для чтения

MCP-серверШирокий доступ

Коротко о README

README объясняет, зачем еще один сервер для Директа: 36 задокументированных случаев, когда API отвечает success, но делает другое, посчитанная заранее цена ошибки в единицах API и осознанный отказ от resume, unarchive и delete как красной линии, со ссылкой на то, что официальный Google Ads MCP вообще не пишет, а Meta создает кампании только на паузе. Дает таблицу из 12 инструментов и 14 ресурсов знаний, раздел о двухфазной записи с часовым временем жизни плана и раздел о том, что именно попадает на диск в виде кассет для отладки.

Бейдж для README

Сообщить о проблеме