MCP для Яндекс Метрики: как дать ИИ‑агенту доступ к отчётам

Что агент делает с Метрикой

Через MCP агент получает не интерфейс Метрики, а набор инструментов с понятными параметрами. В «Системно MCP» это:

• metrica_list_counters — список счётчиков, доступных профилю;
• metrica_get_counter — настройки счётчика и его цели;
• metrica_report — отчёт за период по метрикам и группировкам: визиты, посетители, источники, страницы входа, отказы, глубина, цели;
• metrica_api_request — остальные методы API, включая Logs API, импорт данных и управление счётчиком.

Удобные инструменты только читают данные. Изменения через общий запрос к API агент выполняет после явного подтверждения: сначала показывает метод и параметры, потом ждёт вашего ответа.

Как подключить за три шага

1. Создайте OAuth-приложение Яндекса и выберите доступ к Метрике на чтение статистики (metrika:read). Право на запись (metrika:write) нужно, только если агент будет менять настройки счётчика или цели.
2. Откройте «Системно MCP», укажите Client ID и секрет и пройдите авторизацию в браузере. Токены сохраняются в системном защищённом хранилище, а не в JSON-конфигурации агента.
3. Выберите ИИ-клиента. Приложение само зарегистрирует MCP-сервер в его пользовательской конфигурации, и инструменты появятся во всех проектах.

Поддерживаются Codex, Claude Code, Cursor, VS Code с Copilot, Windsurf, Antigravity и Cline CLI. Публичная сборка приложения выпущена для macOS 11 и новее на компьютерах с Apple Silicon.

Примеры запросов

Писать запросы можно обычным языком. Агент сам подберёт метрики и группировки API — например, ym:s:visits, ym:s:bounceRate или ym:s:startURL, — так что помнить их названия не нужно.

• «Сравни визиты из поиска за последние четыре недели с предыдущими четырьмя и покажи страницы входа с самым большим падением».
• «Какие источники трафика приводят к цели “Заявка” и сколько визитов приходится на одну заявку у каждого?»
• «Найди страницы с отказами выше 60% среди тех, у которых больше 100 визитов за месяц».
• «Разбей визиты страницы /pricing по устройствам и сравни конверсию на телефонах и компьютерах».
• «Собери недельную сводку по счётчику и оформи её коротким отчётом для команды».

Ограничения, о которых стоит знать

• На больших периодах отчёты Метрики могут строиться по выборке. Для точных расчётов агент может повысить точность отчёта или выгрузить сырые данные через Logs API.
• У API есть квоты на число запросов. При анализе лучше просить один отчёт с нужными группировками, а не десятки мелких.
• Агент видит только те счётчики, к которым есть доступ у авторизованного аккаунта.
• Цифры сами по себе не объясняют причину. Выводы стоит сверять с изменениями на сайте и с поисковыми данными Вебмастера.

Метрика вместе с другими сервисами

Самые полезные выводы появляются при сопоставлении. Подключите Вебмастер, чтобы видеть, по каким запросам приходят посетители, и Диск, чтобы агент сохранял готовые отчёты в общую папку. Полный цикл улучшения страниц описан в материале «SEO на данных Метрики и Вебмастера».

Короткие ответы