Обзор

Для чего нужен плагин

«Яндекс.Директ для MCP» подключает рекламный аккаунт к ИИ-агенту через приложение MCP в Webasyst. Владелец сайта или магазина может попросить агента разобрать расходы, поисковые запросы и объявления, подготовить изменения и применить согласованные правки. Разработчик может вызывать те же инструменты из своего MCP-клиента.

Плагин предоставляет 63 инструмента. Доступ к каждому задаётся отдельно: агенту для анализа можно разрешить чтение и отчёты, а управление ставками, показами и удаление оставить закрытыми.

Возможности

• Чтение аккаунта, кампаний, групп, объявлений, фраз, стратегий, корректировок и аудиторий.
• Статистика по кампаниям и условиям показа, реальные поисковые запросы, произвольные отчёты с фильтрами и группировками.
• Чтение ставок и ступеней аукциона, проверка наличия спроса и расчёт плана устранения конкуренции между фразами.
• Изменение ставок, дневного бюджета, показов, минус-фраз, текстов, изображений и дополнений объявлений.
• Изменение регионов, счётчиков Метрики, ключевых целей, параметров URL, запрещённых площадок и IP-адресов.
• Создание кампаний, групп, объявлений и фраз; управление условиями ретаргетинга и товарными фидами по URL.
• Чтение Турбо-страниц и содержимого заявок с их форм, получение списка клиентов агентства.
• Безвозвратное удаление объектов отдельным инструментом с отдельным правом.

Все изменяющие вызовы требуют аргумент confirm: true. Это проверка аргумента на сервере; отдельного обязательного диалога согласования плагин не создаёт. Порядок получения согласия человека задаётся в работе с агентом.

Редакции

В коде и описании продукта нет разделения на стандартную и премиум-редакцию. Набор доступных агенту действий определяется правами подключения MCP и доступом владельца OAuth-токена к данным Директа.

Совместимость и требования

Плагин устанавливается в приложение MCP и не зависит от темы дизайна или наличия Shop-Script. Хелперов витрины и шаблонов для вывода на сайте в нём нет.

Для работы нужны:

• приложение MCP версии 1.3.0 или новее — требование из описания поставки;
• рекламный аккаунт и OAuth-токен Яндекса с правом «Использование API Яндекс Директа» (direct:api);
• одобренная заявка на доступ к API Директа для OAuth-приложения, выдавшего токен;
• исходящие HTTPS-запросы с сервера Webasyst к api.direct.yandex.com, а для песочницы — к api-sandbox.direct.yandex.com;
• MCP-клиент, например Claude Desktop, Cursor или собственная программа.

Особых требований к версиям PHP и Webasyst нет. Загрузка изображений по URL использует PHP cURL; для перекодирования и обрезки изображений нужен GD. Собственных заданий cron и CLI-команд у плагина нет.

Границы управления

Плагин не отправляет новые объявления на модерацию и не выполняет первоначальный запуск черновика. Эти шаги остаются в интерфейсе Директа. При этом он умеет возобновлять показы ранее остановленных объектов: это может снова вызвать расход.

Смены стратегии существующей кампании, загрузки видео и файловых фидов нет. Стратегия задаётся при создании кампании, фиды по URL создаются и редактируются инструментами. Список возможностей и прав приведён в статье «MCP-инструменты».