Яндекс Метрика MCP: 68 инструментов Reports и Management API

@rezlazy/yandex-metrika-mcp

MCP-сервер с 68 инструментами Метрики: 6 отчетных и 62 управляющих для счетчиков, целей, фильтров, доступов и сегментов

Установка

Ручная установка

{
  "mcpServers": {
    "yandex-metrika": {
      "command": "npx",
      "args": ["-y", "github:Rezlazy/yandex-metrika-mcp#v0.2.2"],
      "env": {
        "METRIKA_TOKEN": "<your-oauth-token>"
      }
    }
  }
}

Для .cursor/mcp.json или настроек MCP в Cursor, тег пинит рабочую версию.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер оборачивает Reports API и Management API Яндекс Метрики. Шесть отчетных инструментов покрывают табличный отчет, временной ряд, drilldown, сравнение сегментов, сравнение с drilldown и сводную таблицу. 62 управляющих инструмента работают с Management API: список и создание счетчиков, цели, фильтры, операции, права доступа, сегменты, аннотации на графиках, метки, аккаунты, доверенные пользователи, клиенты и облачные экспорты. Для POST и PUT запросов JSON передается прямо в параметре body по формату Management API. Ставится как пакет из GitHub через npx или локально из исходников.

Для кого. Для агентств и аналитиков, которым нужно управлять множеством счетчиков Метрики и их настройками, а не только читать отчеты.

Подходит, если

Нужно массово создавать или настраивать цели и сегменты в нескольких счетчиках
Нужно управлять доступами и доверенными пользователями счетчика через агента
Нужен и отчет, и административное действие в одном сервере вместо двух разных инструментов

Не подходит, если

Нужны только отчеты для чтения: 62 управляющих инструмента создают риск случайного изменения настроек
Работаете в мультикорневом воркспейсе Cursor: известное ограничение мешает подхватить проектный .cursor/mcp.json

Пример запроса к агенту

Создай новую цель посещения страницы оплаты в счетчике 44147844 и покажи топ-10 источников по визитам за 30 дней

Ограничения

Нужен OAuth-токен с правами metrika:read и, для управляющих операций, metrika:write. В мультикорневых воркспейсах Cursor проектный .cursor/mcp.json может не подхватываться, README описывает обходные пути через открытие папки напрямую или глобальный конфиг. Версия v0.2.0 не собирается из git, нужно закреплять более новый тег.

Как отключить. Удалите блок yandex-metrika из .cursor/mcp.json или другого конфига MCP-клиента.

MCP

Транспорт: stdio
Авторизация: OAuth

Переменные окружения
Переменные окружения
METRIKA_TOKEN обязательная, секрет	OAuth-токен с правами metrika:read и опционально metrika:write
METRIKA_API_URL	Базовый URL API, по умолчанию api-metrika.yandex.net

Проверка безопасности

62 управляющих инструмента создают, изменяют и удаляют счетчики, цели, фильтры и права доступа
Токен с metrika:write дает право менять настройки боевых счетчиков

Коротко о README

README дает требования и получение OAuth-токена, конфигурацию для Cursor через npx с закрепленным релизом, раздел про известное ограничение мультикорневых воркспейсов, таблицы отчетных и часто используемых управляющих инструментов, описание параметров отчетов с примерами visits by traffic source и daily trend, и команды разработки.

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

Почему в Cursor не видно сервера из проектного конфига?

Известное ограничение Cursor с мультикорневыми воркспейсами: откройте репозиторий папкой напрямую или добавьте сервер в глобальный ~/.cursor/mcp.json.

Как передать данные для создания счетчика или цели?

В параметре body управляющего инструмента передается JSON в формате, который ожидает Management API Метрики.

Скиллы DataLens

DataLens Skills

Официальный

Официальные скиллы DataLens (Яндекс) для Claude Code, Codex и OpenCode: SDK, HTML-отчеты и разбор прав RLS

СкиллСредний рискРоссийский стекБез VPN12

MCP Яндекс Метрики со всеми 108 методами API

Yandex Metrika MCP Server

Выбор редакции

MCP-сервер Яндекс Метрики, порожденный из спеки API: 108 методов, по умолчанию 10 инструментов, прозрачные фильтры и метаданные ответа

MCP-серверСредний рискРоссийский стекБез VPN2

OpenSEO