MCP로 히트맵을 Claude에 연결하기 (1분, 명령어 한 줄)
- 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가 필요할 때마다 알아서 데이터를 가져갑니다.
claude.ai / Claude Desktop에서 연결하기 (가장 쉬움 — 클릭 3번)
claude.ai나 Claude Desktop에서는 터미널이나 API 키가 필요 없습니다:
- **설정 → 커넥터 → "커스텀 커넥터 추가"**를 엽니다
- 이름에 "HeatMapX", URL에
https://heatmapx.com/api/mcp를 입력 → 추가 → "연결" - HeatMapX에 로그인하고 동의 화면(읽기 권한 / 실험 생성·시작 / 중지 / 사이트 등록)을 확인한 뒤 "허용"을 클릭
이제 끝입니다 — 바로 대화창에서 물어보세요. HeatMapX 설정 → 연결된 앱에서 언제든 연결을 해제할 수 있습니다.
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 도구를 바로 사용할 수 있습니다.
무엇을 할 수 있나요
연결 후에는 이런 질문이 그대로 통합니다:
- "내 사이트 목록을 보여줘" → 등록된 사이트와 URL 반환
- "kpop-ticket.com에서 스크롤 도달률이 가장 낮은 페이지는?" → 페이지별 통계에서 찾아줌
- "/pricing 페이지의 히트맵을 요약해줘" → 클릭 집중 구역과 스크롤 도달률
- "내 A/B 테스트는 어떻게 되고 있어? 이제 승자를 정해도 될까?" → 변형별 지표와 통계적으로 근거 있는 승자 제안
수치는 HeatMapX가 제공하고, 해석은 Claude가 담당합니다. 각자 가장 잘하는 일을 맡는 셈이죠.
읽기만이 아닙니다: A/B 테스트 생성과 실행
쓰기 권한으로 연결하면 전체 과정이 대화 안에서 이루어집니다:
- "홈페이지에 CTA 문구 두 개로 A/B 테스트를 만들어줘" → 초안이 생성됩니다
- "시작해줘" → Claude가 실험 내용을 요약하고 항상 확인을 요청합니다 → OK라고 답하면 실행됩니다
- "중지해줘" → 마찬가지로 확인을 거친 뒤 중지됩니다
설계 단계부터 반영된 안전장치:
- 생성은 항상 초안 상태로 저장됩니다 (스스로 트래픽을 받기 시작하지 않습니다)
- 시작 / 중지는 명시적인 승인 없이는 절대 실행되지 않습니다 (2단계 확인)
- 삭제는 AI를 통해 불가능합니다 (되돌릴 수 없는 작업은 제공하지 않습니다)
- 권한은 동의 화면에 명시되며, 설정 → 연결된 앱에서 언제든 취소할 수 있습니다
사용 가능한 도구
| 도구 | 반환 내용 |
|---|---|
| list_sites | 등록된 사이트 목록 |
| get_page_stats | 페이지별 세션, 클릭, 평균 스크롤 도달률 |
| get_heatmap_summary | 특정 페이지의 히트맵 집계 (기간 지정 가능) |
| list_experiments | A/B 실험 목록 |
| get_experiment_results | 변형별 지표, 개선율, 승자 제안 |
읽기 도구 5개와 쓰기 도구 5개(create_site / create_experiment / start·pause·stop_experiment)를 제공합니다. 쓰기 도구는 사용자가 명시적으로 쓰기 권한을 승인한 연결에서만 작동하며, 시작/중지는 항상 대화 중 확인이 필요합니다.
연결이 안 될 때 확인할 점
- 키를 잘못 붙여넣지 않았나요?
hmx_live_로 시작하는 전체 문자열을 붙여넣었는지 확인하세요 - 키가 폐기되지 않았나요? 설정 → API 키에서 활성화된 키가 남아 있는지 확인하세요
요금
MCP 접근은 모든 플랜에서 무료입니다 (상식적인 수준의 버스트 제한만 있습니다). 히트맵도 A/B 테스트도, Claude에서 바로 확인해보세요.