通过 MCP 将你的热力图连接到 Claude（1 分钟，一条命令）

太长不看版

• HeatMapX 支持 MCP（将工具接入 AI 助手的开放标准），所有套餐均免费
• 配置只需两步——签发 API key、运行一条命令——大约一分钟
• 连接完成后，Claude 可以在对话中直接查询你的热力图、页面数据和 A/B 测试结果

"打开控制台 → 复制数字 → 粘贴给 AI"——这套流程重复几次就会让人厌烦。有了 MCP，Claude 会自己去取 HeatMapX 的数据，整个分析过程都在一次对话中完成。

什么是 MCP？

MCP（Model Context Protocol）是将外部工具接入 Claude 等 AI 助手的标准协议。可以把它想象成一个通用插座：接好一次，AI 就能在需要时自行取用所需的数据。

从 claude.ai / Claude Desktop 连接（最简单 — 3 次点击）

在 claude.ai 或 Claude Desktop 中，你不需要终端或 API key：

1. 打开 Settings → Connectors →「Add custom connector」
2. 输入名称"HeatMapX"，URL 填写 https://heatmapx.com/api/mcp → 添加 →「Connect」
3. 登录 HeatMapX 并查看授权确认页面（读取权限 / 创建并启动 / 停止实验 / 注册站点），然后点击「Allow」

就这样——直接在对话中提问即可。你可以随时在 HeatMapX 的 Settings → Connected apps 中断开连接。

从 Claude Code 连接（终端，2 步）

1. 签发 API key

在 HeatMapX 控制台中进入 Settings → API keys，点击"Issue new key"。这个 key 只会显示一次——请立即复制保存。

2. 运行一条命令

在终端中运行以下命令（将 YOUR_API_KEY 替换为你复制的 key）：

claude mcp add --transport http heatmapx https://heatmapx.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY"

完成了。重启 Claude Code（或开启一个新对话），HeatMapX 的工具就可以使用了。

你可以做什么

连接完成后，下面这些问题都能直接得到答案：

• "给我看看我的站点" → 返回你已注册的站点及其 URL
• "kpop-ticket.com 上哪个页面的滚动深度最差？" → 从各页面数据中找出答案
• "总结一下 /pricing 的热力图" → 点击热点位置与滚动到达率
• "我的 A/B 测试表现如何？现在能判定获胜者了吗？" → 各变体的指标，以及有统计依据的获胜建议

数字由 HeatMapX 提供，解读由 Claude 完成——各自发挥所长。

不只是读取：创建并启动 A/B 测试

以写入权限连接后，整个流程都能在对话中完成：

• "在我的首页创建一个 A/B 测试：两条 CTA 文案" → 系统会创建一份草稿
• "启动它" → Claude 会总结这个实验并始终要求你确认 → 说 OK 就会上线
• "停止它" → 同样需要确认，然后停止

内置的安全设计：

• 创建结果始终是草稿状态（不会自行开始分流流量）
• 启动 / 停止在没有你的明确批准前绝不会执行（两步确认）
• 无法通过 AI 删除（不可逆操作不开放）
• 权限会在授权确认页面中明确列出，并可随时在 Settings → Connected apps 中撤销

可用工具

提供五个读取工具，外加五个写入工具（create_site / create_experiment / start·pause·stop_experiment）。写入工具仅在你明确批准了写入权限的连接上生效，且启动/停止操作始终需要在对话中进行确认。

无法连接时的排查清单

• key 粘贴错误？ 确认你粘贴的是以 hmx_live_ 开头的完整字符串
• key 是否已被吊销？ 前往 Settings → API keys 确认是否有有效的 key

价格

MCP 访问在所有套餐中均免费（仅有合理的突发流量限制）。热力图和 A/B 测试，直接从 Claude 中获取——不妨试试看。