MCP로 히트맵을 Claude에 연결하기 (1분, 명령어 한 줄)
HeatMapX Engineering Team5 min read
- how-to
- mcp
- claude
- ai
- integration
요약
- HeatMapX는 MCP(AI에 도구를 연결하는 개방형 표준)를 지원합니다. 모든 플랜에서 무료
- 설정은 두 단계 — API 키 발급, 명령어 한 줄 실행 — 약 1분이면 끝
- 연결하면 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 도구를 바로 사용할 수 있습니다.
무엇을 할 수 있나요
연결 후에는 이런 질문이 그대로 통합니다:
- "내 사이트 목록을 보여줘" → 등록된 사이트와 URL 반환
- "kpop-ticket.com에서 스크롤 도달률이 가장 낮은 페이지는?" → 페이지별 통계에서 찾아줌
- "/pricing 페이지의 히트맵을 요약해줘" → 클릭 집중 구역과 스크롤 도달률
- "내 A/B 테스트는 어떻게 되고 있어? 이제 승자를 정해도 될까?" → 변형별 지표와 통계적으로 근거 있는 승자 제안
수치는 HeatMapX가 제공하고, 해석은 Claude가 담당합니다. 각자 가장 잘하는 일을 맡는 셈이죠.
사용 가능한 도구 (읽기 전용)
| 도구 | 반환 내용 |
|---|---|
| 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에서 바로 확인해보세요.