본문으로 건너뛰기

Muse Code 연결

이 가이드는 개인 액세스 토큰 또는 등록된 콜백 http://127.0.0.1:58234/callback을 쓰는 브라우저 OAuth를 지원합니다. 클라이언트 호환성을 참고하세요.

개인 액세스 토큰에 설명된 대로 Reconstruct Platform 설정에서 MCP 범위의 토큰을 만드세요.

서버 설정​

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

{
  "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 키를 추가하지 마세요.

연결 확인​

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

선택 사항: 브라우저 OAuth 로그인​

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

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 가이드를 참고하세요. 연결 실패 시 문제 해결을 확인하세요. 다음으로 프롬프트 예시를 사용해 보세요.