Claude Code 연동

Anthropic 의 공식 CLI 인 Claude Code 에서 Hackle MCP 를 연결하는 방법입니다.

사전 준비

• 최신 버전의 Claude Code

• Hackle API 키 — 발급 방법은 MCP(Model Context Protocol) 참고

방법 A — 인증 흐름으로 추가 (권장)

향후 API 키를 갱신할 때 다시 인증해 처리할 수 있습니다.

1. MCP 서버 등록

claude mcp add --transport http hackle-mcp https://mcp.hackle.io/mcp

기본적으로 현재 프로젝트 로컬에만 등록됩니다. 모든 프로젝트에서 사용하려면:

claude mcp add --transport http --scope user hackle-mcp https://mcp.hackle.io/mcp

2. 인증 트리거

Claude Code 세션 안에서:

/mcp

hackle-mcp 옆에 인증이 필요하다는 표시가 보입니다. 항목을 선택하면 브라우저가 열리고 Hackle 인증 화면이 표시됩니다. API 키 입력란에 Hackle API 키를 붙여넣고 진행합니다.

3. 연결 확인

/mcp

hackle-mcp 상태가 connected 로 표시되면 완료입니다. 새 프롬프트에서 도구를 사용할 수 있습니다.

방법 B — 헤더에 API 키 직접 박기

빠르게 구성하려면 헤더를 직접 지정할 수 있습니다. API 키가 config 파일에 평문으로 저장되므로 개인 환경에서만 사용하시기를 권장합니다.

claude mcp add --transport http hackle-mcp https://mcp.hackle.io/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

이 경우 별도 인증 단계 없이 즉시 도구를 사용할 수 있습니다.

관리 명령

claude mcp list              # 등록된 서버 목록
claude mcp get hackle-mcp    # 상세
claude mcp remove hackle-mcp # 제거

세션 안에서는 /mcp 명령으로 상태 확인과 재인증이 가능합니다.

로컬 서버에서 이전

기존에 로컬 MCP 서버(npm 패키지 형태)를 Claude Code 에 등록해 사용하고 계셨다면 다음 단계를 따라 원격 서버로 옮길 수 있습니다.

1. 기존 로컬 서버 제거

claude mcp list                          # 등록 이름 확인
claude mcp remove hackle-mcp             # 이름이 다르면 그에 맞게 변경

2. 원격 서버 등록

위의 방법 A 또는 방법 B 를 따라 등록합니다. API 키 값은 기존에 쓰던 것 그대로 사용하실 수 있습니다.

3. 로컬 서버 패키지 정리 (선택)

전역 설치한 npm 패키지가 있다면 제거합니다.

npm uninstall -g @hackle-io/hackle-mcp