Yandex Metrica MCP

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

Яндекс Метрика MCP подключает AI-приложение к веб-аналитике сайта. Спросите на естественном языке, откуда приходят посетители, как меняется конверсия или где растёт доля отказов — ассистент возьмёт данные из вашего счётчика и объяснит результат. Подключение начинается прямо в диалоге: не нужно заранее создавать токен или редактировать конфигурацию.

• Восемь инструментов. Счётчики, цели и отчёты Метрики, подключение и отключение доступа, а также один универсальный запрос к API.
• Отчёты и конверсии. Визиты, пользователи, просмотры, отказы, длительность визита, источники, устройства и цели за выбранный период.
• Подключение в чате. Яндекс откроет страницу входа; одноразовый код действует 10 минут, а сервер проверит доступ к счётчикам сразу после подключения.
• Обычные запросы — только чтение. Специализированные инструменты не меняют счётчики, цели или данные Метрики.
• Без молчаливого обрезания. В отчёте видны итоговые значения и признак выборки; при большой выдаче сервер отмечает, если упёрся в лимит.

Попробуйте первым сообщением:

Сколько визитов, пользователей и отказов было у моего сайта за последнюю неделю?

Подключить сервер · Посмотреть сценарии · Открыть техническую документацию

Увидеть работу за минуту

Вы: Подключи Яндекс Метрику.

Ассистент: Даёт ссылку на вход в Яндекс. Откройте её под аккаунтом, у которого есть доступ к нужным счётчикам, подтвердите доступ и пришлите показанный код.

Вы: Отправляет код из страницы Яндекса.

Ассистент: Подключает Метрику, проверяет, видны ли счётчики, и сообщает результат. Перезапускать приложение не нужно.

Вы: За последние 30 дней покажи источники трафика и конверсию по цели «Оформление заказа».

Ассистент: Находит цель, строит отчёт по источникам и показывает визиты, достижения цели и конверсию. Если Метрика применила выборку, отмечает, что цифры приблизительные.

Содержание

• Быстрый старт
• Что можно поручить
• Как это работает
• Что может изменить данные
• Подключение и настройка
• Данные и телеметрия
• Ограничения
• Техническая документация
• Поддержка

快速开始

需要 Node.js 20 或更高版本。服务通过 npx 启动，因此无需单独安装软件包。

1. 将服务添加到 AI 应用中——下方展开的是 Codex 示例，其他应用的说明收纳在折叠区域中。
2. 输入：“连接 Yandex Metrica”。助手会引导你登录 Yandex，并立即检查是否能看到你的计数器。
3. 提出第一个问题，例如：“上个月哪些来源带来的访问量最多？”

codex mcp add yandex-metrica -- npx -y mcp-yandex-metrica@latest

codex mcp list

claude mcp add --transport stdio --scope user yandex-metrica -- npx -y mcp-yandex-metrica@latest

claude mcp list

{
  "mcpServers": {
    "yandex-metrica": {
      "command": "npx",
      "args": ["-y", "mcp-yandex-metrica@latest"]
    }
  }
}

{
  "mcpServers": {
    "yandex-metrica": {
      "command": "npx",
      "args": ["-y", "mcp-yandex-metrica@latest"]
    }
  }
}

{
  "servers": {
    "yandex-metrica": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-yandex-metrica@latest"]
    }
  }
}

可以交给它做什么

了解网站的运行情况

• “上周的访问量、用户数和浏览量分别是多少？”
• “显示 6 月按天统计的访问量变化。”
• “哪些设备的跳出率更高？”

查找流量来源并评估流量质量

• “显示本月的流量来源，并按访问量排序。”
• “比较自然搜索和广告的用户数与跳出率。”
• “本周哪些来源带来的访问最多？”

分析转化情况

• “计数器中设置了哪些目标？”
• “过去 30 天内，‘下单’目标的转化率是多少？”
• “显示带来最多目标达成次数的来源。”

检查访问权限和数据准确性

• “我可以访问哪些计数器？”
• “显示 Metrica 的连接状态。”
• “这份报告中的数据准确吗？还是 Metrica 使用了抽样数据？”

工作原理

服务使用三个常见实体：

通常，助手会先查找可访问的计数器，然后在需要时查找目标，最后才生成报告。Metrica 的响应中包含所有行的汇总、结果数量和抽样标记。

可能更改数据的操作

服务器会将任意写入标记为可能具有破坏性的操作。AI 应用如何请求确认取决于应用本身；发出此类请求前，请检查路径、方法和数据。

连接和配置

常规使用无需预先准备令牌：

1. 在聊天中请求连接 Яндекс Метрика。
2. 使用有权访问所需计数器的账号打开 Яндекс OAuth 链接。
3. 确认访问权限，并将代码发送给助手。代码有效期为 10 分钟，仅会在运行中的服务器内换成令牌。

服务器使用 PKCE：仅凭聊天中的代码无法换取令牌。获取的令牌会存储在 ~/.config/mcp-yandex-metrica/credentials.json 中，且仅所有者拥有访问权限。保存了 refresh 令牌后，访问权限会自动续期。

CI 和非标准安装可通过环境变量进行配置：

如果使用自有 OAuth 应用，请为其申请**“获取统计数据、读取自己的和受信任计数器的参数”**（metrika:read）权限。

数据和遥测

默认情况下，服务器会发送匿名技术遥测数据：随机安装标识符、事件或工具名称、服务器版本、Node.js 版本、操作系统以及已连接 AI 客户端的信息。遥测数据不包含令牌、计数器数据、工具参数、您的消息或环境变量的值。

要为 Ask Ads MCP 服务禁用遥测，请设置环境变量：

ASKADS_TELEMETRY=0

限制

• Метрика 抽样。 对于较长时间段或复杂报告，API 可能返回近似数据。请查看 sampled 和 sample_share 字段；如需更精确的计算，请缩短时间段或使用 accuracy: "full"。
• 报告大小。 单个请求最多返回 10 000 行。自动分页最多会在 100 页、100 000 行或约 1 MB 数据处停止，并通过 _truncated 字段标记响应不完整。
• 请求重试。 单个请求的超时时间为 60 秒。临时错误时，服务器最多重试三次：GET 在网络错误、429 和 5xx 时重试；POST 和 DELETE 仅在 429 时重试，以免重复执行更改操作。延迟会考虑 Retry-After，且不会超过 30 秒。
• 生产数据。 Метрика 没有沙盒。专用工具只读取数据，但通过任意请求使用 POST 和 DELETE 会更改实际对象。
• 不进行后台监控。 服务器仅在 AI 应用调用时运行，不会自行监控指标。如果应用支持计划任务，可以在其中配置定期请求报告。

Техническая документация

• Каталог MCP-возможностей — страницы по пользовательским задачам для каждого инструмента.
• Все инструменты — параметры, ответы и границы каждого инструмента.
• Документация по разработке — устройство проекта и работа с демо.
• Пакет в npm.
• API Яндекс Метрики.

Поддержка

Нашли ошибку или не хватает сценария? Создайте issue или напишите в Telegram.