如何通过 MCP 将 Amplitude 连接到 Cursor

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Amplitude、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

Amplitude + Cursor

让你的 AI 读取 Amplitude 的产品分析数据：事件趋势、漏斗、留存、活跃用户和新用户、收入 LTV、会话、已保存的图表、群组、用户查询和跟踪计划，并为图表添加注释。支持美国和欧盟数据中心。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

AMPLITUDE_API_HOST, AMPLITUDE_API_KEY, AMPLITUDE_SECRET_KEY

步骤 1 — 获取凭证

1. 你需要在该 Amplitude 项目中拥有 Manager 或 Admin 角色。依次选择 Settings（左下角）和 Projects，然后打开该项目。每个项目都有自己的密钥，所以一个连接器只读取一个项目。
2. 在项目的 General 标签页中，点击 API Key 旁边的 Manage，把密钥复制到 AMPLITUDE_API_KEY。
3. 点击 Secret Key 旁边的 Manage，为 AnythingMCP 生成一个新的 secret key。Amplitude 只在生成时显示一次 secret key，所以请立即把它粘贴到 AMPLITUDE_SECRET_KEY。一个项目可以有多个 secret key。
4. 按项目所在的数据中心设置 AMPLITUDE_API_HOST：默认（美国）数据中心用 https://amplitude.com，欧盟项目（其应用运行在 app.eu.amplitude.com）用 https://analytics.eu.amplitude.com。欧盟项目的密钥在美国主机上会被拒绝，反之亦然。analytics.amplitude.com 是网页应用，不是 API。
5. 安装连接器并运行 amplitude_list_events，查看项目记录的准确事件名称。

谁能看到什么：secret key 可以读取项目的所有事件和用户。请只把 MCP 服务器分享给有权查看这些数据的人。

可读取的内容：带筛选和分组的事件趋势、漏斗、留存、活跃用户和新用户（也可按 5 分钟粒度实时查看）、收入 LTV、会话时长和人均会话数、用户构成、在 Amplitude 中保存的图表结果（通过图表地址中 /chart/ 后面的 id 指定）、行为群组、用户查询及该用户最近的事件，以及跟踪计划（事件类型、事件属性和用户属性、类别）。日期以整天为单位，按项目时区计算。群组列表需要 Growth 或 Enterprise 套餐的 Behavioral Cohorts 附加功能。

限制：Amplitude 的限制按项目计算，并与所有其他集成共享。Dashboard REST API 最多同时处理 5 个请求，查询成本预算为每 5 分钟 1,000、每小时 108,000。一次查询的成本 = 时间范围的天数 × 条件数（分段和筛选；每个分组计 4）× 图表成本（细分每个事件 1，漏斗每一步 2，留存 8，会话 4，其他均为 1）。用户查询和用户活动另有限制：同时 10 个、每小时 360 个；跟踪计划每小时允许 7,200 次读取。超过限制时 Amplitude 返回 429：AI 会等待，如果是成本预算的问题，就缩短时间范围或去掉分组。一次带分组的查询可以代替许多按天或按用户的查询。

个人数据：amplitude_search_users 和 amplitude_get_user_activity 会返回用户的档案和事件。AI 只会针对你询问的用户使用它们。

先确认：不指定图表的注释会显示在项目的所有图表上，所有成员都能看到，因此在执行 amplitude_create_annotation 之前，AI 会先和你确认标签、时间和显示范围。amplitude_delete_annotation 在安装时默认关闭。

常见错误：403 "Invalid API Key"：密钥或 secret 错误、属于其他项目，或者项目位于另一个数据中心（请检查 AMPLITUDE_API_HOST）。401：缺少两个密钥中的一个。400：某个参数或事件、分段的 JSON 无效，或者已保存的图表属于其他项目。amplitude_get_chart_results 返回 404：没有该 id 的已保存图表。429：达到了并发、每小时或成本限制，Amplitude 会说明是哪一个。

该连接器不会向 Amplitude 发送事件，不会导出原始事件文件，不会下载或上传群组，不会因隐私请求删除用户，也不涉及 Experiment、Session Replay 和用户管理。

步骤 2 — 安装 adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

步骤 3 — 在 Cursor 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Cursor 从 ~/.cursor/mcp.json 读取 MCP 服务器。添加以下条目：

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 Cursor。
3. 打开 Cursor → Settings → MCP，确认 anythingmcp 已列出并处于已连接状态。
4. 开始对话，智能体现在可以调用 Amplitude 的工具。

可用工具

示例提示

• “过去三个月每周有多少用户完成了 Sign Up，按国家分组是怎样的？”
• “给我看 9 月从 Sign Up 到 Create Project 再到 Invite Teammate 的漏斗，以及流失用户最多的那一步。”
• “8 月开始使用的新用户中，在之后八周的每一周各有多少人回来？”
• “在所有图表上为 10 月 1 日价格页改版添加一条注释，保存前先给我看标签和日期。”

FAQ

Cursor 免费套餐支持自定义 MCP 服务器吗？ 支持，Hobby、Pro 和 Business 套餐均可使用 MCP。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT