Yandex Metrica MCP

Yandex Metrica MCP 将 AI 应用连接到网站的网络分析。用自然语言提问，访客来自哪里、转化率如何变化、或者跳出率在哪里增长——助手会从您的计数器获取数据并解释结果。连接直接在对话中开始：无需提前创建令牌或编辑配置。

• 八个工具。 Metrica 的计数器、目标和报告，连接和断开访问，以及一个通用的 API 请求。

• 报告和转化。 所选期间的访问量、用户数、浏览量、跳出率、访问时长、来源、设备和目标。

• 聊天中连接。 Yandex 会打开登录页面；一次性代码有效期为 10 分钟，服务器会在连接后立即检查对计数器的访问权限。

• 常规请求——只读。 专用工具不会修改计数器、目标或 Metrica 数据。

• 不静默截断。 报告中显示汇总值和抽样标志；当数据量较大时，服务器会标记是否达到限制。

用第一条消息试试：

我的网站上周有多少访问量、用户数和跳出数？

连接服务器 · 查看场景 · 打开技术文档

一分钟了解工作原理

您： 连接 Yandex Metrica。

助手： 提供 Yandex 登录链接。请使用有权访问所需计数器的账户打开它，确认访问权限并发送显示的代码。

您： 发送 Yandex 页面中的代码。

助手： 连接 Metrica，检查计数器是否可见，并报告结果。无需重启应用。

您： 显示最近 30 天的流量来源和「提交订单」目标的转化率。

助手： 找到目标，按来源生成报告，并显示访问量、目标达成数和转化率。如果 Metrica 应用了抽样，会标记数字为近似值。

Related MCP server: ya-metrics-mcp

目录

• 快速开始

• 可以委托什么

• 工作原理

• 什么可能修改数据

• 连接和配置

• 数据和遥测

• 限制

• 技术文档

• 支持

快速开始

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

1. 将服务器添加到 AI 应用——下面是 Codex 的示例，其他应用收集在可折叠说明中。

2. 输入：「连接 Yandex Metrica」。助手会引导您完成 Yandex 登录，并立即检查它是否能看到您的计数器。

3. 提出第一个问题，例如：「上个月哪些来源带来的访问量最多？」

通过应用界面：

1. 打开 Settings → Plugins → MCP servers。

2. 点击 Add server。

3. 添加启动命令 npx -y mcp-yandex-metrica@latest。

通过命令行：

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

检查连接：

codex mcp list

然后在 Codex 聊天中请求：「连接 Yandex Metrica」。

Codex 官方说明

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

用命令检查服务器：

claude mcp list

然后以连接 Metrica 的请求开始对话。

Claude Code 文档

打开 Settings → Developer → Edit Config 并将服务器添加到 claude_desktop_config.json：

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

保存后打开新对话并请求连接 Metrica。

为所有项目创建 ~/.cursor/mcp.json；仅当前项目则创建 .cursor/mcp.json：

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

在 Cursor 聊天中，服务器会出现在可用工具中。请求连接 Metrica 并完成 Yandex 登录。

Cursor 文档

打开命令面板并执行 MCP: Open User Configuration。在 mcp.json 中添加：

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

用 MCP: List Servers 命令检查启动，然后打开聊天并请求连接 Metrica。

VS Code 文档

可以委托什么

了解网站情况

• 「上周有多少访问量、用户数和浏览量？」

• 「显示六月按天计算的访问量趋势」。

• 「哪些设备的跳出率更高？」

找到流量来源并评估其质量

• 「显示一个月的流量来源并按访问量排序」。

• 「按用户数和跳出率比较自然搜索和广告」。

• 「本周哪些来源带来的点击最多？」

分析转化

• 「计数器中配置了哪些目标？」

• 「「提交订单」目标 30 天的转化率是多少？」

• 「显示带来最多目标达成的来源」。

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

• 「我可以访问哪些计数器？」

• 「显示 Metrica 的连接状态」。

• 「这份报告中的数据是准确的还是 Metrica 使用了抽样？」

工作原理

服务器处理三个常见的实体：

通常助手先找到可访问的计数器，然后——如有必要——找到目标，最后才生成报告。Metrica 的响应中包含所有行的汇总、输出大小和抽样标志。

什么可能修改数据

服务器将任意写入标记为潜在破坏性操作。AI 应用如何请求确认取决于应用本身；在此类请求之前请检查路径、方法和数据。

连接和配置

常规使用无需提前准备令牌：

1. 在聊天中请求连接 Yandex Metrica。

2. 使用有权访问所需计数器的账户打开 Yandex OAuth 链接。

3. 确认访问权限并将代码发送给助手。代码有效期为 10 分钟，并且仅在运行中的服务器内部兑换为令牌。

服务器使用 PKCE：聊天中的代码本身无法兑换为令牌。获取的令牌本地存储在 ~/.config/mcp-yandex-metrica/credentials.json 中，权限仅限所有者。在保存了 refresh-token 的情况下，访问权限会自动续期。

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

如果使用自有 OAuth 应用，请在其中请求**「获取统计信息，读取自己和受信任计数器的参数」**（metrika:read）权限。

数据和遥测

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

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

ASKADS_TELEMETRY=0

限制

• Metrica 抽样。 在较长的期间或复杂报告上，API 可能返回近似数据。请查看 sampled 和 sample_share 字段；要获得更精确的计算，请缩小期间或使用 accuracy: "full"。

• 报告大小。 单个请求最多返回 10 000 行。自动分页最多停止在 100 页、100 000 行或约 1 MB 数据，并用 _truncated 字段标记不完整的响应。

• 请求重试。 单个请求的超时为 60 秒。服务器在临时错误时最多重试三次：GET——在网络错误、429 和 5xx 时；POST 和 DELETE——仅在 429 时，以避免重复执行修改操作。延迟考虑 Retry-After 且不超过 30 秒。

• 生产数据。 Metrica 没有沙箱。专用工具读取数据，但通过任意请求的 POST 和 DELETE 会修改真实对象。

• 无后台监控。 服务器在 AI 应用调用时运行，本身不监控指标。如果应用支持计划任务，可以在其中配置定期报告请求。

技术文档

• MCP 能力目录 — 每个工具的用户任务页面。

• 所有工具 — 每个工具的参数、响应和边界。

• 开发文档 — 项目结构和演示操作。

• npm 包。

• Yandex Metrica API。

支持

发现错误或缺少场景？创建 issue 或通过 Telegram 联系我们。