Kết nối Heatmap của bạn với Claude qua MCP (1 phút, một dòng lệnh)
- how-to
- mcp
- claude
- ai
- integration
Tóm tắt nhanh
- HeatMapX hỗ trợ MCP (chuẩn mở để kết nối công cụ với trợ lý AI). Miễn phí trên mọi gói
- Thiết lập gồm hai bước — phát hành API key, chạy một dòng lệnh — mất khoảng một phút
- Sau khi kết nối, Claude có thể truy vấn heatmap, thống kê trang và kết quả A/B test ngay trong cuộc trò chuyện
"Mở dashboard → copy số liệu → dán vào AI" — cái vòng lặp này nhanh chóng trở nên phiền toái. Với MCP, Claude tự lấy dữ liệu HeatMapX của bạn, và toàn bộ quá trình phân tích diễn ra trong một cuộc trò chuyện duy nhất.
MCP là gì?
MCP (Model Context Protocol) là chuẩn để kết nối các công cụ bên ngoài với trợ lý AI như Claude. Hãy hình dung nó như một ổ cắm điện phổ dụng: cắm vào một lần, và AI sẽ lấy dữ liệu nó cần, bất cứ khi nào cần.
Thiết lập (2 bước)
1. Phát hành API key
Trong dashboard HeatMapX của bạn, vào Settings → API keys và nhấn "Issue new key". Key chỉ được hiển thị một lần duy nhất — hãy copy ngay lập tức.
2. Chạy một dòng lệnh
Trong terminal của bạn (thay YOUR_API_KEY bằng key bạn vừa copy):
claude mcp add --transport http heatmapx https://heatmapx.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY"
Xong. Khởi động lại Claude Code (hoặc bắt đầu một cuộc trò chuyện mới) và các công cụ HeatMapX sẽ có sẵn.
Bạn có thể làm gì
Sau khi kết nối, những câu hỏi như thế này sẽ hoạt động ngay:
- "Cho tôi xem các trang web của tôi" → danh sách trang đã đăng ký và URL
- "Trang nào trên kpop-ticket.com có độ sâu cuộn tệ nhất?" → tìm ra từ thống kê theo từng trang
- "Tóm tắt heatmap của trang /pricing" → điểm nóng click và mức độ cuộn tới
- "A/B test của tôi thế nào rồi? Đã có thể chọn người thắng chưa?" → chỉ số theo biến thể cùng đề xuất người thắng dựa trên căn cứ thống kê
HeatMapX cung cấp số liệu; Claude đảm nhận việc diễn giải. Mỗi bên làm phần việc mình giỏi nhất.
Các công cụ khả dụng (chỉ đọc)
| Công cụ | Trả về gì |
|---|---|
| list_sites | Danh sách các trang web đã đăng ký của bạn |
| get_page_stats | Số phiên truy cập, số click, độ sâu cuộn trung bình theo từng trang |
| get_heatmap_summary | Tổng hợp heatmap cho một trang (có thể chọn khoảng thời gian) |
| list_experiments | Danh sách các thử nghiệm A/B của bạn |
| get_experiment_results | Chỉ số theo biến thể, mức cải thiện, đề xuất người thắng |
Không có công cụ ghi (write) nào — mọi thứ đều chỉ đọc, nên AI không thể vô tình thay đổi dữ liệu của bạn.
Nếu không kết nối được — danh sách kiểm tra
- Dán sai key? Hãy chắc chắn bạn đã dán toàn bộ chuỗi bắt đầu bằng
hmx_live_ - Client có hỗ trợ không: bạn cần một MCP client hỗ trợ header tùy chỉnh (Claude Code, Cursor, v.v.). Custom connector (OAuth) của Claude Desktop đang nằm trong lộ trình phát triển của chúng tôi
- Key đã bị thu hồi? Kiểm tra Settings → API keys xem còn key nào đang hoạt động không
Giá
Truy cập MCP miễn phí trên mọi gói (chỉ có giới hạn burst hợp lý). Heatmap và A/B test, ngay từ Claude — hãy thử xem sao.