MCP Яндекс Директа с dry-run по умолчанию

Установка

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

{
  "mcpServers": {
    "yandex-direct": {
      "command": "python",
      "args": ["/абсолютный/путь/src/server.py"],
      "env": { "YD_TOKEN": "ваш_токен", "YDIRECT_ENV": "sandbox" }
    }
  }
}

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

Что делает

Сервер дает 20 инструментов Direct API v5, разделенных на две группы. Шесть читающих работают без подтверждения: кампании, группы, объявления, ключевые слова, баланс и универсальный отчет с ожиданием асинхронного результата. Остальные (создание и изменение кампаний, пауза и возобновление, архивация, работа с группами, объявлениями, ключевыми словами и массовыми ставками) защищены dry-run: по умолчанию confirm=False, и вызов лишь показывает план запроса, а реальная отправка требует явного confirm=True. Сервер сам переводит суммы из микроединиц и обратно и опрашивает асинхронный Reports API до готовности отчета.

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

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

Покажи кампании с расходом за неделю, найди ключи с CTR ниже 2% и предложи, какие ставки снизить

Ограничения

Каждая правка требует двух вызовов: сначала без confirm для проверки плана, потом с confirm=True для реальной отправки, что удлиняет сценарий. Один флаг YDIRECT_ENV переключает песочницу и боевой режим. Это не официальный продукт Яндекса, транспорт только stdio.

Как отключить. Удалите блок yandex-direct из конфигурации клиента Claude Desktop или Claude Code.

MCP

Транспорт

stdio

Авторизация

API-ключ

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

• После confirm=True реально создает, ставит на паузу и архивирует кампании
• Массово меняет ставки ключевых слов реальными деньгами

Коротко о README

README подает проект как инженерную демонстрацию безопасного агентного интерфейса к деньгам: архитектурная схема с dry-run guard, конвертацией микроединиц и асинхронным опросом отчетов, таблица из 20 инструментов, разделенная на чтение и запись с dry-run, и раздел про переключение песочницы и боевого режима флагом YDIRECT_ENV.

Похожие