MCP Яндекс Метрики с управлением счетчиками
@theyahia/yandex-metrika-mcp
MCP-сервер Яндекс Метрики на 15 инструментов: отчеты и трафик плюс создание, изменение и удаление счетчиков и целей
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Может безвозвратно удалить счетчик Яндекс Метрики
- Может создавать и удалять цели, влияя на данные конверсий
- Нет разделения read-only и write режимов на уровне конфигурации сервера
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/theyahia-yandex-metrika-mcpОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.
Выполните в терминале
claude mcp add --transport stdio --env 'YANDEX_METRIKA_TOKEN=<ваш YANDEX_METRIKA_TOKEN>' yandex-metrika -- npx -y @theyahia/yandex-metrika-mcpИли добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"yandex-metrika": {
"command": "npx",
"args": [
"-y",
"@theyahia/yandex-metrika-mcp"
],
"env": {
"YANDEX_METRIKA_TOKEN": "<ваш YANDEX_METRIKA_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
YANDEX_METRIKA_TOKENсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"yandex-metrika": {
"command": "npx",
"args": [
"-y",
"@theyahia/yandex-metrika-mcp"
],
"env": {
"YANDEX_METRIKA_TOKEN": "<ваш YANDEX_METRIKA_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Ключи и настройки
YANDEX_METRIKA_TOKENсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
code --add-mcp '{"name":"yandex-metrika","type":"stdio","command":"npx","args":["-y","@theyahia/yandex-metrika-mcp"],"env":{"YANDEX_METRIKA_TOKEN":"<ваш YANDEX_METRIKA_TOKEN>"}}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"yandex-metrika": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@theyahia/yandex-metrika-mcp"
],
"env": {
"YANDEX_METRIKA_TOKEN": "<ваш YANDEX_METRIKA_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Ключи и настройки
YANDEX_METRIKA_TOKENсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
codex mcp add yandex-metrika --env 'YANDEX_METRIKA_TOKEN=<ваш YANDEX_METRIKA_TOKEN>' -- npx -y @theyahia/yandex-metrika-mcpИли добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.yandex-metrika]
command = "npx"
args = ["-y", "@theyahia/yandex-metrika-mcp"]
env = { YANDEX_METRIKA_TOKEN = "<ваш YANDEX_METRIKA_TOKEN>" }Если файл уже есть, допишите блок в конец.
Ключи и настройки
YANDEX_METRIKA_TOKENсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"yandex-metrika": {
"command": "npx",
"args": [
"-y",
"@theyahia/yandex-metrika-mcp"
],
"env": {
"YANDEX_METRIKA_TOKEN": "<ваш YANDEX_METRIKA_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
YANDEX_METRIKA_TOKENсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"yandex-metrika": {
"command": "npx",
"args": [
"-y",
"@theyahia/yandex-metrika-mcp"
],
"env": {
"YANDEX_METRIKA_TOKEN": "<ваш YANDEX_METRIKA_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Ключи и настройки
YANDEX_METRIKA_TOKENсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"yandex-metrika": {
"command": "npx",
"args": [
"-y",
"@theyahia/yandex-metrika-mcp"
],
"env": {
"YANDEX_METRIKA_TOKEN": "<ваш YANDEX_METRIKA_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Ключи и настройки
YANDEX_METRIKA_TOKENсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"yandex-metrika": {
"command": "npx",
"args": [
"-y",
"@theyahia/yandex-metrika-mcp"
],
"env": {
"YANDEX_METRIKA_TOKEN": "<ваш YANDEX_METRIKA_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
YANDEX_METRIKA_TOKENсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"yandex-metrika": {
"type": "local",
"command": [
"npx",
"-y",
"@theyahia/yandex-metrika-mcp"
],
"environment": {
"YANDEX_METRIKA_TOKEN": "<ваш YANDEX_METRIKA_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Ключи и настройки
YANDEX_METRIKA_TOKENсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"yandex-metrika": {
"command": "npx",
"args": [
"-y",
"@theyahia/yandex-metrika-mcp"
],
"env": {
"YANDEX_METRIKA_TOKEN": "<ваш YANDEX_METRIKA_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Ключи и настройки
YANDEX_METRIKA_TOKENсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"yandex-metrika": {
"command": "npx",
"args": [
"-y",
"@theyahia/yandex-metrika-mcp"
],
"env": {
"YANDEX_METRIKA_TOKEN": "<ваш YANDEX_METRIKA_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
YANDEX_METRIKA_TOKENсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Получи OAuth-токен на oauth.yandex.ru с доступом к Яндекс Метрике, затем добавь сервер командой claude mcp add yandex-metrika -e YANDEX_METRIKA_TOKEN=токен -- npx -y @theyahia/yandex-metrika-mcp.
Другие способы из описания автора
{
"mcpServers": {
"yandex-metrika": {
"command": "npx",
"args": ["-y", "@theyahia/yandex-metrika-mcp"],
"env": {
"YANDEX_METRIKA_TOKEN": "your_token"
}
}
}
}Конфигурация для Claude Desktop из README.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает 15 инструментов по четырем направлениям API Яндекс Метрики. Управление счетчиками: список, детали по ID, создание нового счетчика, изменение имени или адреса сайта и безвозвратное удаление. Управление целями: список, создание с типами url, number, step, action и удаление. Логи: экспорт сырых данных визитов и хитов через Logs API. Отчеты: гибкий отчет с любыми метриками, измерениями, фильтрами и сортировкой, сравнение двух периодов и иерархический drill-down. Удобные обертки: сводка по трафику, разбивка источников по каналам и топ страниц по просмотрам. Сервер можно запускать локально по stdio через npx или как HTTP-сервер для удаленных и многоклиентских сценариев с эндпоинтом /mcp и проверкой здоровья /health, есть готовый smithery.yaml и скилл analytics-report для Claude Code.
Для кого. Для маркетологов и агентств, которым нужно не только читать отчеты Метрики, но и создавать счетчики и цели прямо из диалога с агентом.
Подходит, если
- Нужно быстро создать новый счетчик или цель для нового проекта
- Нужен гибкий отчет с произвольными метриками и сравнением периодов
- Нужен удаленный HTTP-режим для нескольких клиентов вместо локального stdio
Не подходит, если
- Нужен строго read-only доступ без риска случайно удалить счетчик или цель: здесь delete_counter необратим и доступен без отдельного подтверждения
- Токен планируется выдавать только с правом чтения: сервер использует общий OAuth Bearer без разделения на read и write скоупы в конфигурации
Пример запроса к агенту
Сравни трафик прошлой недели с предыдущей для счетчика 12345678Ограничения
Удаление счетчика необратимо, README прямо это отмечает. Нужен OAuth Bearer токен Яндекса, README показывает получение токена только с правом чтения статистики, хотя сервер предоставляет и пишущие инструменты, поэтому для записи токену нужны более широкие права, полученные отдельно. Нет разделения инструментов на read-only и write режимы на уровне конфигурации сервера.
Как отключить. Удалите сервер командой claude mcp remove yandex-metrika и отзовите OAuth-токен на oauth.yandex.ru.
MCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| YANDEX_METRIKA_TOKEN обязательная, секрет | OAuth 2.0 Bearer токен Яндекса |
Проверка безопасности
- Может безвозвратно удалить счетчик Яндекс Метрики
- Может создавать и удалять цели, влияя на данные конверсий
- Нет разделения read-only и write режимов на уровне конфигурации сервера
Коротко о README
README на английском описывает сервер как часть серии Russian API MCP от автора theYahia. Дана инструкция получения OAuth-токена с правом чтения статистики, установка для Claude Desktop и Claude Code через npx, запуск в режиме streamable HTTP для удаленных сценариев и через Smithery. Таблица из 15 инструментов разбита на управление счетчиками, целями, логами, отчеты и удобные обертки для трафика, источников и топ страниц. Даны демо-промпты и команды разработки. Лицензия MIT.
Частые вопросы
Можно ли отменить удаление счетчика?
Нет, README прямо указывает, что delete_counter удаляет счетчик безвозвратно.
Можно ли запустить сервер как удаленный HTTP-эндпоинт?
Да, флаг --http и --port поднимает сервер как streamable HTTP с эндпоинтом /mcp и проверкой здоровья /health для нескольких клиентов.
Похожие
Скиллы 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-поиск силами параллельных агентов