# MCP(Model Context Protocol)

## Hackle MCP

Hackle MCP 는 Claude, Cursor 같은 AI 클라이언트가 Hackle 의 데이터에 자연어로 접근할 수 있게 해주는 연동입니다. 대시보드에서 클릭으로 확인하던 실험·메시지·분석 데이터를, AI 와의 대화로 묻고 해석하고 시각화까지 받을 수 있습니다.

### 무엇을 할 수 있나요?

* **실험 결과 해석**: "지난주 시작한 A/B 테스트 결과를 요약해줘"
* **메시지 효과 측정**: "최근 푸시 캠페인의 전환률을 비교해줘"
* **사용자 동향 분석**: "최근 30일 DAU 추이와 7일 리텐션을 같이 보여줘"
* **퍼널 분석**: "회원가입에서 첫 결제까지 단계별 이탈률을 차트로 그려줘"
* **운영 자동화**: "오늘 종료된 실험 중 통계적으로 유의한 것만 골라서 알려줘"

### 어떻게 동작하나요?

```
[AI 클라이언트]              [Hackle MCP 서버]               [Hackle 워크스페이스]
claude.ai 웹       ────>  https://mcp.hackle.io/mcp  ───>   실험 · 메시지 · 분석 데이터
Claude Desktop                  (운영: Hackle)
Claude Code 등
```

* AI 클라이언트는 사용자의 PC / 브라우저에서 실행됩니다.
* Hackle MCP 서버는 Hackle 인프라에서 운영되므로 별도 설치가 필요하지 않습니다.
* 인증은 Hackle API 키로 진행됩니다.

### 도입

Hackle MCP 는 현재 일부 고객사에 한해 제공되고 있습니다. [Hackle 대시보드](https://dashboard.hackle.io/) 의 **MCP 연동** 메뉴에서 API 키 발급을 신청하실 수 있습니다.

### 클라이언트의 커스텀 커넥터 사용 조건

claude.ai 웹 / Claude Desktop 의 커스텀 커넥터:

* **무료 플랜**: 커스텀 커넥터를 **1개까지** 추가할 수 있습니다.
* **유료 플랜 (Pro)**: 제한 없이 추가할 수 있습니다.
* **Team / Enterprise**: 워크스페이스 관리자가 커스텀 커넥터 추가를 막아두면 **"커스텀 커넥터 추가" 메뉴 자체가 표시되지 않습니다.** 이 경우 워크스페이스 관리자에게 문의해주세요.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hackle.io/external-link/model-context-protocol.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
