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

太长不看版

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

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

什么是 MCP？

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

配置步骤（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 完成——各自发挥所长。

可用工具（只读）

Tool	返回内容
list_sites	你已注册的站点
get_page_stats	各页面的会话数、点击数、平均滚动深度
get_heatmap_summary	单个页面的热力图汇总数据（可指定时间范围）
list_experiments	你的 A/B 测试列表
get_experiment_results	各变体的指标、提升幅度、获胜建议

没有任何写入类工具——一切都是只读的，因此 AI 绝不会误改你的数据。

无法连接时的排查清单

• key 粘贴错误？ 确认你粘贴的是以 hmx_live_ 开头的完整字符串
• 客户端支持情况： 你需要一个支持自定义请求头的 MCP 客户端（Claude Code、Cursor 等）。Claude Desktop 的自定义连接器（OAuth 方式）已在我们的路线图中
• key 是否已被吊销？ 前往 Settings → API keys 确认是否有有效的 key

价格

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