透過 MCP 將您的熱區圖連接至 Claude（1 分鐘、一行指令）
HeatMapX Engineering Team6 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 就能在需要時自行取得所需的數據。
從 claude.ai / Claude Desktop 連接（最簡單 — 只需 3 次點擊）
在 claude.ai 或 Claude Desktop 中，您不需要終端機或 API 金鑰：
- 開啟 設定 → Connectors →「Add custom connector」
- 輸入名稱「HeatMapX」，URL 填入
https://heatmapx.com/api/mcp→ 新增 →「Connect」 - 登入 HeatMapX 並確認授權畫面（讀取權限 / 建立並啟動 / 停止實驗 / 註冊網站），接著點擊「Allow」
這樣就完成了 — 直接在對話中提問即可。您可以隨時在 HeatMapX 的 設定 → Connected apps 中中斷連接。
從 Claude Code 連接（終端機，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 負責解讀 — 各自發揮所長。
不只是讀取：建立並啟動 A/B 測試
以寫入權限連接後，整個流程都能在對話中完成：
- 「在我的首頁建立一個 A/B 測試：兩種 CTA 文案」→ 系統會建立一份草稿
- 「啟動它」→ Claude 會總結這個實驗並一律要求您確認 → 回覆 OK 即可上線
- 「停止它」→ 同樣需要確認，接著才會停止
從設計階段就內建的安全機制：
- 建立結果一律為草稿狀態（不會自行開始分流流量）
- 啟動 / 停止在未經您明確核准前絕不會執行（兩步驟確認）
- 無法透過 AI 刪除（不可逆的操作不提供）
- 權限會在授權畫面中列出，並可隨時在 設定 → Connected apps 中撤銷
可用的工具
| Tool | 回傳內容 |
|---|---|
| list_sites | 您已註冊的網站 |
| get_page_stats | 各頁面的工作階段、點擊數、平均捲動深度 |
| get_heatmap_summary | 單一頁面的熱區圖彙總數據（可指定時間區間） |
| list_experiments | 您的 A/B 實驗 |
| get_experiment_results | 各版本的成效數據、提升幅度、勝者建議 |
提供五個讀取工具，外加五個寫入工具（create_site / create_experiment / start·pause·stop_experiment）。寫入工具僅在您明確核准寫入權限的連接上才會生效，且啟動/停止一律需要在對話中進行確認。
若無法連接 — 檢查清單
- 金鑰貼錯了嗎？ 請確認已完整貼上以
hmx_live_開頭的整串字串 - 金鑰是否已被撤銷？ 請至設定 → API 金鑰確認是否仍有有效金鑰
費用
MCP 存取於所有方案皆免費（僅有合理的流量上限）。熱區圖與 A/B 測試，直接從 Claude 取用 — 歡迎試試看。