MCP-сервер Яндекс Директа на Ruby

yandex-direct-mcp

MCP-сервер на чистом Ruby без зависимостей: 30 инструментов для кампаний, групп, объявлений, ключевых слов и отчетов Яндекс Директа

MCP-серверРоссийский стек

vtka/yandex-direct-mcpАвтор:vtka

Установка

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

{
  "mcpServers": {
    "yandex-direct": {
      "command": "ruby",
      "args": ["/path/to/yandex-direct-mcp/bin/server"],
      "env": {
        "YANDEX_DIRECT_TOKEN": "your_oauth_token"
      }
    }
  }
}

Добавить в .mcp.json проекта или в глобальный ~/.claude.json.

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

Что делает

Сервер оборачивает API v5 Яндекс Директа в 30 инструментов MCP, разбитых на шесть групп: кампании (создание, изменение, архивация, приостановка), группы объявлений с гео-таргетингом и минус-словами, текстово-графические объявления с модерацией, ключевые слова и ставки, отчеты по кампаниям и поисковым запросам, справочники регионов, валют и интересов аудитории. Сервер написан на чистом Ruby без внешних зависимостей и запускается локальным процессом через stdio. Есть песочный режим на переменной YANDEX_DIRECT_SANDBOX для тестов без реальных трат.

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

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

Нужно создавать и редактировать кампании, группы и объявления командами на естественном языке
Нужен единый MCP без внешних зависимостей, только Ruby на машине
Нужно протестировать сценарии на песочнице перед реальными тратами

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

Кампании созданы через упрощенный мастер (SMB): такие кампании API не видит
Нужна загрузка локальных изображений напрямую: сервер принимает только URL или base64

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

Создай кампанию в Яндекс Директе на продвижение книги с бюджетом 500 рублей в день

Ограничения

Нужен OAuth-токен Яндекс Директа и отдельная заявка на полный доступ к API через раздел Инструменты, без нее API возвращает ошибку 58 о незавершенной регистрации. Быстрые ссылки можно создать через API, но привязать их к объявлению только через веб-интерфейс. Для текстово-графических объявлений нужно горизонтальное изображение не менее 1080x607. Требуется установленный Ruby, готового npm или docker-пакета нет.

Как отключить. Удалите блок yandex-direct из .mcp.json проекта или из глобального ~/.claude.json.

MCP

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

Переменные окружения
Переменные окружения
YANDEX_DIRECT_TOKEN обязательная, секрет	OAuth-токен приложения Яндекс Директа
YANDEX_DIRECT_SANDBOX	Включает тестовый API без реальных трат

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

Создает, изменяет и архивирует реальные рекламные кампании и объявления
Управляет ставками и бюджетом кампаний, ошибка агента приводит к реальным тратам

Коротко о README

README перечисляет 30 инструментов по шести сервисам, шаги получения OAuth-токена и обязательной заявки на доступ к API, конфигурацию для Claude Code и Claude Desktop, ограничения API (SMB-кампании не видны, быстрые ссылки только через интерфейс, требования к изображениям) и песочный режим для тестов. Указана лицензия MIT.

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

Нужны ли внешние библиотеки?

Нет, сервер написан на чистом Ruby без зависимостей, кроме самого Ruby.

Можно потестировать без реальных денег?

Да, песочный режим включается переменной YANDEX_DIRECT_SANDBOX и использует тестовый API Директа.

Скиллы DataLens

DataLens Skills

Официальный

Официальные скиллы DataLens (Яндекс) для Claude Code, Codex и OpenCode: SDK, HTML-отчеты и разбор прав RLS

СкиллСредний рискРоссийский стекБез VPN12

MCP Яндекс Метрики со всеми 108 методами API

Yandex Metrika MCP Server

Выбор редакции

MCP-сервер Яндекс Метрики, порожденный из спеки API: 108 методов, по умолчанию 10 инструментов, прозрачные фильтры и метаданные ответа

MCP-серверСредний рискРоссийский стекБез VPN2

OpenSEO