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

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

Обновлено

OAuth-токен Яндекса

Для запросов используется токен Яндекс.OAuth. Владелец токена должен иметь доступ к нужному счётчику в Метрике.

Порядок, приведённый в описании продукта:

  1. Создайте приложение на Яндекс.OAuth.
  2. В правах Яндекс.Метрики отметьте metrika:read для чтения статистики.
  3. Если агент должен создавать счётчики, цели и фильтры или удалять цели, добавьте metrika:write.
  4. Получите токен для своего приложения. В описании продукта используется адрес авторизации следующего вида; вместо CLIENT_ID подставьте идентификатор созданного приложения:
https://oauth.yandex.ru/authorize?response_type=token&client_id=CLIENT_ID

Вставьте полученный токен в поле «OAuth-токен Яндекса» и сохраните. Плагин использует сохранённое значение; автоматическое получение и обновление OAuth-токена в нём не реализованы.

Два уровня доступа

Уровень Что определяет
OAuth-токен Яндекса К каким счётчикам разрешено обращаться и можно ли выполнять операции записи в API.
Права токена MCP Какие инструменты доступны подключённому агенту. Права выдаются по инструментам в четырёх группах.

Право MCP на инструмент управления не заменяет metrika:write в Яндексе. Наличие metrika:write само по себе не открывает агенту инструменты управления: их нужно разрешить в MCP.

Выбор счётчика по умолчанию не ограничивает доступ одним счётчиком. Инструменты принимают другой counter_id; фактический доступ определяется OAuth-токеном Яндекса.

Группа «Произвольный отчёт» позволяет запрашивать денежные метрики через metrika_query. Поэтому отключение группы «Продажи» при сохранённом доступе к произвольному отчёту не запрещает агенту читать денежные данные.

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

Плагин обращается по HTTPS к api-metrika.yandex.net:

  • в API отчётов (stat/v1/data) отправляет номер счётчика, даты, метрики, измерения и поддерживаемые параметры отчёта;
  • в API управления (management/v1) запрашивает счётчики, цели, сегменты и настройку счётчика;
  • при подтверждённых изменениях отправляет название и домен нового счётчика, условия цели, параметры фильтра либо запрос удаления выбранной цели.

OAuth-токен передаётся Яндексу в заголовке Authorization: OAuth …. Плагин получает статистику из Метрики и не читает заказы из базы Shop-Script для этих отчётов.

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

Сбор статистики на сайте

Код счётчика, передачу электронной коммерции и отправку reachGoal настраивают отдельно на сайте. Плагин работает с уже доступными в Яндекс.Метрике данными. Создание счётчика через агента не начинает сбор посещений автоматически.