透過 MCP 將您的熱區圖連接至 Claude(1 分鐘、一行指令)
HeatMapX Engineering Team4 min read
- how-to
- mcp
- claude
- ai
- integration
重點摘要
- HeatMapX 支援 MCP(用來將工具接入 AI 助理的開放標準)。所有方案皆免費
- 設定只需兩步驟 — 發行 API 金鑰、執行一行指令 — 大約一分鐘即可完成
- 連接後,Claude 就能在對話中查詢您的熱區圖、頁面數據與 A/B 測試結果
「打開儀表板 → 複製數字 → 貼給 AI」——這樣的往返操作很快就會讓人厭倦。透過 MCP,Claude 會自己去抓取您的 HeatMapX 數據,整個分析過程一次對話就能完成。
什麼是 MCP?
MCP(Model Context Protocol)是一套用來將外部工具連接至 Claude 等 AI 助理的標準規格。可以把它想成通用電源插座:只要接上一次,AI 就能在需要時自行取得所需的數據。
設定步驟(2 步驟)
1. 發行 API 金鑰
在您的 HeatMapX 儀表板中,前往 設定 → API 金鑰,點擊「發行新金鑰」。金鑰只會顯示一次,請立即複製保存。
2. 執行一行指令
在終端機中執行以下指令(將 YOUR_API_KEY 替換成您複製的金鑰):
claude mcp add --transport http heatmapx https://heatmapx.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY"
完成了。重新啟動 Claude Code(或開啟新對話),HeatMapX 的工具即可使用。
您可以做什麼
連接後,以下這類問題都能直接提問:
- 「顯示我的網站列表」→ 回傳您已註冊的網站與網址
- 「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 絕不會意外更動您的資料。
若無法連接 — 檢查清單
- 金鑰貼錯了嗎? 請確認已完整貼上以
hmx_live_開頭的整串字串 - 客戶端是否支援: 需要使用支援自訂標頭的 MCP 客戶端(Claude Code、Cursor 等)。Claude Desktop 的自訂連接器(OAuth 方式)已列入我們的規劃中
- 金鑰是否已被撤銷? 請至設定 → API 金鑰確認是否仍有有效金鑰
費用
MCP 存取於所有方案皆免費(僅有合理的流量上限)。熱區圖與 A/B 測試,直接從 Claude 取用 — 歡迎試試看。