Яндекс Метрика MCP: отчеты и цели в Claude, Cursor, Codex

mcp-yandex-metrica

MCP-сервер Метрики на npx с входом через Яндекс OAuth прямо в чате: счетчики, цели, отчеты по визитам и конверсиям, обычные запросы только на чтение

  • 5 ★ репозитория
  • Последний коммит
  • MIT
MCP-сервер

Расширенный доступ

Почему такой уровень

  • Универсальный запрос с confirmWrite=true способен менять и удалять объекты Метрики
  • Сервер по умолчанию отправляет анонимную телеметрию использования на внешний адрес
Все причины и проверки
Российский стек

askads/mcp-yandex-metrica

Установка

Работает в

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/mcp-yandex-metrica

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Универсальный запрос с confirmWrite=true способен менять и удалять объекты Метрики
  • Сервер по умолчанию отправляет анонимную телеметрию использования на внешний адрес

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

Что делает

Сервер на Node.js 20 дает агенту восемь инструментов: список счетчиков, список целей, отчет `get_statistics`, подключение и отключение доступа и универсальный запрос к API Метрики. Отчеты показывают визиты, пользователей, просмотры, отказы, длительность визита, источники, устройства и достижения целей за период, с итогами и пометкой о выборке. Вход идет в чате: сервер выдает ссылку на Яндекс OAuth, вы присылаете одноразовый код, действующий 10 минут, и он обменивается на токен с PKCE. Токен хранится в ~/.config/mcp-yandex-metrica/credentials.json с правами владельца.

Для кого. Владельцы сайтов, маркетологи и SEO-специалисты, которые смотрят трафик Яндекс Метрики и хотят спрашивать про него в чате с агентом.

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

  • Нужны источники трафика и конверсии по цели за месяц без захода в интерфейс Метрики
  • Агент должен найти нужную цель и построить по ней отчет
  • Сервер подключают в CI или нестандартной среде через токен в переменной окружения
  • Нужен доступ к нескольким счетчикам с выбором по умолчанию

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

  • Нужна запись в Метрику: специальные инструменты только читают, запись идет лишь через универсальный запрос с подтверждением
  • Анонимная телеметрия недопустима: по умолчанию сервер отправляет обезличенные события использования
  • Нужны данные Яндекс Директа или Вебмастера: сервер работает только с Метрикой

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

За последние 30 дней покажи источники трафика и конверсию по цели «Оформление заказа»

MCP

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

Переменные окружения

YANDEX_METRIKA_TOKEN секрет
Готовый OAuth-токен с правом metrika:read
YANDEX_METRIKA_COUNTER_ID
Счетчик по умолчанию
ASKADS_TELEMETRY
0 отключает анонимную телеметрию

Ограничения

Специальные инструменты только читают, но универсальный запрос допускает POST и DELETE, они выполняются с `confirmWrite=true` и могут изменить реальные объекты Метрики. Подтверждение зависит от самого AI-приложения. Сервер по умолчанию отправляет анонимную телеметрию на usage.gistrec.cloud: идентификатор копии, названия инструментов и версии окружения, без токена и аргументов. Отключается переменной ASKADS_TELEMETRY=0. Четыре звезды, последний коммит в ноябре 2026 года.

Как отключить. Выполните отключение инструментом `logout`, он удалит токен с компьютера, затем уберите сервер из настроек клиента и отзовите доступ приложения в Яндекс ID.

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

Нужен ли токен заранее?

Нет, обычно вход идет в чате через Яндекс OAuth. Готовый токен задают в YANDEX_METRIKA_TOKEN для CI и нестандартных установок.

Может ли сервер менять данные Метрики?

Только через универсальный запрос: POST и DELETE выполняются с `confirmWrite=true`, остальные инструменты читают.

Какая нужна версия Node.js?

Node.js 20 или новее, сервер запускается через npx без отдельной установки.

Как отключить телеметрию?

Задайте ASKADS_TELEMETRY=0, она также принимает false, off и no.

Где хранится токен?

В файле ~/.config/mcp-yandex-metrica/credentials.json с правами только для владельца.

Обсуждение

Вопросов и отзывов пока нет.

Российский стек

MCP-сервер Яндекс Метрики на 15 инструментов: отчеты и трафик плюс создание, изменение и удаление счетчиков и целей

MCP-серверШирокий доступ1Звезды репозитория

Yandex Metrica MCP

yandex-metrica-mcp

Российский стек

MCP-сервер для Яндекс Метрики только на чтение: отчеты, сравнение периодов, цели и выгрузка сырых логов с входом через браузер

MCP-серверРасширенный доступ15Звезды репозитория

Yandex Metrika MCP

Yandex Metrika MCP Server

Российский стек

MCP-сервер для отчетов Яндекс Метрики: трафик, источники, поисковые фразы, цели, география, устройства и контент-аналитика

MCP-серверРасширенный доступ24Звезды репозитория
Российский стек

MCP-сервер только для чтения: отчеты Яндекс Метрики с точными датами, часовым поясом и признаком семплирования.

MCP-серверРасширенный доступ130Звезды репозитория
Российский стек

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

MCP-серверРасширенный доступ
Российский стек

MCP-сервер, CLI и Pydantic-модели для API Яндекс Метрики: отчеты, счетчики, цели, фильтры, сегменты, логи и загрузка офлайн-конверсий

MCP-серверШирокий доступ2Звезды репозитория

Коротко о README

README ведет от сценария из диалога к быстрому старту для Codex и других клиентов, описывает возможности, изменяющие действия, подключение, телеметрию и ограничения, а в docs лежит документация по каждому инструменту.

Бейдж для README

Сообщить о проблеме