# Muse Code 연결 {/* #connect-muse-code */}

이 가이드는 개인 액세스 토큰 또는 등록된 콜백 `http://127.0.0.1:58234/callback`을 쓰는 브라우저 OAuth를 지원합니다. [클라이언트 호환성](/docs/ko/connect-ai-agents#client-compatibility)을 참고하세요.

[개인 액세스 토큰](/docs/ko/connect-ai-agents#personal-access-token)에 설명된 대로 [Reconstruct Platform 설정](https://reconstruct.dev/platform/)에서 **MCP** 범위의 토큰을 만드세요.

## 서버 설정 {/* #configure-the-server */}

`~/.config/muse/settings.json` 또는 설정되어 있다면 `$XDG_CONFIG_HOME/muse/settings.json`을 편집하세요. 기존 설정과 서버를 유지하고 `mcpServers`에 `reconstruct`를 추가하세요:

```json
{
  "schema_version": 1,
  "mcpServers": {
    "reconstruct": {
      "type": "streamable-http",
      "url": "https://reconstruct.dev/mcp",
      "headers": {
        "Authorization": "Bearer <your MCP token>"
      }
    }
  }
}
```

`<your MCP token>`을 만든 토큰으로 바꾸세요. 이 사용자 설정을 비공개로 유지하고 버전 관리에서 제외하세요. Muse Code 1.3.0은 HTTP 헤더의 환경 변수를 확장하지 않으므로 `${CR_RECONSTRUCT_MCP_TOKEN}`이 그대로 전송됩니다. `schema_version: 1`을 유지하고 서버에는 루트 키 `mcpServers` 하나만 사용하세요. 별도의 `mcp_servers` 키를 추가하지 마세요.

## 연결 확인 {/* #check-the-connection */}

저장 후 새 `muse` 프로세스를 시작하세요. `/mcp`를 실행해 `reconstruct` 연결을 확인한 다음 Muse Code에 `mcp__reconstruct__list_products` 호출을 요청하여 액세스를 확인하세요. 설정 변경에는 새 프로세스가 필요합니다.

## 선택 사항: 브라우저 OAuth 로그인 {/* #optional-oauth-browser-sign-in */}

`Authorization` 헤더를 제거하고 공개 클라이언트 ID `reconstruct-mcp`, 범위 `openid`와 `aud-mcp`, 등록된 콜백 `http://127.0.0.1:58234/callback`으로 로그인하세요. 이 포트를 사용 가능하게 유지하세요:

```bash
muse mcp login reconstruct --oauth-client-id reconstruct-mcp \
  --scope openid --scope aud-mcp --callback-port 58234
```

OAuth에는 사용자 설정 항목을 사용하세요. CLI 로그인은 프로젝트 `.mcp.json`에만 설정된 서버를 지원하지 않습니다. 클라이언트 보안 비밀은 비워 두세요. 사전 등록된 이 루프백 콜백에는 `--oauth-client-id`를 사용하세요. 공통 콜백 포트는 `58234`입니다. 브라우저 로그인 후 Muse가 콜백을 받고 자동으로 연결을 완료합니다.

공식 [Muse Code MCP 가이드](https://meta-models.github.io/muse-code-sdk/next/guides/extend/mcp-servers/)를 참고하세요. 연결 실패 시 [문제 해결](/docs/ko/connect-ai-agents#troubleshooting)을 확인하세요. 다음으로 [프롬프트 예시](/docs/ko/prompt-examples)를 사용해 보세요.