> 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/external-link/model-context-protocol/claude-ai-web.md).

# claude.ai 웹 & 데스크탑 연동

[claude.ai](https://claude.ai) 웹에서 커스텀 커넥터를 통해 Hackle MCP 연동을 설명합니다.

Claude Desktop 도 동일합니다.

### 사전 준비

* 커스텀 커넥터를 사용할 수 있는 Claude 계정
  * **무료 플랜**: 커스텀 커넥터를 1개까지 추가 가능
  * **유료 플랜 (Pro)**: 제한 없음
  * **Team / Enterprise**: 워크스페이스 관리자가 커스텀 커넥터 추가를 막아두면 메뉴 자체가 표시되지 않습니다
* Hackle API 키 — 발급 방법은 <https://docs.hackle.io/external-link/model-context-protocol> 참고

### 1. 커넥터 페이지 열기

1. [claude.ai](https://claude.ai) 에 로그인합니다.
2. 좌측 사이드바에서 **사용자 지정** → **커넥터** 를 클릭합니다.

<figure><img src="/files/C4mdfEg7gYIU8sH8Tquv" alt=""><figcaption></figcaption></figure>

### 2. 커스텀 커넥터 추가

1. 커넥터 페이지 우측 상단의 **+** 버튼을 클릭하고 **커스텀 커넥터 추가** 를 선택합니다. [바로가기](https://claude.ai/customize/connectors?modal=add-custom-connector)
2. 표시되는 다이얼로그에 아래 내용을 입력하고 **추가** 를 누릅니다.

```
이름: Hackle
원격 MCP 서버 URL: https://mcp.hackle.io/mcp
```

<figure><img src="/files/03nR7p9tFC2dn1nnFTt1" alt=""><figcaption></figcaption></figure>

### 3. Hackle API 키 입력

URL 추가 후 연결 버튼을 클릭하면 인증 화면이 열립니다. **API 키 입력란**에 Hackle API 키를 붙여넣고 진행합니다.

<figure><img src="/files/VcAG6IwY9HdXngzYrb4P" alt=""><figcaption></figcaption></figure>

### 4. (선택) 도구 권한 확인

연결 후 커넥터 페이지에서 Hackle 커넥터를 클릭하면 노출되는 도구 목록과 권한을 볼 수 있습니다. 필요 시 일부 도구만 허용하도록 조정할 수 있습니다.

<figure><img src="/files/RcTGKOVh47UCd2xx23Hy" alt=""><figcaption></figcaption></figure>

### 5. 연결 확인

새 대화를 열고 다음과 같이 입력합니다.

> 사용 가능한 Hackle 도구를 알려줘

응답에 `experiment-list`, `in-app-message-list` 같은 도구 이름이 포함되면 연결 성공입니다.

### 자주 묻는 질문

**"커스텀 커넥터 추가" 메뉴가 보이지 않습니다.**

다음 중 하나에 해당할 수 있습니다.

* 무료 플랜에서 이미 다른 커스텀 커넥터 1개를 사용 중인 경우 추가 등록이 제한됩니다.
* 클로드 Team / Enterprise 플랜에서 관리자가 커스텀 커넥터 추가를 막아두면 메뉴 자체가 표시되지 않습니다. 클로드 플랜 관리자에게 문의해주세요.

**API 키를 다른 것으로 바꾸고 싶습니다.** 커넥터 페이지에서 Hackle 항목 → **연결 해제** 후 다시 추가하시면 새 키로 인증할 수 있습니다.

**다른 워크스페이스의 데이터를 보고 싶습니다.** 계정별로 MCP API 키가 발급되므로 여러 워크스페이스에 접근 가능한 계정이라면 하나의 API 키만 발급 받아도 별도 설정 변경없이 여러 워크스페이스에 접근 가능합니다. 프롬프트에서 보고 싶은 워크스페이스를 명확하게 지정해도 되고 지정이 안되어 있다면 LLM 이 먼저 물어볼 것 입니다.


---

# 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/external-link/model-context-protocol/claude-ai-web.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.