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.
{
"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.
Time
Эталонный сервер для получения текущего времени и перевода между часовыми поясами.
Reactive Resume
Открытый конструктор резюме с удалёнными MCP-инструментами для резюме и откликов.
AIHOT
Новости ИИ на китайском: темы, события и сводки.