Yandex Metrika MCP — MCP-сервер для Claude Code: аналитика и отчёты
MCP-сервер даёт ИИ-агенту доступ к API Яндекс Метрики: трафик, источники, география, поисковые фразы и свои отчёты. Пригодится, когда нужно спросить про статистику сайта прямо в чате.
claude mcp add yandex-metrika-mcp -e YANDEX_METRIKA_TOKEN=<YANDEX_METRIKA_TOKEN> -- npx -y @stufently/yandex-metrika-mcpЧто делает Yandex Metrika MCP
Сервер отдаёт агенту 12 инструментов. Пять из них управляют счётчиками: список сайтов, детали счётчика, цели, создание и удаление. Шесть отвечают за отчёты — сводка по визитам, источники трафика, география, устройства, популярные страницы и поисковые фразы. Последний, get-report, принимает произвольные метрики и измерения Метрики.
Для работы нужен OAuth-токен в переменной YANDEX_METRIKA_TOKEN. Чтения хватает скоупа metrika:read, но create-counter и delete-counter без metrika:write получат 403 — причём в момент вызова, а не при настройке. Токен можно получить интерактивно: node packages/yandex-metrika-mcp/src/index.mjs auth открывает браузер и возвращает токен. Если нужен доступ только на чтение, скоуп задаётся через YANDEX_METRIKA_SCOPE="metrika:read".
delete-counter необратим, поэтому требует confirm: true в аргументах — без него инструмент возвращает ошибку и ничего не отправляет в API. Строка "true", число 1 и "yes" не считаются. Пакет опубликован как @stufently/yandex-metrika-mcp; имя без скоупа принадлежит другому издателю, поэтому берите именно это. Отчёты по умолчанию охватывают последние 30 дней.
Какие задачи решает
- спросить у агента, сколько визитов было на сайте за месяц
- разобрать источники трафика и найти просевшие каналы
- посмотреть, из каких городов приходят пользователи
- выгрузить топ поисковых фраз без захода в веб-интерфейс
- собрать свой отчёт по метрикам и измерениям Метрики
Примеры запросов агенту
- Покажи сводку по трафику счётчика 12345 за последние 30 дней
- Какие источники дали больше всего визитов на прошлой неделе?
- Выполни
get-reportпо счётчику 12345 с метрикойym:s:visitsи измерениемym:s:trafficSource
Как установить Yandex Metrika MCP
Командой платформы
claude mcp add yandex-metrika-mcp -e YANDEX_METRIKA_TOKEN=<YANDEX_METRIKA_TOKEN> -- npx -y @stufently/yandex-metrika-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add yandex-metrika-mcp --env YANDEX_METRIKA_TOKEN=<YANDEX_METRIKA_TOKEN> -- npx -y @stufently/yandex-metrika-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"yandex-metrika-mcp": {
"command": "npx",
"args": [
"-y",
"@stufently/yandex-metrika-mcp"
],
"env": {
"YANDEX_METRIKA_TOKEN": "<YANDEX_METRIKA_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"yandex-metrika-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@stufently/yandex-metrika-mcp"
],
"env": {
"YANDEX_METRIKA_TOKEN": "<YANDEX_METRIKA_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e YANDEX_METRIKA_TOKEN=<YANDEX_METRIKA_TOKEN> yandex-metrika-mcp npx -y @stufently/yandex-metrika-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Yandex Metrika MCP
Как установить Yandex Metrika MCP в Claude Code?
Одной командой: claude mcp add yandex-metrika-mcp -e YANDEX_METRIKA_TOKEN=<YANDEX_METRIKA_TOKEN> -- npx -y @stufently/yandex-metrika-mcp. Токен подставьте свой.
Что делает Yandex Metrika MCP?
Даёт агенту 12 инструментов для API Яндекс Метрики: список счётчиков и целей, создание и удаление счётчиков, отчёты по трафику, источникам, географии, устройствам, популярным страницам и поисковым фразам, а также произвольные отчёты через get-report.
Почему delete-counter отказывается работать?
Ему нужен явный confirm: true в аргументах и скоуп metrika:write. Без подтверждения инструмент возвращает ошибку и ничего не отправляет в API, потому что удаление счётчика необратимо.
