Частые вопросы

Где искать настройки?

В приложении MCP → «Плагины» → «Яндекс.Метрика для MCP». Все четыре поля описаны в настройках.

Почему список счётчиков пуст или показывает ошибку?

Сначала заполните «OAuth-токен Яндекса», сохраните и заново откройте настройки. Если появляется token_missing, сохранённый токен пуст. Если написано «В этом аккаунте Метрики нет ни одного счётчика.», API не вернул доступных счётчиков. Проверьте аккаунт Яндекса и доступ к нужному счётчику. Список настроек кешируется на 10 минут; metrika_get_counters запрашивает его заново.

Что означают token_invalid и access_forbidden?

token_invalid означает отказ Яндекса в авторизации: проверьте, что токен скопирован полностью и не отозван. access_forbidden означает отказ в доступе. Проверьте права владельца токена на счётчик, metrika:read для чтения и metrika:write для операций управления. Права токена MCP проверяются отдельно от прав Яндекса.

Что делать с counter_not_configured или not_found?

При counter_not_configured выберите «Счётчик по умолчанию» либо передайте counter_id в вызове. При not_found проверьте номер через metrika_get_counters: API не нашёл счётчик или запрошенный ресурс.

Почему агент не видит инструмент?

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

Почему посещаемость есть, а отчёт о продажах не работает?

Продажи берутся из электронной коммерции Метрики. Сайт должен действительно передавать данные о заказах. Даже при ecommerce_in_code: true API может вернуть ecommerce is not enabled: флаг не подтверждает поступление заказов. Плагин не загружает их из Shop-Script и не настраивает отправку автоматически.

Почему отчёт отличается от интерфейса Метрики?

Сверьте счётчик, даты, часовой пояс счётчика, модель атрибуции и sampling. При выборке запросите accuracy: "full" или сократите период. Популярные страницы и страницы входа используют разные метрики: просмотры и визиты соответственно. Формулы продаж и корзин приведены в статье об отчётах.

Почему посчитались не все цели?

Без goal_id инструмент metrika_get_goal_conversions обрабатывает максимум девять целей. Остальные названы в skipped_goals: запросите их отдельными вызовами с goal_id. Если возвращается no_goals, проверьте цели счётчика через metrika_get_goals.

Почему создание или удаление отклонено?

Для каждой из четырёх операций управления требуется confirm: true; иначе возвращается confirm_required. Удаление цели дополнительно требует точного goal_name. При name_mismatch плагин не удаляет цель. Сверьте название и номер через metrika_get_goals. Удаление необратимо, поэтому сначала проверьте последствия и подтвердите нужную цель.

Агент создал счётчик или цель, но данных нет. Почему?

Код счётчика нужно установить на сайт отдельно. Для цели JavaScript-события сайт должен вызывать reachGoal с идентификатором, указанным при создании цели. Плагин не добавляет этот код. Цель посещения страницы должна иметь условие, соответствующее реальному адресу.

Что делать при rate_limited или недоступности API?

При rate_limited повторите запрос через минуту или сократите период. Плагин уже выполняет до двух повторов для временных ошибок, включая HTTP 429. При проблемах связи проверьте исходящий HTTPS сервера к api-metrika.yandex.net. Сетевые ошибки могут приходить как network_error либо api_error. Подробности сетевых и непредвиденных ошибок разработчик может искать в wa-log/metrika.log.

Что делать при bad_request или ошибке второго периода?

Прочитайте error_message: при bad_request плагин передаёт пояснение API. Проверьте имена и совместимость metrics и dimensions; не смешивайте ym:s:* и ym:pv:*. Не передавайте accuracy: "default".

Для metrika_query в режиме comparison ошибка second_period_incomplete означает, что задана только одна из границ date1_b и date2_b. Передайте обе. При period_not_comparable задайте второй период явно.