Claude Code 연동

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

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 로 표시되면 완료입니다. 새 프롬프트에서 도구를 사용할 수 있습니다.

로컬 서버에서 이전

기존에 로컬 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