MCP для Яндекс Директа: отчёты и подготовка кампаний

Обновлено 3 сентября 2026 года.

Мы опубликовали yadirect-mcp — локальный MCP-сервер, который связывает совместимого AI-агента с API Яндекс Директа. Он предназначен для рекламной отчётности и подготовки кампаний. Это самостоятельный проект, а не официальный продукт Яндекса.

Сведения ниже сверены с публичным репозиторием 3 сентября 2026 года. В конфигурации проекта указаны версия 0.2.0 и Python 3.11 или новее. MCP-клиент запускает сервер как локальный процесс с транспортом stdio.

Что доступно в режиме отчётности

В коде регистрации инструментов есть получение клиентов агентства, кампаний, объявлений, настроек кабинета и регионов, а также создание и постраничное чтение отчётов. Полный результат большого отчёта сохраняется в локальный TSV-файл, а агент получает сводку и предварительный просмотр.

Инструмент direct_wordstat реализован отдельно. В текущем проекте он использует старый интерфейс Wordstat API v4; его наличие в коде не подтверждает доступность вызова для любого аккаунта. Перенос на другой API указан в плане развития.

Отдельная выгрузка из Яндекс Метрики пока находится в roadmap. Конверсии и цели, доступные в отчётах Директа, не означают наличие отдельного инструмента для чтения всех отчётов счётчика Метрики. Прежняя формулировка «опционально — Метрика» этого различия не объясняла.

Как работает агентский доступ

Можно использовать OAuth-токен представителя агентства для клиентов, к которым у него есть доступ. В запросах по рекламодателю указывается его логин через Client-Login; для AgencyClients этот заголовок не нужен. Правила описаны в документации Директа для агентств. Один токен не открывает произвольные рекламные кабинеты.

Сервер читает токен из YD_TOKEN и поддерживает ограничение логинов через YD_ALLOWED_LOGINS. Токен задаётся в конфигурации окружения процесса; его не нужно включать в запросы к AI-агенту или публиковать в отчётах. Доступ приложения к API и права пользователя должны быть настроены на стороне Яндекса.

Отчётность и создание кампаний разделены

По умолчанию включён YD_MODE=report. В этом режиме инструмент создания кампаний не регистрируется. Для подготовки и записи кампании нужно явно включить campaign_setup; код предусматривает предварительный просмотр и точную фразу подтверждения.

Перед записью проверяют логин клиента, географию, бюджет, ссылки, тексты и ключевые фразы. Такая проверка нужна и при корректном ответе API: API не оценивает коммерческий смысл рекламного предложения. Частичный сбой также требует сверить, какие объекты уже созданы.

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