# Claude Code 연결 {/* #connect-claude-code */}

## 브라우저에서 OAuth 로그인 {/* #oauth-browser-sign-in */}

브라우저에서 Reconstruct 계정으로 로그인하세요. 플랫폼에서 개인 토큰을 만들 필요가 없습니다. 공통 연결 설정은 [MCP OAuth 설정](/docs/ko/connect-ai-agents#oauth-browser-sign-in)을 참고하세요.

```sh
claude mcp add --transport http --client-id reconstruct-mcp --callback-port 58234 reconstruct https://reconstruct.dev/mcp
```

`/mcp`를 실행하고 브라우저 로그인 절차를 따르세요. 클라이언트 보안 비밀은 필요하지 않습니다. 등록된 콜백은 `http://localhost:58234/callback`입니다. OAuth를 선택할 때는 수동으로 설정한 `Authorization` 헤더를 제거하세요. [Claude Code OAuth 설정](https://code.claude.com/docs/en/mcp#use-pre-configured-oauth-credentials)을 참고하세요.

설치된 Claude Code 버전이 콜백 호스트를 `localhost`에서 `127.0.0.1`로 바꾼다면 최신 버전으로 업데이트하거나 정확한 리디렉션 URI를 지원팀에 알려주세요. 콜백 주소의 허용 범위를 직접 넓히지 마세요.

## 개인 액세스 토큰 {/* #personal-access-token */}

[Reconstruct Platform 계정 설정](https://reconstruct.dev/platform/)에서 MCP 액세스 토큰을 복사하세요. 연결 요건은 [개인 액세스 토큰](/docs/ko/connect-ai-agents#personal-access-token)을 참고하세요. Claude Code를 실행하는 환경에 `CR_RECONSTRUCT_MCP_TOKEN`을 설정하세요.

프로젝트 루트에 `.mcp.json`을 만드세요:

```json
{
  "mcpServers": {
    "reconstruct": {
      "type": "http",
      "url": "https://reconstruct.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${CR_RECONSTRUCT_MCP_TOKEN}"
      }
    }
  }
}
```

토큰을 직접 입력했다면 이 파일을 버전 관리에서 제외하세요. 해당 프로젝트에서 Claude Code를 시작하고 요청이 표시되면 서버를 승인한 다음 `/mcp`로 상태를 확인하세요. 액세스를 확인하려면 Claude Code에 `list_products` 호출을 요청하세요. [공식 Claude Code MCP 설정](https://code.claude.com/docs/en/mcp)을 참고하세요.

다음으로 [프롬프트 예시](/docs/ko/prompt-examples)를 사용해 보세요.