MCP Яндекс Метрики с управлением счетчиками

@theyahia/yandex-metrika-mcp

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

MCP-сервер

Высокий риск

Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.

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

  • Может безвозвратно удалить счетчик Яндекс Метрики
  • Может создавать и удалять цели, влияя на данные конверсий
  • Нет разделения read-only и write режимов на уровне конфигурации сервера
Все причины и проверки
Российский стек

theyahia/yandex-metrika-mcp

Установка

В терминале, через 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секрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Понадобится: Node.js

Сверено с репозиторием 25 сент. 2026, коммит 2c736e0.

Текст для агента

Получи 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

СкиллСредний рискРоссийский стекБез VPN12Звезды репозитория
Выбор редакции

MCP-сервер Яндекс Метрики, порожденный из спеки API: 108 методов, по умолчанию 10 инструментов, прозрачные фильтры и метаданные ответа

MCP-серверСредний рискРоссийский стекБез VPN2Звезды репозитория
Официальный

Открытый MCP-сервер и набор агентских скиллов для SEO: keyword research, конкуренты, обратные ссылки и аудит сайта по данным DataForSEO

MCP-серверСредний риск21,5 тыс.Звезды репозитория

Плагин Claude Code для SEO-аудита: технический SEO, E-E-A-T, schema, локальный и AI-поиск силами параллельных агентов

ПлагинВысокий риск17,9 тыс.Звезды репозитория
Foxx AIMCP Яндекс Метрики с управлением счетчиками

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.