MCP-сервер Яндекс Директа только на чтение
yandex-direct-mcp-server
Однофайловый MCP-сервер для API Яндекс Директа только на чтение, с проверкой конфигурации на /healthz
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Сервер по собственному описанию в коде читает данные Директа и не выполняет изменяющих запросов
Установка
Ручная установка
node server.jsПеременные окружения DIRECT_OAUTH_TOKEN и опционально DIRECT_CLIENT_LOGIN нужно задать до запуска.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер на Node.js весь помещен в один файл server.js намеренно, чтобы его было проще править прямо в веб-интерфейсе GitHub. По собственному комментарию автора, архитектура повторяет его же yandex-metrika-mcp-server: Express и потоковый HTTP-транспорт, секрет в пути URL, эндпоинт /healthz всегда отвечает 200 и перечисляет проблемы конфигурации. Сервер только читает данные Директа, отслеживает баллы API из заголовка Units и умеет опрашивать готовность офлайн-отчетов с ограничением по времени ожидания.
Для кого. Для маркетологов, которым нужен безопасный, только читающий доступ агента к статистике и структуре кампаний Яндекс Директа.
Подходит, если
- Нужен только просмотр кампаний, объявлений и отчетов Директа без риска что-то изменить
- Нужен простой однофайловый сервер, который легко читать и допиливать
Не подходит, если
- Нужно управлять ставками, останавливать или создавать кампании: сервер только читает
- Нужна готовая документация: README в репозитории нет, комментарии в коде на русском заменяют его частично
Пример запроса к агенту
Покажи статистику по кампаниям Яндекс Директа за прошлую неделюОграничения
В репозитории нет README. Проект у одного автора, без звезд. Нужен OAuth-токен Яндекс Директа, для агентских аккаунтов дополнительно логин клиента.
Как отключить. Остановите процесс сервера и удалите его из конфигурации MCP-клиента.
MCP
- Транспорт
- http, stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| DIRECT_OAUTH_TOKEN обязательная, секрет | OAuth-токен Яндекс Директа |
| DIRECT_CLIENT_LOGIN | Логин клиента, нужен, если токен выпущен на агентский аккаунт |
Проверка безопасности
- Сервер по собственному описанию в коде читает данные Директа и не выполняет изменяющих запросов
Коротко о README
README в репозитории отсутствует. Все объяснения даны в комментариях на русском в начале server.js: назначение сервера, причина однофайловой структуры, ссылка на архитектуру сестринского проекта yandex-metrika-mcp-server, переменные окружения DIRECT_API_BASE_URL, DIRECT_API_VERSION, DIRECT_OAUTH_TOKEN и DIRECT_CLIENT_LOGIN.
Частые вопросы
Может сервер менять ставки или останавливать кампании?
Нет, комментарий в начале файла server.js прямо говорит, что сервер только для чтения.
Похожие
Скиллы DataLens
DataLens Skills
Официальные скиллы DataLens (Яндекс) для Claude Code, Codex и OpenCode: SDK, HTML-отчеты и разбор прав RLS
MCP Яндекс Метрики со всеми 108 методами API
Yandex Metrika MCP Server
MCP-сервер Яндекс Метрики, порожденный из спеки API: 108 методов, по умолчанию 10 инструментов, прозрачные фильтры и метаданные ответа
Открытый MCP-сервер и набор агентских скиллов для SEO: keyword research, конкуренты, обратные ссылки и аудит сайта по данным DataForSEO
Плагин Claude Code для SEO-аудита: технический SEO, E-E-A-T, schema, локальный и AI-поиск силами параллельных агентов