Claude Code, Cursor и любой MCP-совместимый агент смогут сами доставать кампании, ключевые фразы и статистику из Директа и отвечать на вопросы о рекламе на ваших реальных данных. Вы добавляете OAuth-токен один раз в кабинете — дальше агент работает через один эндпоинт Neurly.
Бесплатно · ключи шифруются · инструменты только для чтения
Никаких дашбордов и выгрузок — обычный вопрос в чате. Агент сам выберет нужные инструменты Яндекс.Директ, вызовет их и посчитает ответ.
direct_campaigns_list — Рекламные кампании: название, тип, состояние (идёт, остановлена, в архиве), статус оплаты, дата старта и дневной бюджетdirect_adgroups_list — Группы объявлений выбранных кампаний: название, регионы показа, статус и состояние показовdirect_ads_list — Объявления: заголовки, текст, ссылка, отображаемый домен, состояние и статус модерации с пояснением причины отклоненияdirect_keywords_list — Ключевые фразы со ставками на поиске и в сетях, состоянием и статусом показовdirect_stats_report — Статистика за период: показы, клики, расход, CTR, средняя цена клика; с goal_ids — конверсии и их стоимостьdirect_search_queries_report — Реальные поисковые запросы, по которым показывались объявления: запрос, кампания, группа, показы, клики и расход — чтобы находить мусорные запросы для минус-словdirect_client_info — Рекламодатель: логин, название, валюта аккаунта и остаток баллов API на сегодня (израсходовано/остаток/лимит)direct_dictionaries_get — Справочники Директа для расшифровки ID: регионы показа (с поиском по названию), валюты, категории объявлений, часовые поясаclaude mcp add --transport http neurly https://neurly.ru/v1/mcp --header "Authorization: Bearer sk-neurly-..."
Это «переходник» между ИИ-агентом и API Директа. MCP (Model Context Protocol) — открытый протокол, по которому Claude Code, Cursor и другие агенты подключают внешние инструменты. MCP-сервер Neurly превращает методы Direct API v5 (Campaigns.get, Keywords.get, сервис Reports) в инструменты, которые агент вызывает сам: вы спрашиваете «какие фразы съедают бюджет без конверсий» — агент достаёт отчёт и отвечает на ваших данных.
Зарегистрируйтесь на neurly.ru, откройте в кабинете раздел «MCP» и подключите Яндекс.Директ: нужен OAuth-токен Яндекса с правом «Использование API Яндекс.Директа», а агентствам — ещё и логин клиента. Дальше скопируйте эндпоинт Neurly в настройки MCP вашего агента — в Claude Code это одна команда claude mcp add, готовые сниппеты есть в кабинете. Отчёты статистики Директ формирует в очереди, поэтому такие запросы отвечают на несколько секунд дольше.
Токен добавляется один раз в кабинете Neurly и хранится в зашифрованном виде; в логи и ответы агенту он не попадает. Все инструменты — только чтение: агент не сможет изменить ставки, остановить кампанию или отправить объявление на модерацию, даже если его об этом попросить. Отозвать токен можно в любой момент в Яндекс ID.
MCP-серверы Neurly бесплатны и останутся бесплатными. Нужен только аккаунт Neurly с положительным балансом — сам баланс при работе MCP-инструментов не расходуется. Само API Директа со стороны Яндекса тоже бесплатно.
Да, как и любое приложение, работающее с Direct API: запросы идут от вашего OAuth-токена и тратят ваш суточный лимит баллов (units). Лимит индивидуален и зависит от активности кампаний, а начисляется по 1/24 в час. Read-only запросы дешёвые, а остаток баллов виден в заголовке Units каждого ответа — мы планируем отдавать его инструментом direct_client_info, чтобы агент сам следил за лимитом.
Официального MCP-сервера Яндекс для Директа не публикует; встречаются community-реализации на GitHub, которые нужно ставить и обновлять локально, самостоятельно разбираясь с токенами и офлайн-очередью Reports API. Hosted-вариант Neurly не требует установки: один эндпоинт со всеми вашими интеграциями (Директ, Ozon и другие), токены зашифрованы на сервере, а обработку TSV-отчётов и повторные запросы при кодах 201/202 сервер берёт на себя.