> For the complete documentation index, see [llms.txt](https://docs.hackle.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hackle.io/ai/model-context-protocol.md).

# MCP 연동

핵클 MCP(*Model Context Protocol*)는 Claude, ChatGPT 등 AI 클라이언트가 자연어로 데이터를 조회하고 분석할 수 있도록 지원합니다.

대시보드에서 클릭으로 확인하던 실험·메시지·분석 데이터를, AI 와의 대화로 묻고 해석하고 시각화까지 받을 수 있습니다.

{% hint style="success" %}
핵클 MCP를 활용하면 아래와 예제와 같은 작업을 AI와 함께 확인할 수 있습니다.

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

## 동작 방식

```mermaid
flowchart LR
    client["AI 클라이언트"]
    server["핵클 MCP 서버"]
    workspace["핵클 워크스페이스"]

    client --> server --> workspace
```

1. AI 클라이언트에 자연어로 질문을 하면
2. 핵클 인프라에서 운영되는 MCP 서버를 통해
3. 핵클 워크스페이스에 접근하여 데이터를 조회할 수 있습니다.

{% hint style="success" %}
Hackle MCP 서버는 Hackle 인프라에서 운영되므로 별도 설치가 필요하지 않습니다.
{% endhint %}

## 도입

[Hackle 대시보드](https://dashboard.hackle.io/) 의 **MCP 연동** 메뉴에서 API 키 발급을 신청하실 수 있습니다.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.hackle.io/ai/model-context-protocol.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.