Яндекс Метрика MCP с device flow и Logs API

yandex-metrika-mcp

MCP-сервер Яндекс Метрики для Claude Desktop с OAuth device flow без браузерного редиректа и полным циклом Logs API

perfilev/yandex-metrika-mcpАвтор:perfilev

Установка

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

git clone https://github.com/perfilev/yandex-metrika-mcp.git
cd yandex-metrika-mcp
npm install
npm run build

Сборка сервера перед логином и подключением.

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

Что делает

Сервер дает модели доступ к Reporting, Management, Logs API и реал-тайм отчетам Метрики. Универсальный инструмент get_report принимает любые dimensions, metrics, filters и sort, а пресеты закрывают частые сценарии: трафик и UTM, аудиторию по гео и устройствам, контент и конверсии с воронками. Есть список счетчиков, целей и сегментов, real-time bytime и drilldown и полный цикл Logs API от постановки задачи до скачивания и очистки лога. Авторизация идет через npm run login: скрипт открывает device flow Яндекс OAuth без redirect URI и сохраняет токены в token.json, обновляя их автоматически.

Для кого. Для маркетологов и аналитиков, которым нужен и гибкий произвольный отчет, и сырые данные Logs API в одном сервере.

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

Нужен произвольный отчет с любой комбинацией измерений и метрик через get_report
Нужны сырые визиты из Logs API с конкретными полями вроде ClientID или целей
Не хочется настраивать redirect URI для OAuth: авторизация идет через device flow в терминале

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

Достаточно нескольких готовых отчетов без гибкой настройки: проще взять сервер с именованными инструментами
Нет Node.js окружения для сборки перед первым запуском

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

Сделай воронку по цели id=123 за апрель и покажи топ-20 страниц входа с худшим отказом

Ограничения

Нужно OAuth-приложение Яндекс ID с правами metrika:read, metrika:write, metrika:user_params, metrika:expenses. Токены хранятся в локальном файле token.json рядом с сервером. Лицензии в репозитории нет.

Как отключить. Удалите блок yandex-metrika из claude_desktop_config.json и файл token.json с сохраненными токенами.

MCP

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

Переменные окружения
Переменные окружения
YANDEX_CLIENT_ID обязательная	Client ID OAuth-приложения Яндекс ID
YANDEX_CLIENT_SECRET обязательная, секрет	Client secret OAuth-приложения
TOKEN_PATH обязательная	Путь к файлу token.json с сохраненными токенами

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

Читает подробную статистику и сырые визиты посетителей через Logs API
OAuth-приложение запрашивает права metrika:write и metrika:expenses сверх чтения
Токены хранятся в незашифрованном файле token.json на диске

Коротко о README

README описывает возможности по блокам: универсальный get_report, пресеты, счетчики, real-time, Logs API, дает установку через клонирование и сборку, шаги создания OAuth-приложения и получения токена через npm run login, конфигурацию для Claude Desktop и примеры вопросов на русском.

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

Нужно ли настраивать redirect URI для OAuth?

Нет, npm run login использует device flow: запрашивает device code у Яндекса, показывает код подтверждения и сам сохраняет токены.

Что происходит, когда токен истекает?

Сервер автоматически обновляет access_token по сохраненному refresh_token без повторного входа.

Скиллы 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