Yandex Direct MCP: Документация
Обновлено:
Подключение
npx -y @theyahia/yandex-direct-mcp (stdio; отдельный процесс на каждый запуск клиента, HTTP-режима нет). Auth: YANDEX_DIRECT_TOKEN — OAuth-токен приложения Яндекса с доступом к Директ API (oauth.yandex.ru); опционально YANDEX_DIRECT_LOGIN для агентских токенов и YANDEX_DIRECT_SANDBOX=1 для тестового контура без реальных списаний.
Инструменты
20 инструментов: кампании (list_campaigns, get_campaign, create_campaign, update_campaign — SUSPEND/RESUME/ARCHIVE/UNARCHIVE), группы объявлений (list_ad_groups, create_ad_group, delete_ad_groups, set_ad_group_negative_keywords), объявления (list_ads, create_text_ad, update_text_ad, manage_ads — suspend/resume/archive/moderate/delete), ключевые фразы и ставки (list_keywords, add_keywords, set_keyword_bids, manage_keywords, set_campaign_negative_keywords), статистика и аккаунт (get_statistics, get_account_balance, get_regions).
Сценарий для агента
«Покажи активные кампании и баланс аккаунта», «подними ставки по группе 555 на 15%», «выгрузи статистику по кликам и расходу за неделю».
Важно
Community-проект (theYahia), не аффилирован с Яндексом. С 08.07.2026 в монорепо altrr2/yandex-tools-mcp появился отдельный, не связанный с этим пакет yandex-direct-mcp (без npm-скоупа, 21 инструмент) — данная карточка про @theyahia/yandex-direct-mcp. Инструменты create_campaign, create_text_ad, add_keywords, set_keyword_bids меняют боевой рекламный аккаунт и тратят деньги — подтверждения внутри сервера нет, тестируйте через YANDEX_DIRECT_SANDBOX=1. Транспорт — только stdio.