Yandex Direct MCP: управляйте Яндекс Директом через ИИ

Если вы ведёте рекламу в Яндекс Директе и уже пользуетесь ИИ (Claude, Cursor, ChatGPT, Grok, Windsurf), вам знакома боль: кабинет ручной, отчёты в TSV, а «просто скажи агенту — порежь мусор в РСЯ, посмотри поисковые запросы, подними бюджет» — нельзя. Пока не подключите MCP.

Мы открыли yandex-direct-mcp — тот же стек, которым сами крутим рекламу Arckep. Лицензия MIT, около 80 инструментов, API Директа v5/v501.

Разработчиком быть не нужно: сервер ставится один раз, а дальше вы просто общаетесь со своим ИИ обычным языком. Самый простой путь — скинуть ссылку на репозиторий вашему ИИ-агенту: он всё развернёт сам (подробности — ниже).

Что это даёт на практике

Задача	Без MCP	С MCP
«Что жжёт бюджет за вчера»	Выгрузка, Excel	Один вопрос агенту — отчёт по площадкам
«Какие запросы в поиске»	Отчёт по SQ руками	Агент покажет топ запросов по расходу
«Вырежи мусорные площадки РСЯ»	По одной в интерфейсе	Агент предложит список, вы подтверждаете
«Пауза кампании / бюджет»	Клики в кабинете	Одна фраза в чате
«Запусти пачку search-кампаний»	Часы ручной сборки	Агент собирает пакет, вы проверяете план
«Настрой автотаргетинг»	Неочевидный API	Одна команда

Все изменения в кабинете — только после вашего подтверждения: агент сначала показывает план (dry-run), и лишь после вашего «да» применяет его.

Важно: soft Conversions в отчётах Директа — это цели Метрики, не обязательно оплаты. Для денег смотрите CRM или свою аналитику.

Что умеет (~80 инструментов)

Смотреть

Кампании, группы, ключевые фразы, объявления, минус-слова
Exclude-площадки, корректировки по устройствам и аудиториям, география
Стратегии, приоритетные цели, расписание показов, остаток средств
Быстрые ссылки, уточнения, списки ретаргетинга

Статистика

Расход, клики, CTR, CPC по кампаниям
Срезы: площадки, устройства, объявления, критерии, пол, возраст
Поисковые запросы — то, что реально вбивали люди
Сырые отчёты под любые поля API

Менять — только с вашего «да»

Бюджеты: дневной и недельный, поиск и РСЯ
Стратегии: ручные ставки, максимум конверсий, максимум кликов в РСЯ
Минус-слова, exclude-площадки, исключения регионов
Ставки и остановка ключей, категории автотаргетинга
Тексты объявлений, ссылки, отправка на модерацию
Видео-расширения
Запуск кампаний «под ключ»: кампания → картинки → группы → ключи → объявления → модерация

Страховка

Изменения всегда привязаны к конкретному проекту (бренду) — «применить ко всему сразу» запрещено
Перед любым изменением агент показывает dry-run план

Самый простой способ: поручите установку своему ИИ

Не обязательно ничего ставить руками. Отправьте вашему ИИ-агенту (Claude Code, Cursor, Kimi Code, Codex — любому, кто умеет выполнять команды на вашем компьютере) ссылку на репозиторий и такой промпт:

Разверни open-source MCP Яндекс Директ:
https://github.com/gmen1057/yandex-direct-mcp
Следуй AGENTS.md. Спроси у меня только OAuth-токен и какой AI-клиент.
Write-мутации не делай без моего «да».

AGENTS.md в корне репозитория — это пошаговый playbook для ИИ. Агент сам клонирует репозиторий, установит зависимости, попросит у вас токен и пропишет конфиг вашего клиента — desktop-приложения или консольного.

Единственное, что нужно подготовить вам, — OAuth-токен Директа (инструкция ниже).

Как получить OAuth-токен Директа

Токен — это ключ, с которым MCP ходит в API от вашего имени. Получается один раз за пару минут:

Включите доступ к API. В веб-интерфейсе Директа откройте раздел API (внизу страницы «Управление кампаниями» или в настройках) и подайте заявку на доступ. Тестовый доступ обычно выдаётся сразу, полный — после проверки заявки Яндексом.
Зарегистрируйте приложение на oauth.yandex.ru: платформа — «веб-сервисы», Callback URI — https://oauth.yandex.ru/verification_code, в доступах отметьте Яндекс Директ API. После создания скопируйте ClientID приложения.
Получите токен. Откройте в браузере (под логином, от которого ведёте рекламу):

https://oauth.yandex.ru/authorize?response_type=token&client_id=ВАШ_CLIENT_ID

Яндекс покажет токен — сохраните его как пароль. Если токен агентский (от агентского аккаунта), дополнительно понадобится логин рекламодателя.

Подробности — в официальной документации Яндекса. Если ставит агент — просто назовите ему токен, когда он спросит.

Работает не только в терминале

Частое заблуждение: MCP — «что-то для программистов». На деле сервер подключается к любому клиенту с поддержкой MCP — и к консольным агентам, и к обычным приложениям с графическим интерфейсом. Вся настройка — один JSON-блок в конфиге, который за вас может вписать тот же агент.

Desktop-приложения: Claude Desktop (macOS/Windows), Cursor, ChatGPT Desktop, Windsurf, Cherry Studio.

CLI-агенты: Claude Code, Kimi Code, Codex CLI, Gemini CLI, Grok Build.

Для ручной настройки везде одно и то же — команда node, путь к index.mjs, переменная окружения с токеном. Например, для Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json на macOS, %APPDATA%\Claude\claude_desktop_config.json на Windows):

{
  "mcpServers": {
    "yandex-direct": {
      "command": "node",
      "args": ["/полный/путь/yandex-direct-mcp/index.mjs"],
      "env": {
        "YANDEX_DIRECT_TOKEN": "ваш_токен"
      }
    }
  }
}

Для Cursor действует тот же JSON (~/.cursor/mcp.json), для Claude Code — ~/.claude.json или .mcp.json в проекте. Готовые примеры для разных клиентов лежат в репозитории в папке examples/.

Установка вручную (если хочется самим)

Требования: Node.js 18+ и токен (см. выше).

git clone https://github.com/gmen1057/yandex-direct-mcp.git
cd yandex-direct-mcp
npm install
cp .env.example .env

В .env впишите токен:

YANDEX_DIRECT_TOKEN=ваш_токен
# если токен агентский:
# YANDEX_DIRECT_CLIENT_LOGIN=login_рекламодателя

Права на файл: chmod 600 .env.

Если брендов несколько, разметьте их в projects.json — так агент не перепутает кампании:

{
  "projects": {
    "shop": {
      "label": "Магазин",
      "name_prefixes": ["[shop]"],
      "campaign_ids": [123456789]
    }
  }
}

Удобно именовать кампании с префиксом [shop] — MCP сам поймёт проект. Проверка установки: npm run smoke — ожидаете registered 80 tools.

Безопасность

Токен = полный доступ к кабинету. Не коммитьте в git, не публикуйте в чатах.
Изменения — только после dry-run и вашего подтверждения.
Не мешайте бренды: агент всегда работает в рамках одного проекта.
Units API — дневной лимит запросов Яндекса; тяжёлые отчёты расходуют units.
Модерация: в текстах объявлений не используйте ₽, длинное тире —, «VPN» — Директ режет.

Типичный диалог с агентом

«Покажи список кампаний проекта shop»
«Отчёт за 7 дней + поисковые запросы, топ-20 по расходу»
«Найди мусорные площадки РСЯ, предложи exclude»
Вы: «ок, применяй» — агент выполняет изменения
«Статус автотаргетинга и ставки»

Создание кампании с нуля: «Собери search-кампанию для проекта shop, недельный бюджет …, вот посадочная и список фраз — сначала покажи план».

Ограничения

Это не замена интерфейса Директа для всего на свете (смарт-баннеры, сложные display-кампании — через веб-интерфейс).
Нужен действующий OAuth-токен и соблюдение правил API Яндекса.
Привязка конверсий к выручке из вашей CRM опциональна и по умолчанию выключена.

Итог

Если вы уже платите за клики в Директе и пользуетесь ИИ — связка MCP + агент экономит часы: поисковые запросы, чистка РСЯ, бюджеты, автотаргетинг и запуск кампаний без ручной возни в кабинете. И работает это не только в терминале — Claude Desktop, Cursor и другие приложения подключаются так же просто.

Начните с просмотра и отчётов, а изменения разрешайте, когда доверяете плану агента.

Репозиторий: gmen1057/yandex-direct-mcp · Лицензия MIT · Проект не аффилирован с Яндексом; «Яндекс» и «Директ» — товарные знаки правообладателей.

Yandex Direct MCP: open-source сервер для управления Директом из Claude, Cursor и других ИИ