MCP для Яндекс Директа с политиками запуска
yamcp (Yandex Direct MCP Server)
MCP-сервер Яндекс Директа для агентств: отчеты, аудит кампаний и безопасное создание кампаний по зафиксированным бизнес-политикам
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Создает новые рекламные кампании с реальным бюджетом клиента
- OAuth-токен агентства дает доступ к реальным данным и действиям в Яндекс Директе
Установка
Ручная установка
claude mcp add --scope user --transport stdio --env "YD_TOKEN=$YD_TOKEN" --env "YD_MODE=report" yandex-direct -- /absolute/path/to/yamcp/.venv/bin/python -m yadirect_mcpТребует предварительной установки в виртуальное окружение Python 3.11.
Проверка безопасности
Как мы проверяемВысокий рискВысокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
- Создает новые рекламные кампании с реальным бюджетом клиента
- OAuth-токен агентства дает доступ к реальным данным и действиям в Яндекс Директе
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер работает в двух режимах через переменную YD_MODE. Режим report дает офлайн-отчеты Яндекс Директа с асинхронным ожиданием и экономией контекста: полная выгрузка сохраняется в TSV-файл, а модели возвращается только превью строк. Режим campaign_setup позволяет собрать и записать новую рекламную кампанию по одной из именованных policy: для услуг B2B, локального бизнеса или e-commerce, отдельно для новых и уже работающих аккаунтов. Политика фиксирует бюджет, разметку UTM, профиль измерения и то, какая стратегия выбирается при наличии или отсутствии истории. Перед записью MCP-клиент запрашивает согласие через elicitation на конкретный SHA-256 план, а после записи сервер сверяет фактические бюджеты и настройки созданных кампаний с планом.
Для кого. Для агентств и подрядчиков, которые ведут несколько клиентских аккаунтов Яндекс Директа и хотят запускать кампании по единым зафиксированным правилам.
Подходит, если
- Нужны регулярные офлайн-отчеты по клиентским аккаунтам без раздувания контекста модели
- Нужно запускать новые кампании по единой согласованной политике бюджета и разметки
- Нужен аудит существующих кампаний на соответствие профилю бизнеса
Не подходит, если
- Нужна ЕПК, медийная или мобильная кампания: сервер их не создает
- Нужно редактировать или удалять уже существующие объекты: сервер их только читает
- Нужен удаленный HTTP-доступ: сервер работает только по локальному stdio
Пример запроса к агенту
Собери план кампании Поиск плюс РСЯ для нового локального бизнеса с общим бюджетом 30000 рублей в месяц и покажи план перед записьюMCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
YD_TOKENобязательная, секрет- OAuth-токен с доступом к API Яндекс Директа
YD_MODE- Режим сервера: report или campaign_setup, по умолчанию report
YD_ALLOWED_LOGINS- Список разрешенных клиентских логинов через запятую
YD_OUT_DIR- Каталог для полных TSV-отчетов
Ограничения
Не редактирует и не удаляет существующие кампании, группы, объявления и ключевые фразы: корректировки ставок и ретаргетинг читаются, но не задаются. Не создает ЕПК, медийные и мобильные кампании. Нет доступа к Яндекс Метрике напрямую: нужен отдельный токен с правом metrika:read. Это не официальный продукт Яндекса. Тестовая среда с июля 2026 отключена, поэтому отладка возможна только на выделенной черновой кампании.
Как отключить. Выполните claude mcp remove yandex-direct в Claude Code или удалите сервер из конфигурации вашего MCP-клиента.
Частые вопросы
Может ли сервер сам запустить кампанию?
Нет, запись кампании требует подтверждения через elicitation на стороне MCP-клиента, а запущенной она становится только после ручного включения в интерфейсе Директа после модерации.
Нужен ли отдельный токен для Метрики?
Да, токен Директа доступа к API Метрики не дает, нужен отдельный токен с правом metrika:read, а конверсии по целям при этом доступны через direct_report с параметром goals.
Похожие
MCP-серверыСкилл, который убирает из текста приметы ИИ-письма по списку Википедии и не добавляет выдуманных фактов
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 читающих, запись включается явно
Коротко о README
README подробно фиксирует историю изменений политик запуска кампаний по датам, таблицу переменных окружения, установку на Windows и Linux и подключение к Claude Code, OpenAI Codex, Hermes Agent и ZCode. Отдельно описаны технические решения: стабильные имена отчетов, ожидание Reports API, экономия контекста модели через превью строк и полный список ограничений и диагностики частых ошибок.