Janus Analytics

Janus Analytics MCP Server

一个 MCP 服务，可将 AI 编码 Agent 连接到你的 Janus 分析数据。你可以直接通过 Claude Code、Cursor、Windsurf 或任何兼容 MCP 的客户端查询仪表盘、事件、漏斗和使用情况。

设置

1. 获取具有 Full access 权限范围的 Janus API 密钥

在 addjanus.ca 注册，并在 Settings 中创建 API 密钥。将权限范围设为 Full access。

密钥默认使用 Ingest 权限范围，只能发送事件——使用 Ingest 密钥调用本服务中的任何工具都会返回 403。请专门为 MCP 生成密钥，而不要重复使用网站上的密钥：具有 Full access 权限的密钥可以读取所有分析数据并管理密钥，因此绝不能出现在浏览器代码中。

从早期版本升级？ 推出权限范围功能时，现有密钥已转为 Ingest 权限范围。如果你的工具开始返回 403，请在 Settings 中创建 Full access 密钥，并更新 JANUS_API_KEY。

2. 添加到 MCP 客户端

Claude Code

claude mcp add janus -- npx -y @janus-analytics/mcp-server

然后设置 API 密钥：

export JANUS_API_KEY=jns_your_key_here

Claude Desktop / Cursor / Windsurf

添加到你的 MCP 配置文件：

{
  "mcpServers": {
    "janus": {
      "command": "npx",
      "args": ["-y", "@janus-analytics/mcp-server"],
      "env": {
        "JANUS_API_KEY": "jns_your_key_here"
      }
    }
  }
}

配置文件位置：

• Claude Desktop： ~/Library/Application Support/Claude/claude_desktop_config.json（Mac）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）
• Cursor： Settings > MCP Servers
• Windsurf： ~/.windsurf/mcp.json

工具

所有工具均为只读——本服务绝不会修改你的数据。

工具	描述
get_dashboard_stats	事件数、独立访客数、热门页面、UTM 来源、国家、跳出率和每日趋势，并单独汇总机器人流量。可选的 apiKeyId 筛选条件。
query_events	搜索事件日志，可按类型、标签、日期范围、API 密钥和机器人筛选（默认 exclude，也可选 only、include），并支持分页。
get_usage	本月事件用量与套餐上限、API 密钥数量及各密钥的明细。
list_journeys	列出所有漏斗及其步骤定义、匹配范围和转化时间窗口。
get_journey_results	漏斗转化数据——各步骤的数量、转化率以及步骤间的中位耗时。
list_api_keys	你的 API 密钥，包括名称、前缀、允许的来源和最后使用日期。

提示词示例

连接后，可以向你的 AI Agent 提出这类问题：

• “这周的流量情况怎么样？”
• “显示过去 7 天的热门页面”
• “注册流程的漏斗转化率是多少？”
• “我这个月快达到用量上限了吗？”
• “哪个 API 密钥接收的事件最多？”

配置

环境变量	必填	描述
JANUS_API_KEY	是	你的 Janus API 密钥（以 jns_ 开头）。必须具有 Full access 权限范围

许可证

MIT