Яндекс Метрика MCP

DevCrabs-Inc/yandex-metrika-mcp· Проверено 12.11.2026· 130на GitHub

Отвечает на вопросы о трафике, источниках, страницах входа и целях Яндекс Метрики только на чтение. К каждому ответу сервер прикладывает точные даты, часовой пояс счётчика, статус сэмплирования и фильтры.

Как подключить

Что сделать до подключения

1

Node.js 22.13 или новее

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio yandex-metrika \
  -- npx -y @dev-crabs/yandex-metrika-mcp

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Собрать вместе с другими серверами в одном mcp.json →

Инструменты сервера

metrika_statusпоказывает подключения и выгрузки
metrika_connectвходит в Метрику через браузер
metrika_disconnectудаляет подключение и токен
metrika_list_countersперечисляет счётчики
metrika_describe_counterпоказывает цели и часовой пояс
metrika_catalogперечисляет метрики и группировки
metrika_run_reportстроит отчёт за период
metrika_compare_periodsсравнивает два периода
metrika_run_timeseriesстроит ряд по дням, неделям, месяцам
metrika_export_reportзапускает полную выгрузку
metrika_get_jobпроверяет статус выгрузки
metrika_cancel_jobотменяет выгрузку
metrika_read_artifactчитает готовый файл выгрузки

Что попросить агента

«Подключи Яндекс Метрику и сравни последние две недели по источникам трафика»Агент вызовет metrika_connect и даст ссылку для входа, затем metrika_list_counters и metrika_compare_periods
«Сравни две последние полные недели по визитам и достижениям цели <ID цели>»Агент вызовет metrika_describe_counter, чтобы найти цель, и metrika_compare_periods
«Какие страницы входа принесли больше всего заявок по цели <цель> в прошлом месяце?»Агент вызовет metrika_run_report с группировкой по странице входа
«Покажи визиты по неделям с начала квартала»Агент вызовет metrika_run_timeseries с шагом в неделю
«Выгрузи все источники трафика за октябрь в CSV для Excel»Агент запустит metrika_export_report, проверит готовность metrika_get_job и прочитает файл metrika_read_artifact

Для каких задач

Сравнить две недели по визитам и достижениям цели
Найти страницы входа, которые приносят больше всего заявок
Показать понедельную динамику визитов с начала квартала
Выгрузить все источники трафика за месяц в CSV для Excel
Разобрать, откуда пришло падение трафика, по готовому сценарию traffic_drop

Ограничения

!

Только чтение: создать цель, поменять счётчик или отправить свой запрос к API нельзя

!

Цифры отчётов уходят в ваш ИИ-клиент и к провайдеру модели; токены туда не попадают

!

В строгом режиме сервер отказывается отдавать сэмплированные цифры как точные

!

Вход через Яндекс и живые отчёты авторы проверили на macOS; другие клиенты и системы ещё в списке проверок

Если не работает

Ошибка AUTH_EXPIRED
Яндекс больше не принимает токен: вызовите metrika_connect с тем же connection_id и войдите заново.
AUTH_NOT_CONFIGURED или ссылка входа не открывается
Ссылка работает 10 минут и только на компьютере, где запущен сервер. Если заняты порты 47613–47615, освободите их или задайте другие в YM_MCP_OAUTH_PORTS.
На Linux без графической оболочки сервер не сохраняет токен
Системного хранилища паролей нет: передайте токен через YANDEX_METRIKA_TOKEN или включите файловое хранилище YM_MCP_SECRET_STORE=file.
Ошибка QUALITY_REQUIREMENT_NOT_MET
В строгом режиме API вернул сэмплированные данные. Сократите период или попросите отчёт с accuracy: "balanced".
Ошибка QUOTA_EXCEEDED
Квота Яндекса исчерпана: подождите до времени retry_at. Суточная квота сбрасывается в 00:00 UTC.

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

Где взять токен Метрики?
Нигде вписывать его не нужно. После установки попросите ассистента подключить Метрику: он вызовет metrika_connect и даст локальную ссылку для входа через браузер. Токен в чат не попадает.
Где хранится токен?
В хранилище учётных данных системы: Keychain на macOS, Credential Manager на Windows, Secret Service на Linux. Если хранилища нет, сервер не сохранит токен, пока вы явно не выберете незашифрованный файл.
Можно попробовать без своего счётчика?
Да, всегда доступно демо-подключение conn_demo с синтетическими цифрами.
Как подключить несколько аккаунтов?
Каждое подключение изолировано и видит только свои счётчики. Подключите аккаунты по очереди через metrika_connect.
Как поставить одной командой?
Команда npx -y @dev-crabs/yandex-metrika-mcp setup --client claude-code сама пропишет конфиг и сохранит резервную копию. Вместо claude-code подходят claude-desktop, cursor, vscode, windsurf и codex.
Работает ли сервер из России?
Сервер запускается на вашем компьютере, вход через ваш аккаунт Яндекса в браузере; зарубежные аккаунты и своё OAuth-приложение не нужны.

Похожие серверы