SkillFoxx
Telegram

MCP Яндекс Директа из машиночитаемой схемы

yandex-direct-mcp

MCP-сервер и CLI на всех 113 методах API v5 Яндекс Директа, собранных из WSDL: по умолчанию только 9 читающих, запись включается явно

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

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

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

  • После включения DIRECT_ALLOW_WRITES открывает 80 меняющих и 16 удаляющих методов Директа
  • Удаление и архивация в Директе необратимы, а на другом конце операций реальные деньги
Все причины и проверки
Российский стек

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

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/artgas1-yandex-direct-mcp

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

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

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

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

  • После включения DIRECT_ALLOW_WRITES открывает 80 меняющих и 16 удаляющих методов Директа
  • Удаление и архивация в Директе необратимы, а на другом конце операций реальные деньги

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

Что делает

Сервер и командная строка покрывают все 113 методов Direct API v5, а не подмножество: полный список из 30 служб, 113 методов, 609 типов и 240 перечислений собран автоматически из WSDL 29 служб и официальной документации, а не описан вручную. Чтобы не раздувать контекст модели на каждом ходу, по умолчанию объявляется профиль core из девяти читающих инструментов, а полный набор из 117 доступен через DIRECT_ALLOW_WRITES=1. Из 113 методов 80 меняют данные и 16 удаляют, и меняющие инструменты вообще не объявляются модели, пока запись не включена явно: контекст за них не платится, если вызвать их все равно нельзя. Сервер решает целый список типичных ловушек живого API: суммы переводятся из микроединиц, 19-значные идентификаторы не режутся, HTTP 200 с телом error не считается успехом, а предупреждения Директа не путаются с отказами.

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

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

  • Нужен весь API v5, а не только частые методы вроде кампаний и объявлений
  • Важно не раздувать контекст модели десятками ненужных инструментов
  • Нужна уверенность, что суммы, идентификаторы и статус ответа разобраны без скрытых ошибок

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

  • Нужно, чтобы запись работала сразу без отдельной настройки: она выключена по умолчанию
  • Нужны только несколько типовых операций: полная поверхность и профили здесь избыточны
  • Нужна служба reports без явной настройки: WSDL для нее Директ не отдает, описана вручную

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

Покажи полный список методов Direct API и объясни, какие из них сейчас скрыты и почему

MCP

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

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

YANDEX_DIRECT_TOKEN обязательная, секрет
OAuth-токен со scope direct:api
DIRECT_ALLOW_WRITES
Объявляет меняющие данные инструменты, выключено по умолчанию
DIRECT_PROFILE
core, read или all, по умолчанию core
DIRECT_SANDBOX
Переключает на песочницу вместо боевого кабинета

Ограничения

Меняющие данные инструменты не объявляются модели, пока не задана DIRECT_ALLOW_WRITES=1: если ожидается запись сразу после установки, нужно явно ее включить. Перечисления из схемы могут отставать от живого API и используются как подсказка, а не жесткий фильтр. Нужен OAuth-токен со scope direct:api, для песочницы нужны отдельная регистрация и отдельный токен.

Как отключить. Выполните claude mcp remove yandex-direct в Claude Code или удалите блок yandex-direct из конфигурации клиента.

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

Почему по умолчанию видно только 9 инструментов из 113 методов?

Описания всех объявленных инструментов лежат в контексте модели на каждом ходу, поэтому по умолчанию объявляется профиль core с частыми читающими методами, а не все, что умеет API.

Как включить методы, которые меняют данные?

Задать переменную DIRECT_ALLOW_WRITES=1, иначе меняющие инструменты вообще не объявляются модели.

Обсуждение

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

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

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

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

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

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

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

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

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

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

MCP-сервер от ZAI.ONE сводит Директ, Метрику, поиск, Wordstat и Вебмастер в одном агенте, с мастером настройки и включаемыми пишущими операциями

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

Коротко о README

README подробно разбирает восемь молчаливых ловушек живого API Директа с примерами: суммы в микроединицах, потеря точности ID, HTTP 200 с ошибкой в теле, задержка отчета, версия пути v501 против v5, неполный список кампаний, предупреждение как примененное изменение. Дает таблицу покрытия по профилям с числом байт и примерным числом токенов, таблицу настроек, источник происхождения каждого метода из WSDL и документации и отдельный вариант установки как скилла через npx skills add.

Бейдж для README

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