DirectAI MCP: локальный сервер для Яндекс Директа
DirectAI MCP
Локальный MCP-сервер для Windows ведет Яндекс Директ через официальный API: 57 действий чтения и 25 записи с обязательным предпросмотром
- 0 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент может менять ставки, бюджеты, расписание и объявления в боевом кабинете, то есть тратить рекламные деньги
- Токен Директа открывает данные кабинета, хотя каждая запись и требует подтверждения
Установка
- Работает в
- Сервисы
Ручная установка
uv tool install --editable . && directai-mcp initВыполняется в папке клонированного репозитория на Windows 11, дальше `directai-mcp set-token --login <логин>`.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент может менять ставки, бюджеты, расписание и объявления в боевом кабинете, то есть тратить рекламные деньги
- Токен Директа открывает данные кабинета, хотя каждая запись и требует подтверждения
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер работает на вашем компьютере для одного пользователя и ничего не выставляет в интернет. Он читает показы, клики, расход и конверсии по кабинетам, кампаниям, группам, объявлениям, фразам, запросам, регионам и устройствам, сравнивает периоды и строит отчеты. Дополнительно подключаются Яндекс Метрика, Wordstat, ретаргетинг и аудитории, а аудит кампании выдает план улучшений. Запись охватывает кампании, группы, объявления, фразы, ставки, корректировки, минус-фразы, цели, дневной бюджет и расписание показов. Любая правка идет через `plan_write` с предпросмотром «было, станет», затем через ваше подтверждение и `apply_write`, прямых изменений нет. Токен лежит в Credential Manager Windows, изменения пишутся в `journal.sqlite`, а ручные правки в кабинете видны через `changes_check`.
Для кого. Директологам и владельцам рекламных кабинетов на Windows, которые хотят отдать агенту аудит и рутинные правки кампаний под контролем.
Подходит, если
- Нужно сравнить расход, клики и конверсии по всем кабинетам за неделю с предыдущей
- Агенту поручают разбор кампании: что изменилось за месяц, где потери и что улучшить
- Расписание показов меняют точечно, например включают только субботу с 12 до 13
- Расходы Директа надо связать с заявками Метрики и посчитать CPA
Не подходит, если
- macOS и Linux: автор их не тестировал, сервер рассчитан на Windows 11 и PowerShell
- Нет одобренной заявки на доступ к API Директа: без нее сервер к кабинету не подключится
- Нужен общий сервер для команды: этот работает для одного пользователя на одном компьютере
Пример запроса к агенту
Покажи расход, клики и конверсии по всем аккаунтам за последние 7 дней и сравни с предыдущей неделейMCP
- Транспорт
- stdio
- Авторизация
- OAuth
Переменные окружения
DIRECT_TOKENсекрет- OAuth-токен Директа, по умолчанию хранится в Credential Manager Windows
Ограничения
Поддерживаются Windows 11 и PowerShell, macOS и Linux не проверялись. Нужны одобренная заявка на доступ к API Директа, что занимает до нескольких дней, приложение на oauth.yandex.ru и установленные Git и uv. Токены Метрики, Вебмастера и Wordstat выдаются отдельно. Блокировка защитного слоя guard означает защиту, ее нельзя обходить. Сервер бесплатный, лицензия MIT, последний коммит в ноябре 2026 года, звезд нет.
Как отключить. Удалите запись `directai-mcp` из настроек MCP-клиента, выполните `uv tool uninstall directai-mcp` и удалите токен из Credential Manager Windows.
Частые вопросы
Как правки попадают в кабинет?
Через `plan_write` с предпросмотром «было, станет», затем ваше явное согласие и `apply_write`. Прямых изменений без плана нет.
Где хранится токен?
В Credential Manager Windows или в переменной окружения. В логи и адреса он не попадает, вводить его в чат нельзя.
Что проверяют `check` и `probe`?
`check` обращается к API Директа и показывает `OK` по каждому аккаунту. `probe` локально проверяет MCP без обращения к рекламному API и баллов не тратит.
С какими клиентами работает сервер?
С OpenCode, Codex, Claude Code, Claude Desktop и Hermes: везде запускается команда `directai-mcp` по stdio. Конфиги лежат в `examples/harness-configs.md`.
Сколько действий доступно?
57 действий чтения и 25 записи, полный список в `docs/actions.md`. Запись ретаргетинга и аудиторий по умолчанию выключена.
Обсуждение
Вопросов и отзывов пока нет.
MCP-сервер от ZAI.ONE сводит Директ, Метрику, поиск, Wordstat и Вебмастер в одном агенте, с мастером настройки и включаемыми пишущими операциями
MCP для Метрики и Директа с минус-фразами
Яндекс.Метрика + Директ MCP Server
MCP-сервер на 30 инструментов для Метрики и Директа: отчеты, ставки, объявления, управление минус-фразами и Wordstat
MCP-сервер для Яндекс Директа, Метрики, Wordstat и Вебмастера: кампании, объявления, ставки, отчеты и подбор запросов из чата
MCP-сервер для аналитики Директа, Метрики, Wordstat и Аудиторий: сырые отчеты, сопоставление данных и HTML-дашборд
Монорепозиторий MCP-серверов для Яндекса: Директ, Метрика, Вебмастер, Wordstat, Трекер, 360, Карты, SpeechKit, YandexGPT и AppMetrica
MCP для Директа, Метрики, Wordstat и Вебмастера
yandex-marketing-mcp
MCP-сервер на 155 инструментов для Яндекс Директа, Метрики, Wordstat и Вебмастера с самонастройкой OAuth и режимами read-only и confirm
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| DirectAI MCP: локальный сервер для Яндекс Директа (эта карточка) | нет | OAuth | 0 | |
| MCP-сервер Яндекс Директа на Ruby | нет | API-ключ | 6 | здесь запись идет только через план с предпросмотром и журнал правок, плюс Метрика и Wordstat |
| Yandex Direct MCP | нет | не нужна | 14 | отдельный локальный сервер на Windows с журналом правок и проверкой ручных изменений |
Коротко о README
В README описаны возможности, быстрый старт с установкой, аккаунтами и токеном, проверка, подключение к агентам, примеры запросов, защитный слой и перечень документации.