Kết nối Heatmap của bạn với Claude qua MCP (1 phút, một dòng lệnh)

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.

Kết nối từ claude.ai / Claude Desktop (dễ nhất — 3 lần click)

Trên claude.ai hoặc Claude Desktop, bạn không cần terminal hay API key:

1. Mở Settings → Connectors → "Add custom connector"
2. Nhập "HeatMapX" làm tên và https://heatmapx.com/api/mcp làm URL → add → "Connect"
3. Đăng nhập vào HeatMapX và xem lại màn hình xác nhận quyền (consent screen) (quyền đọc / tạo & khởi động / dừng thử nghiệm / đăng ký trang web), sau đó nhấn "Allow"

Vậy là xong — cứ hỏi thoải mái trong chat. Bạn có thể ngắt kết nối bất cứ lúc nào tại HeatMapX Settings → Connected apps.

Kết nối từ Claude Code (terminal, 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.

Không chỉ đọc: tạo và khởi chạy A/B test

Kết nối với quyền ghi (write access) và toàn bộ quy trình diễn ra ngay trong cuộc trò chuyện:

• "Tạo một A/B test trên trang chủ của tôi: hai bản CTA khác nhau" → một bản nháp (draft) được tạo ra
• "Bắt đầu đi" → Claude tóm tắt thử nghiệm và luôn hỏi xác nhận từ bạn → nói OK là nó sẽ chạy thật
• "Dừng lại" → xác nhận tương tự, rồi nó dừng

An toàn ngay từ thiết kế:

• Việc tạo luôn ở dạng bản nháp (không có gì tự động phục vụ traffic)
• Bắt đầu / dừng không bao giờ thực thi nếu không có sự chấp thuận rõ ràng của bạn (xác nhận hai bước)
• Không thể xóa thông qua AI (các thao tác không thể hoàn tác đều bị loại bỏ)
• Quyền hạn được nêu rõ trên màn hình xác nhận quyền và có thể thu hồi bất cứ lúc nào tại Settings → Connected apps

Các công cụ khả dụng

Năm công cụ đọc cộng với năm công cụ ghi (create_site / create_experiment / start·pause·stop_experiment). Các công cụ ghi chỉ hoạt động trên những kết nối mà bạn đã cấp quyền ghi một cách rõ ràng, và start/stop luôn yêu cầu xác nhận ngay trong cuộc trò chuyệ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_
• 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.