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

Подключение Яндекса

Обновлено

Получение OAuth-токена

Плагин принимает готовый токен. Встроенной кнопки авторизации через Яндекс в его настройках нет.

  1. Создайте приложение в Яндекс.OAuth с правом «Использование API Яндекс Директа» (direct:api).
  2. Подайте заявку на доступ к API Директа для этого приложения и дождитесь одобрения. Плагин распознаёт отказ до одобрения как api_access_pending; песочница его не обходит.
  3. Получите пользовательский токен для приложения. В описании поставки приведён такой адрес авторизации:
https://oauth.yandex.ru/authorize?response_type=token&client_id=CLIENT_ID

Замените CLIENT_ID идентификатором своего OAuth-приложения. Получайте токен от имени представителя нужного рекламодателя.

  1. Вставьте токен в «OAuth-токен Яндекса» и сохраните настройки плагина.
  2. Проверьте аккаунт через direct_get_account.

Агентский доступ

Для работы от имени клиента агентства заполните «Логин рекламодателя». Плагин добавляет его в заголовок Client-Login запросов Директа. У прямого рекламодателя это поле должно оставаться пустым.

direct_get_agency_clients читает список клиентов под агентским токеном. У обычного рекламодателя API может отказать в таком запросе. Инструмент не выдаёт доступ к чужим аккаунтам: доступ определяется полномочиями владельца токена Яндекса.

Какие данные передаются

Направление Данные
Webasyst → Яндекс.Директ OAuth-токен в заголовке Authorization: Bearer …, логин клиента агентства при его заполнении, отборы, периоды и поля запросов; при изменении — новые ставки, бюджеты, тексты, списки и другие параметры выбранного действия.
Яндекс.Директ → MCP-клиент Запрошенная структура рекламы, статистика, ставки, дополнения, настройки и результаты изменений. Состав зависит от вызванного инструмента и выданных прав.
Яндекс.Директ → MCP-клиент при чтении заявок direct_get_leads возвращает время, Турбо-страницу и содержимое полей отправленной формы. Это могут быть контактные данные посетителя.
Сервер изображений → Webasyst → Яндекс.Директ direct_add_ad_image скачивает изображение по переданному URL и загружает его содержимое в рекламный аккаунт.
MCP-клиент → Яндекс.Директ через Webasyst при работе с фидом URL выгрузки, название и параметры фида; при необходимости логин и пароль закрытой выгрузки. Директ использует их для скачивания фида.

Ответы инструментов доступны подключённому клиенту и используемому им агенту. Разрешайте чтение заявок и других данных с учётом того, какой клиент их получит. OAuth-токен не включается плагином в обычные ответы инструментов.

Расписание и обратные уведомления

Собственных webhook-обработчиков, cron-заданий и CLI-команд в плагине нет. Он выполняет запросы по вызову MCP-инструментов. Периодические задачи, если они нужны, настраиваются средствами внешнего клиента или приложения, которое вызывает MCP.