К содержимому
Начало работы

Установка и первые шаги

Обновлено

Установка

  1. Убедитесь, что в Webasyst установлено приложение MCP.
  2. Откройте карточку плагина в маркете Webasyst и установите его в нужный аккаунт через «Инсталлер».
  3. В бэкенде откройте MCP → Плагины → Яндекс.Директ для MCP.

Первая настройка

  1. Получите OAuth-токен по инструкции «Подключение Яндекса».
  2. Заполните «OAuth-токен Яндекса».
  3. Если вы прямой рекламодатель, оставьте «Логин рекламодателя» пустым. Агентство указывает логин клиента.
  4. Выберите, как учитывать НДС в отчётах. По умолчанию выбрано «С НДС».
  5. Для работы с реальной рекламой оставьте «Песочница» выключенной.
  6. Нажмите «Сохранить».

Все поля описаны в статье «Настройка».

Подключение агента

В разделе MCP → API токены настройте подключение клиента и разрешите ему инструменты из группы «Яндекс.Директ». Для первой проверки достаточно права «Аккаунт Директа» (direct_get_account) и права «Кампании» (direct_get_campaigns) в группе «Кампании и статистика».

Подключите MCP-клиент к приложению MCP по инструкции самого приложения. OAuth-токен Яндекса хранится в настройках плагина; он не заменяет учётные данные клиента MCP.

Проверка результата

Попросите агента:

Проверь подключение Яндекс.Директа. Покажи логин рекламодателя,
валюту аккаунта и список кампаний. Ничего не меняй.

Первым вызывается direct_get_account без аргументов. Проверьте поля account.login, account.currency и account.sandbox: для обычной работы последнее должно быть false. Остаток баллов API появится, если Директ вернул соответствующие данные. Затем вызовите direct_get_campaigns.

Если логин правильный и список кампаний получен, подключение к API работает. Пустой список сам по себе не доказывает ошибку: проверьте выбранный аккаунт и режим песочницы. Отказы подключения разобраны в частых вопросах.