claude.ai 웹 & 데스크탑 연동

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 에 로그인합니다.

2. 좌측 사이드바에서 사용자 지정 → 커넥터 를 클릭합니다.

2. 커스텀 커넥터 추가

1. 커넥터 페이지 우측 상단의 + 버튼을 클릭하고 커스텀 커넥터 추가 를 선택합니다. 바로가기

2. 표시되는 다이얼로그에 아래 내용을 입력하고 추가 를 누릅니다.

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

3. Hackle API 키 입력

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

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

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

5. 연결 확인

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

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

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

자주 묻는 질문

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

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

• 무료 플랜에서 이미 다른 커스텀 커넥터 1개를 사용 중인 경우 추가 등록이 제한됩니다.

• 클로드 Team / Enterprise 플랜에서 관리자가 커스텀 커넥터 추가를 막아두면 메뉴 자체가 표시되지 않습니다. 클로드 플랜 관리자에게 문의해주세요.

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

다른 워크스페이스의 데이터를 보고 싶습니다. 현재는 워크스페이스별로 API 키가 발급되므로, 다른 워크스페이스를 조회하시려면 새 API 키로 다시 연결해주셔야 합니다. 추후에는 하나의 API 키로 여러 워크스페이스를 조회할 수 있도록 업데이트될 예정입니다.