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

Установка

Работает в

• Claude Code
• Claude Desktop
• SourceCraft
• Koda
• Coddy

Сервисы

• Яндекс Директ

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

{
  "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% и предложи, какие ставки снизить

MCP

Транспорт

stdio

Авторизация

API-ключ

Ограничения

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

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

Коротко о README

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