Yandex Direct MCP

Yandex Direct MCP — MCP-сервер сообщества (автор — stufently). Сервер для API Яндекс Директа v5: кампании, объявления, ключевые фразы и отчёты. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
stufently
Лицензия
MIT
Транспорт
stdio
Авторизация
oauth
ОС
Не указана
Языки
javascript

Уровень риска: high

Меняет живые кампании и ставки в Директе, dry-run нет. 14 необратимых инструментов требуют `confirm: true`; начинайте с песочницы.

Что умеет

yandex-direct-mcp — MCP-сервер для API Яндекс Директа v5: кампании, группы объявлений, объявления, ключевые фразы, ставки, корректировки ставок, быстрые ссылки, визитки и отчёты. Всего 43 инструмента. В отличие от остальных серверов монорепозитория stufently/yandex-mcp, этот меняет живые рекламные данные.

Раздел Инструменты
Кампании get_campaigns, add_campaigns, update_campaigns, delete_campaigns, архивация, остановка и возобновление
Группы объявлений get_adgroups, add_adgroups, update_adgroups, delete_adgroups, архивация
Объявления get_ads, add_ads, update_ads, delete_ads, архивация, moderate_ads
Ключевые фразы get_keywords, add_keywords, update_keywords, delete_keywords, остановка и возобновление
Ставки get_keyword_bids, set_keyword_bids, set_auto_keyword_bids, корректировки ставок
Расширения быстрые ссылки и визитки: получение, добавление, удаление
Прочее create_report, get_dictionaries, get_clients

Ставки задаются в микроединицах (×10⁶), поэтому ошибка на шесть порядков — реальный риск. Агентства могут работать от имени клиента через YANDEX_DIRECT_CLIENT_LOGIN.

Кому подойдёт

  • Специалистам по контекстной рекламе: отчёты, правка фраз и ставок в диалоге с ассистентом.
  • Агентствам: работа с кабинетами клиентов по логину.
  • Тем, кто хочет сначала потренироваться: режим песочницы Директа.

Похожие серверы — в категории маркетинг и соцсети.

Установка

Пакет будет опубликован как @stufently/yandex-direct-mcp, но пока под этим именем ничего не выложено. Пакеты yandex-*-mcp без префикса принадлежат другому автору. Поэтому запускайте сервер из исходников: склонируйте репозиторий stufently/yandex-mcp и установите зависимости через bun install.

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

  • YANDEX_DIRECT_TOKEN — OAuth-токен для API Директа v5, обязательно;
  • YANDEX_DIRECT_CLIENT_LOGIN — логин клиента, только для агентств;
  • YANDEX_DIRECT_SANDBOX=true — направить все вызовы в песочницу Директа.

Подключение к клиентам

Конфиг приведён дословно из README. Укажите путь к склонированному репозиторию. Общий порядок — в инструкции как подключить MCP.

claude_desktop_config.json
{
  "mcpServers": {
    "yandex-direct": {
      "command": "node",
      "args": ["/path/to/yandex-mcp/packages/yandex-direct-mcp/src/index.mjs"],
      "env": { "YANDEX_DIRECT_TOKEN": "your-token" }
    }
  }
}

Пока вы проверяете сценарии, добавьте в env переменную YANDEX_DIRECT_SANDBOX со значением true.

Проверка

Попросите ассистента: «Покажи список моих кампаний в Директе». Он вызовет get_campaigns — это только чтение.

Примеры задач

Сделай отчёт по расходам и кликам кампаний за прошлую неделю.
Найди ключевые фразы без показов за месяц и предложи, какие остановить.

Риски

Реальные рекламные расходы. Сервер создаёт, меняет, удаляет и архивирует кампании и объявления и выставляет ставки — это напрямую влияет на то, сколько аккаунт платит за клик. Режима пробного запуска (dry-run) нет.

Что встроено: 14 необратимых инструментов — все delete_*, update_campaigns, update_adgroups, update_ads, update_keywords и три инструмента ставок — отказываются работать без параметра confirm: true. Без него в API Директа ничего не уходит и баллы API не тратятся. Принимается только буквальное true. Эти инструменты помечены destructiveHint: true, чтобы клиенты могли предупредить о риске. Добавление, архивация, остановка и moderate_ads не защищены, потому что их можно отменить.

Как снизить риски: начинайте с YANDEX_DIRECT_SANDBOX=true, проверяйте единицы ставок перед подтверждением, не разрешайте клиенту автоматически подтверждать вызовы этого сервера. Лицензия — MIT.

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

Можно ли попробовать без риска для бюджета?

Да. С YANDEX_DIRECT_SANDBOX=true все вызовы идут в песочницу Директа.

Удалит ли ассистент кампанию без подтверждения?

Нет. Удаление и другие необратимые действия выполняются только с параметром confirm: true.

Основы протокола — на странице что такое MCP-сервер.

Инструменты

  • get_campaigns
  • update_campaigns
  • delete_campaigns
  • add_ads
  • add_keywords
  • set_keyword_bids
  • create_report

Похожие MCP-серверы

Everything

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

Риск: medium Лицензия: NOASSERTION ★ 92 089

Time

Эталонный сервер для получения текущего времени и перевода между часовыми поясами.

Риск: medium Лицензия: NOASSERTION ★ 92 089

Reactive Resume

Открытый конструктор резюме с удалёнными MCP-инструментами для резюме и откликов.

Риск: medium Лицензия: MIT ★ 45 567

AIHOT

Новости ИИ на китайском: темы, события и сводки.

Риск: medium Лицензия: MIT ★ 9 672

Источники