Yandex Direct MCP

Яндекс Директ MCPподключает AI-приложение к рекламному кабинету Яндекс Директа. Спросите на естественном языке, куда уходит рекламный бюджет, сопоставьте кампании, объявления и ключевые фразы, а затем подготовьте или внесите нужные изменения без переходов между разделами кабинета. Подключение начинается прямо в диалоге: не нужно заранее создавать токен или редактировать конфигурацию.

- 44 инструмента.Кампании, группы, объявления, ключевые фразы, ставки, корректировки, расширения, статистика, баланс, справочники и подключение аккаунта прямо в диалоге.
- Два способа подключения.Удалённый сервер по URL не требует вручную получать токен и только читает данные; локальный черезnpxдаёт полный доступ к кабинету.
- Подключение в чате.Яндекс откроет страницу входа; после кода из чата можно сразу работать с рекламой, а доступ продлевается автоматически.
- Деньги в понятном виде.В удобных инструментах бюджеты, ставки и баланс показываются в валюте аккаунта, а не в микроединицах API.
- Реальная реклама.Локальные изменения применяются в боевом кабинете и могут повлиять на расход. Для работы в тестовой среде есть песочница Яндекс Директа.

Покажи кампании моего аккаунта и расход за прошлую неделю по группам объявлений.

Подключить сервер·Посмотреть сценарии·Открыть техническую документацию

- Быстрый старт
- Что можно поручить
- Как это работает
- Что может изменить данные
- Подключение и настройка
- Данные и телеметрия
- Ограничения
- Техническая документация
- Поддержка
- Выберите способ подключения и добавьте сервер в AI-приложение по инструкции ниже.
- Откройте новый диалог и спросите:«Покажи кампании моего аккаунта и расход за прошлую неделю по группам объявлений».

claude mcp add --transport http yandex-direct https://mcp.askads.ru/mcp

Для CI и агентских установок — готовый токен иYANDEX_DIRECT_LOGIN, см.Подключение и настройка.
- ОткройтеSettings → Plugins → MCP servers.
- НажмитеAdd server.
- Добавьте команду запускаnpx -y mcp-yandex-direct@latest.

codex mcp add yandex-direct -- npx -y mcp-yandex-direct@latest

claude mcp add --transport stdio --scope user yandex-direct -- npx -y mcp-yandex-direct@latest

{ "mcpServers": { "yandex-direct": { "command": "npx", "args": ["-y", "mcp-yandex-direct@latest"] } } }

Если раздела Developer нет, откройте файл вручную: macOS —~/Library/Application Support/Claude/claude_desktop_config.json, Windows —%APPDATA%\Claude\claude_desktop_config.json. Перезапустите Claude Desktop.

Откройте~/.cursor/mcp.json, чтобы подключить сервер во всех проектах, или.cursor/mcp.jsonв конкретном проекте. Добавьте:

{ "mcpServers": { "yandex-direct": { "command": "npx", "args": ["-y", "mcp-yandex-direct@latest"] } } }

В палитре команд выполнитеMCP: Open User Configuration. В открывшемсяmcp.jsonдобавьте сервер:

{ "servers": { "yandex-direct": { "type": "stdio", "command": "npx", "args": ["-y", "mcp-yandex-direct@latest"] } } }

После сохранения выполнитеMCP: List Serversи запустите сервер из списка.

- «Какие кампании за прошлую неделю потратили больше всего?»
- «Какие объявления получают показы и клики, но не дают конверсий?»
- «Сравни расход, CTR и среднюю цену клика по кампаниям за месяц».
- «Покажи баланс счёта и остаток дневной квоты API».

- «Какие ключевые фразы тратят бюджет, но не приносят кликов?»
- «Какие группы и объявления сейчас остановлены или не проходят модерацию?»
- «Проверь, какие корректировки ставок действуют для мобильных устройств».
- «Какие быстрые ссылки и уточнения есть у этой кампании?»

- «Предложи новые ставки для фраз с высоким CTR и покажи изменения до применения».
- «Проверь, есть ли в кампании минус-слова для этой темы, и подготовь список».
- «Собери параметры новой текстовой кампании для Москвы: бюджет, группы, ключевые фразы и объявления».

- «Добавь эти ключевые фразы в группу 123 и установи ставку 45 ₽».
- «Приостанови объявление 456».
- «Отправь страницу с изображением в библиотеку объявлений».

Реклама обычно строится из трёх уровней:кампания → группа объявлений → объявление. В группе находятся ключевые фразы, настройки показа и корректировки ставок. У объявлений могут быть быстрые ссылки, уточнения, визитки и изображения.

Сервер помогает смотреть на эти объекты вместе: связать расход кампании со статистикой групп, ключевыми фразами и объявлениями. Он умеет создавать новые кампании и объявления только текстового типа. Кампании других типов можно читать, переименовывать, менять им бюджет, останавливать, архивировать и удалять по идентификатору.

Статистика формируется не мгновенно:get_statisticsзапускает отчёт в сервисе Reports и ждёт его готовности. Большие спискиautoPaginateпроходит по страницам выдачи автоматически.

Удалённый сервер по URL только читает данные. Локальный сервер черезnpxможет изменить живой рекламный кабинет:

Инструменты передают AI-приложению метки чтения, записи и потенциально необратимого действия. Приложение может показать подтверждение, но его поведение зависит от клиента. Прямой запрос API дополнительно не выполнит запись безconfirmWrite=true; для изменения рекламы нужна явная просьба.

Для обычного использования токен заранее не нужен:
- В чате попросите подключить Яндекс Директ.
- Откройте ссылку на Яндекс OAuthпод аккаунтом с доступом к нужному рекламному кабинету.
- Подтвердите доступ и пришлите в чат показанный код. Всё, можно работать с рекламой: перезапускать клиент не нужно, конфигурацию править тоже.

Дальше подключение живёт само: доступ продлевается автоматически и не отваливается через год. Проверить состояние — попросите «покажи статус подключения», отключить — «отключи Директ». Выданный доступ отзывается вЯндекс ID.

- Каталог MCP-возможностей— страницы по пользовательским задачам для каждого инструмента.
- Все инструменты— параметры, ответы и границы каждого инструмента.
- Разработка— устройство проекта и работа с исходным кодом.
- API Яндекс Директа— первоисточник по API и его ограничениям.
- Пакет npm— опубликованные версии сервера.

Нашли ошибку или не хватает сценария?Создайте issueили напишите вTelegram.

Interact with the Taboola advertising platform using natural language via the Taboola Realize API.