askads/mcp-yandex-metrica

**Яндекс Метрика MCP** подключает AI-приложение к веб-аналитике сайта. Спросите на естественном языке, откуда приходят посетители, как меняется конверсия или где растёт доля отказов — ассистент возьмёт данные из вашего счётчика и объяснит результат. Подключение начинается прямо в диалоге: не нужно заранее создавать токен или редактировать конфигурацию.
- **Восемь инструментов.** Счётчики, цели и отчёты Метрики, подключение и отключение доступа, а также один универсальный запрос к API.
- **Отчёты и конверсии.** Визиты, пользователи, просмотры, отказы, длительность визита, источники, устройства и цели за выбранный период.
- **Подключение в чате.** Яндекс откроет страницу входа; одноразовый код действует 10 минут, а сервер проверит доступ к счётчикам сразу после подключения.
- **Обычные запросы — только чтение.** Специализированные инструменты не меняют счётчики, цели или данные Метрики.
- **Без молчаливого обрезания.** В отчёте видны итоговые значения и признак выборки; при большой выдаче сервер отмечает, если упёрся в лимит.
Попробуйте первым сообщением:
> Сколько визитов, пользователей и отказов было у моего сайта за последнюю неделю?
Подключить сервер · Посмотреть сценарии · Открыть техническую документацию
---
Увидеть работу за минуту
> **Вы:** Подключи Яндекс Метрику.
>
> **Ассистент:** Даёт ссылку на вход в Яндекс. Откройте её под аккаунтом, у которого есть доступ к нужным счётчикам, подтвердите доступ и пришлите показанный код.
>
> **Вы:** Отправляет код из страницы Яндекса.
>
> **Ассистент:** Подключает Метрику, проверяет, видны ли счётчики, и сообщает результат. Перезапускать приложение не нужно.
>
> **Вы:** За последние 30 дней покажи источники трафика и конверсию по цели «Оформление заказа».
>
> **Ассистент:** Находит цель, строит отчёт по источникам и показывает визиты, достижения цели и конверсию. Если Метрика применила выборку, отмечает, что цифры приблизительные.
Содержание
- Быстрый старт
- Что можно поручить
- Как это работает
- Что может изменить данные
- Подключение и настройка
- Данные и телеметрия
- Ограничения
- Техническая документация
- Поддержка
Быстрый старт
Нужен Node.js 20 или новее. Сервер запускается через npx, поэтому отдельно устанавливать пакет не требуется.
1. Добавьте сервер в AI-приложение — ниже открыт пример для Codex, остальные приложения собраны в сворачиваемые инструкции.
2. Напишите: «Подключи Яндекс Метрику». Ассистент проведёт через вход в Яндекс и сразу проверит, что ему видны ваши счётчики.
3. Задайте первый вопрос, например: «Какие источники дали больше всего визитов за прошлый месяц?»
Codex
**Через интерфейс приложения:**
1. Откройте **Settings → Plugins → MCP servers**.
2. Нажмите **Add server**.
3. Добавьте команду запуска npx -y mcp-yandex-metrica@latest.
**Через командную строку:**
Проверьте подключение:
Затем в чате Codex попросите: «Подключи Яндекс Метрику».
Официальная инструкция Codex
Claude Code
Проверьте сервер командой:
Затем начните диалог с просьбы подключить Метрику.
Документация Claude Code
Claude Desktop
Откройте **Settings → Developer → Edit Config** и добавьте сервер в claude_desktop_config.json:
После сохранения откройте новый диалог и попросите подключить Метрику.
Cursor
Для всех проектов создайте ~/.cursor/mcp.json; только для текущего проекта — .cursor/mcp.json:
В чате Cursor сервер появится среди доступных инструментов. Попросите подключить Метрику и пройдите вход через Яндекс.
Документация Cursor
VS Code
Откройте палитру команд и выполните **MCP: Open User Configuration**. Добавьте в mcp.json:
Проверьте запуск командой **MCP: List Servers**, затем откройте чат и попросите подключить Метрику.
Документация VS Code
Что можно поручить
Понять, что происходит с сайтом