Mitr Analytics

@mitr-analytics/mcp

用通俗英语询问 Claude、Gemini 或其他 MCP 客户端，了解你的 Mitr 分析数据。它会读取你自己的数据（应用、报告、漏斗、提醒、套餐用量），并交给助手进行分析。

Mitr 是无 Cookie 分析工具，因此无需配置同意横幅；这里的任何操作都不会改变这一点：此服务只会读取你控制面板中已有的数据。

你可以询问什么

• “我有哪些应用本周访客数量降幅最大？原因是什么？”
• “显示我过去 30 天的注册漏斗。用户在哪一步离开？”
• “我的营销网站最近的事件中有异常吗？UTM 标签是否正常传入？”
• “我每月的事件配额已用了多少？”
• “注册一个名为 Docs、用于 docs.example.com 的新 Web 应用。”

设置（约两分钟）

你需要一个 Mitr 账户。使用托管端点无需安装任何内容。

1. 创建 API 密钥。 在控制面板中打开 Settings → API keys & AI assistants → Create key，为密钥命名（例如“Claude Code”），然后复制。密钥只会显示一次。

除非创建密钥时勾选相应权限，否则密钥为只读：“Can register apps”、“Can manage funnels”、“Can manage QR campaigns”、“Can manage webhooks”和“Can delete”（此权限还需要同时拥有一项管理权限）。密钥默认在 365 天后过期（可选择 30、90、365 天或永不过期）。如果你离开或被移出创建该密钥的工作区，密钥将失效。

2. 连接你的助手。

托管方式（无需安装）

让任何支持远程 MCP 服务的客户端连接到 https://mcp.mitranalytics.dev/mcp，并在 Authorization 标头中发送密钥。切勿将密钥放入 URL；该端点会拒绝此类请求。

Claude Code：

claude mcp add --transport http mitr https://mcp.mitranalytics.dev/mcp --header "Authorization: Bearer mitr_live_..."

Cursor（~/.cursor/mcp.json）：

{
  "mcpServers": {
    "mitr": {
      "url": "https://mcp.mitranalytics.dev/mcp",
      "headers": { "Authorization": "Bearer mitr_live_..." }
    }
  }
}

VS Code（.vscode/mcp.json）：

{
  "servers": {
    "mitr": {
      "type": "http",
      "url": "https://mcp.mitranalytics.dev/mcp",
      "headers": { "Authorization": "Bearer mitr_live_..." }
    }
  }
}

Gemini CLI（~/.gemini/settings.json）：

{
  "mcpServers": {
    "mitr": {
      "httpUrl": "https://mcp.mitranalytics.dev/mcp",
      "headers": { "Authorization": "Bearer mitr_live_..." }
    }
  }
}

本地方式（npx）

适用于通过命令运行的客户端，例如 Claude Desktop。你需要 Node.js 18 或更高版本。打开 claude_desktop_config.json（macOS：~/Library/Application Support/Claude/，Windows：%APPDATA%\Claude\）并添加：

{
  "mcpServers": {
    "mitr": {
      "command": "npx",
      "args": ["-y", "@mitr-analytics/mcp"],
      "env": { "MITR_API_KEY": "mitr_live_..." }
    }
  }
}

同样的方法也适用于 Claude Code（claude mcp add mitr --env MITR_API_KEY=mitr_live_... -- npx -y @mitr-analytics/mcp）和 Gemini CLI；如果你更喜欢在本地运行，也可以使用这种方式。

3. 提出问题（如果是本地配置，请先重启助手）。控制面板会显示密钥上次使用的时间。

工具

工具	功能
list_apps	工作区中的所有应用，以及其他工具所需的 siteId。
get_app_report	某个应用的 7 天报告：访客数、页面浏览量、流量、来源、国家/地区、设备、Web Vitals 和转化。
get_recent_events	某个应用的最新原始事件，用于检查实际跟踪的内容。
list_funnels	已保存的转化漏斗。
get_funnel_results	某个漏斗在指定日期范围内的逐步转化和流失情况。
get_alert_rule	流量激增/骤降提醒设置（如果已设置）。
get_billing_usage	套餐、订阅状态和事件用量。
get_workspace_overview	汇总所有应用的流量、Webhooks、QR 活动和漏斗，并列出需要注意的事项。
list_qr_campaigns	QR 活动及其 ID、状态、扫描总数和套餐的 QR 限额。
get_qr_campaign	某个活动及其代码和每个代码的扫描次数。
get_webhook_health	每个 Webhook 端点的状态分类投递次数和最新失败记录。绝不返回有效负载。
add_app	注册新应用。需要“可注册应用”权限。不返回应用的密钥：请从控制面板复制。
create_funnel、update_funnel	根据按顺序排列的页面路径或事件步骤创建漏斗，或替换漏斗名称和步骤。需要“可管理漏斗”权限。
delete_funnel	永久删除漏斗。需要“可管理漏斗”和“可删除”权限。
create_qr_campaign、update_qr_campaign	创建将扫描者引导至 https URL 的活动，或重命名活动、更改目标网址，或将其状态设为启用、暂停或归档。需要“可管理 QR 活动”权限。
add_qr_code	向活动添加可打印的代码，并标注其放置位置。需要“可管理 QR 活动”权限。
create_webhook、update_webhook	创建 https Webhook 端点，或更改其 URL 和事件类型，或将其暂停。不返回签名密钥：请从控制面板复制。需要“可管理 Webhooks”权限。
delete_webhook	永久删除 Webhook 端点。需要“可管理 Webhooks”和“可删除”权限。

密钥上的每项更改操作都需要单独的权限，删除操作还需要“可删除”权限。助手无法使用提醒和团队管理功能。

安全与隐私

• 密钥能查看你能查看的内容。 它对工作区的读取权限与你在控制面板中的权限相同。请像对待密码一样保管它。
• 可随时撤销密钥，路径：Settings → API keys。撤销后会立即失效。
• 密钥以纯文本形式保存在助手的配置文件中。 每个工具使用单独的密钥，这样撤销其中一个密钥时不会影响其他工具。
• 你使用的 AI 提供商会看到你查询的数据。 报告和近期事件（页面路径、UTM 标签、设备和位置摘要，以及你发送的任何自定义事件属性）会返回给助手，因此受该提供商的条款约束。Mitr 本身仅通过哈希标识符识别访客；请参阅我们如何在不使用 Cookie 的情况下统计访客。
• 访客数据会标记为不可信。 页面路径、引荐来源、UTM 标签和事件属性由访客填写，因此任何人都可以在其中写入文本，包括针对 AI 的文本。报告和近期事件会清除隐藏字符，并置于 untrusted_data 封装中返回，告知助手将其视为数据，绝不可视为指令。
• 对话中不会包含密钥。 add_app 不会返回新应用的 SDK 密钥，Webhook 工具也不会返回签名密钥；请从控制面板复制。
• 密钥始终仅通过 HTTPS 发送（仅接受 localhost 的纯文本 http://）。

计划

在早期访问期间，MCP 服务适用于所有 Mitr 计划，包括 Free。早期访问结束后，MCP 服务将纳入付费计划；届时，Free 工作区会收到一条指向定价页面的消息，升级后使用同一个密钥即可恢复访问。

故障排除

托管版：在浏览器中打开 https://mcp.mitranalytics.dev/；应显示服务版本。本地版：在终端中运行 npx -y @mitr-analytics/mcp --version。如果其中任一方式可用，问题就在客户端配置中。

你看到的内容	解决方法
MITR_API_KEY is not set	客户端配置中的 env 块缺失或位置不正确。
"Your Mitr API key was rejected"	密钥已过期、已撤销、复制有误，或者你已不在该密钥所属的工作区中。在 Settings → API keys 中创建新密钥。
"missing the 'apps:write' permission"（或 funnels:write、qr:write、webhooks:write、delete）	该密钥没有此权限。创建密钥时勾选该权限，即可使用此工具。
"early-access period has ended for the Free plan"	升级工作区；同一个密钥将恢复使用。
托管端点返回 401	客户端配置中缺少 Authorization: Bearer mitr_live_… 标头，或其格式错误。
"Mitr is rate-limiting this key"	短时间内请求过多。请等待一分钟。
npx: command not found	安装 Node.js 18+，然后重启助手，以便它获取新的 PATH。
"Could not reach Mitr"	检查你的网络连接或代理。仅在有人告知你设置时，才设置 MITR_API_BASE_URL。

配置

变量	必需	默认值
MITR_API_KEY	是	无
MITR_API_BASE_URL	否	https://api.mitranalytics.dev

开发

npm install
npm test                                        # builds, then unit tests + an end-to-end stdio test against a stub API
npx @modelcontextprotocol/inspector node dist/index.js   # try the tools by hand (set MITR_API_KEY first)

如有疑问或问题，请联系：[email protected]

许可证

MIT