К содержимому
Интеграции

MCP-инструменты

Обновлено

Как выдаются права

Плагин регистрирует группу «Яндекс.Директ» и десять групп прав внутри неё. У каждого инструмента своё право с тем же техническим именем. Например, для direct_get_account требуется право direct_get_account.

В MCP → API токены разрешите нужные инструменты подключению. Если права наследуются от роли, проверьте её в MCP → Роли. Настройка прав MCP не расширяет доступ владельца OAuth-токена в Яндексе.

Для анализа начните с «Кампании и статистика». «Произвольный отчёт» добавьте, когда нужны дополнительные срезы. Права на изменения выдавайте по задачам, а «Удаление без возврата» — отдельно, когда такое действие нужно.

Названия ниже соответствуют группам прав в бэкенде. Техническое обозначение группы приведено для разработчика; в запросах к MCP используются имена инструментов.

Права инструментов Яндекс.Директа На экране разрешены чтение и произвольный отчёт, а инструменты изменения ставок и бюджета выключены.

Кампании и статистика

Группа direct.read.

Инструмент Назначение
direct_get_account Логин, валюта, НДС, ограничения и баллы API.
direct_get_campaigns Кампании, состояния, бюджеты, стратегии; дополнительные поля аудита по with_audit_fields.
direct_get_adgroups Группы, регионы и минус-фразы.
direct_get_ads Объявления, тексты, ссылки и сведения о модерации.
direct_get_keywords Ключевые фразы и автотаргетинг, ставки и состояния.
direct_get_bid_modifiers Действующие корректировки ставок.
direct_get_strategies Пакетные стратегии, общие для кампаний.
direct_get_sitelinks Наборы быстрых ссылок.
direct_get_ad_extensions Уточнения объявлений.
direct_get_ad_images Изображения аккаунта, их хеши и привязка.
direct_get_creatives Креативы Конструктора Директа.
direct_get_ad_videos Видео аккаунта и их состояние.
direct_get_negative_keyword_sets Общие наборы минус-фраз.
direct_get_vcards Контакты и часы работы из визиток.
direct_get_businesses Профили организаций из Яндекс Бизнеса.
direct_get_feeds Фиды, статус обработки и число товаров.
direct_get_turbo_pages Опубликованные Турбо-страницы.
direct_get_leads Содержимое заявок с форм выбранных Турбо-страниц.
direct_get_regions Справочник регионов.
direct_get_dictionary Справочники Директа, включая валюты, интересы и ограничения Constants.
direct_get_changes Кампании, в которых были изменения с указанного момента.
direct_get_keyword_bids Текущие ставки и ступени аукциона.
direct_check_search_volume Проверка возможности показов по фразам и регионам; ответ о наличии спроса, без численной частотности.
direct_deduplicate_keywords Расчёт плана устранения конкуренции фраз; сам фразы не изменяет.
direct_get_campaign_stats Статистика по кампаниям за период, в том числе по дням.
direct_get_keyword_stats Статистика по условиям показа, средняя ставка и объём трафика.
direct_get_search_queries Реальные поисковые запросы и соответствующие фразы.
direct_get_retargeting_lists Условия ретаргетинга и правила отбора.
direct_get_audience_targets Аудитории, привязанные к группам, их ставки и состояния.
direct_get_agency_clients Клиенты агентства; требуется агентский доступ.

Произвольный отчёт

Группа direct.raw.

Инструмент Назначение
direct_query_report Отчёт с выбранным типом, полями, фильтрами и сортировкой.

Ставки

Группа direct.bids.

Инструмент Назначение
direct_set_keyword_bid Ставки фраз, групп или кампаний; автоматическое назначение при auto: true.
direct_set_bid_modifiers Создание, изменение коэффициента и удаление корректировок ставок.
direct_set_audience_target_bid Ставки и приоритеты аудиторий в группах.

Бюджеты

Группа direct.budget.

Инструмент Назначение
direct_set_campaign_budget Установка или снятие дневного бюджета кампании.

Остановка и возобновление показов

Группа direct.state.

Инструмент Назначение
direct_set_campaign_state Остановка, возобновление, архивирование и разархивирование кампаний.
direct_set_ad_state Те же действия для отдельных объявлений.
direct_set_keyword_state Остановка и возобновление фраз или автотаргетинга.
direct_set_audience_target_state Остановка и возобновление показов по аудитории.
direct_set_autotargeting Категории и марочные настройки автотаргетинга в группах.

Минус-фразы

Группа direct.negative.

Инструмент Назначение
direct_add_campaign_negative_keywords Добавление минус-фраз кампании с сохранением имеющихся.
direct_remove_campaign_negative_keywords Снятие выбранных минус-фраз кампании или всего списка.
direct_remove_adgroup_negative_keywords Снятие выбранных минус-фраз группы или всего списка.
direct_add_shared_negative_keywords Создание общего набора или дополнение существующего.

Объявления и дополнения

Группа direct.ads.

Инструмент Назначение
direct_update_ads Правка текстов, ссылок, цены, изображений и привязок дополнений и контактов.
direct_add_sitelinks Создание набора быстрых ссылок; привязка выполняется отдельно.
direct_add_ad_extensions Создание уточнений; привязка выполняется отдельно.
direct_add_ad_image Загрузка изображений по URL; возвращает хеши для привязки.

Структура кампании

Группа direct.structure.

Инструмент Назначение
direct_update_adgroup Название и регионы группы, добавление её минус-фраз.
direct_update_campaign Название, счётчики, атрибуция, общие наборы минус-фраз, ключевые цели и параметры URL.
direct_update_client Настройки рекламодателя: название, телефон, уведомления и другие поддержанные поля.
direct_update_keywords Текст существующих ключевых фраз, кроме автотаргетинга.
direct_set_excluded_sites Запрещённые площадки РСЯ: добавление, снятие и замена списка.
direct_set_blocked_ips Заблокированные IP-адреса: добавление, снятие и замена списка.
direct_add_audience_target Привязка условия подбора аудитории или категории интересов к группе.
direct_manage_feed Создание и правка фида по URL; с feed_id — правка, без него — создание.

Создание черновиков

Группа direct.create.

Инструмент Назначение
direct_create_campaign Создание кампании со стратегией и заданными параметрами.
direct_add_adgroup Добавление группы с регионами в кампанию.
direct_add_ads Создание объявлений без отправки на модерацию.
direct_add_keywords Добавление фраз в группу, при необходимости со ставками.
direct_add_retargeting_list Создание условия ретаргетинга из целей и сегментов Метрики.
direct_update_retargeting_list Правка условия ретаргетинга, в том числе полная замена правил.

Удаление без возврата

Группа direct.delete.

Инструмент Назначение
direct_delete_objects Безвозвратное удаление выбранных объектов; виды перечислены в статье об управлении рекламой.

Подтверждение изменений

Все инструменты изменения и создания, включая удаление и снятие корректировок, требуют confirm: true. Без него возвращается confirm_required, и изменение не выполняется. Читающие инструменты такого подтверждения не требуют.

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

Группа «Создание черновиков» содержит и правку существующего условия ретаргетинга. Изменение его правил может повлиять на уже работающие кампании. Добавление фраз, групп или аудиторий в действующую структуру также требует оценки последствий.

Примеры просьб агенту

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

Поисковые запросы в ответе агента Агент показывает клики и расход по поисковым запросам и отмечает наличие запросов в минус-фразах.

Материалы для агента

Плагин регистрирует четыре навыка:

Идентификатор Название
direct-basics Директ: сценарии и подводные камни
direct-launch Директ: запуск кампании
direct-manage Директ: ведение и отслеживание
direct-audit Директ: аудит аккаунта и нормы рынка

Они содержат пояснения и сценарии работы для агента. Регистрация материала не означает, что любой MCP-клиент прочитает его автоматически: это зависит от клиента. Сам навык не выдаёт прав на инструменты и не запускает регулярную оптимизацию.