Яндекс Метрика MCP: компактный сервер отчетов
yandex-metrika-mcp-server
Небольшой MCP-сервер для Reports API Яндекс Метрики на официальном SDK, без лишних инструментов и настроек
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- По коду вызывает только отчетные методы Reports API, изменяющих вызовов не видно
Установка
Ручная установка
git clone https://github.com/clientssukach-lang/yandex-metrika-mcp-server.git
cd yandex-metrika-mcp-server
npm installУстановка зависимостей, README в репозитории нет.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер построен на официальном MCP SDK, Express и Zod и обращается к Reports API Яндекс Метрики по OAuth-токену. Весь код умещается в один файл server.js, собранный из исходников на TypeScript, поддерживает и stdio, и Streamable HTTP транспорт. Понятные подсказки об ошибках зашиты прямо в код: при коде 400 сервер советует проверить имена метрик и измерений и формат даты, при ошибке 401 перевыпустить токен, что заметно упрощает отладку по сравнению с сырыми ошибками API.
Для кого. Для разработчиков, которым нужен минималистичный сервер отчетов Метрики без объемной документации и лишних настроек.
Подходит, если
- Нужен маленький, легко читаемый сервер отчетов Метрики на одном файле
- Устраивает работа только с Reports API, без управления счетчиками и целями
- Нужны понятные подсказки об ошибках авторизации и формата запроса прямо в ответе
Не подходит, если
- Нужно управление счетчиками, целями или сегментами: сервер дает только отчеты
- Нужна подробная документация: README в репозитории нет, разбираться приходится по коду
Пример запроса к агенту
Покажи визиты и просмотры по счетчику 44147844 за последние 30 днейОграничения
В репозитории нет README: назначение переменных и формат вызовов видны только из кода server.js и package.json. Работает только с Reports API, Management API недоступен. Нужен OAuth-токен Метрики.
Как отключить. Удалите блок yandex-metrika-mcp-server из конфигурации MCP-клиента.
MCP
- Транспорт
- stdio, http
- Авторизация
- OAuth
| Переменные окружения | |
|---|---|
| METRIKA_OAUTH_TOKEN обязательная, секрет | OAuth-токен Яндекс Метрики |
| METRIKA_API_BASE_URL | Базовый URL API, по умолчанию api-metrika.yandex.net |
Проверка безопасности
- По коду вызывает только отчетные методы Reports API, изменяющих вызовов не видно
Коротко о README
README отсутствует. Из package.json видно название yandex-metrika-mcp-server, зависимости modelcontextprotocol/sdk, express и zod и команду запуска node server.js. Из кода server.js видно обращение к api-metrika.yandex.net по токену METRIKA_OAUTH_TOKEN с обработкой ошибок 400, 401 и 403 понятными подсказками.
Частые вопросы
Почему нет README?
В репозитории README отсутствует, назначение сервера и переменных понятно из package.json и кода server.js.
Можно ли управлять счетчиками через этот сервер?
Нет, судя по коду он вызывает только Reports API Метрики, Management API не реализован.
Похожие
Скиллы DataLens
DataLens Skills
Официальные скиллы DataLens (Яндекс) для Claude Code, Codex и OpenCode: SDK, HTML-отчеты и разбор прав RLS
MCP Яндекс Метрики со всеми 108 методами API
Yandex Metrika MCP Server
MCP-сервер Яндекс Метрики, порожденный из спеки API: 108 методов, по умолчанию 10 инструментов, прозрачные фильтры и метаданные ответа
Открытый MCP-сервер и набор агентских скиллов для SEO: keyword research, конкуренты, обратные ссылки и аудит сайта по данным DataForSEO
Плагин Claude Code для SEO-аудита: технический SEO, E-E-A-T, schema, локальный и AI-поиск силами параллельных агентов