# Cursor 연결 {/* #connect-cursor */}

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

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

**[Cursor에 Reconstruct 추가](https://cursor.com/install-mcp?name=reconstruct&config=eyJ1cmwiOiJodHRwczovL3JlY29uc3RydWN0LmRldi9tY3AiLCJhdXRoIjp7IkNMSUVOVF9JRCI6InJlY29uc3RydWN0LW1jcCIsInNjb3BlcyI6WyJvcGVuaWQiLCJhdWQtbWNwIl19fQ%3D%3D)**는 이 설정이 입력된 Cursor 설치 창을 엽니다. 수동으로 설정하려면 다른 서버를 유지한 채 `~/.cursor/mcp.json`에 `reconstruct` 항목을 추가하세요:

```json
{
  "mcpServers": {
    "Reconstruct": {
      "url": "https://reconstruct.dev/mcp",
      "auth": {
        "CLIENT_ID": "reconstruct-mcp",
        "scopes": ["openid", "aud-mcp"]
      }
    }
  }
}
```

서버를 활성화하고 브라우저 로그인 절차를 따르세요. 데스크톱은 `http://localhost:8787/callback`, Cursor 웹/에이전트 콜백은 `https://www.cursor.com/agents/mcp/oauth/callback`입니다. 둘 다 등록되어 있습니다. OAuth 선택 시 수동으로 설정한 `Authorization` 헤더를 제거하세요. [Cursor 정적 OAuth](https://prod.cursor.com/docs/mcp)를 참고하세요.

## 기존 연결 새로고침 {/* #refresh-an-existing-connection */}

검색된 발급자는 `https://reconstruct.dev/sso/realms/reconstruct`여야 합니다. 브라우저는 `https://reconstruct.dev/sso/realms/reconstruct/protocol/openid-connect/auth`를 열어야 합니다. 사이트 루트에서 `/authorize`로 끝나는 URL은 검색 메타데이터가 오래되었거나 누락되었음을 뜻합니다.

Reconstruct 서버를 비활성화했다가 활성화하고 다시 로그인하세요. 이전 메타데이터가 유지되면 Cursor를 다시 시작하세요. 필요하다면 이 서버 항목만 다시 만드세요. 연결 오류는 **Output → MCP Logs**에서 확인하세요. 위 콜백 설정을 유지하고 클라이언트 보안 비밀은 비워 두세요.

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

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

`~/.cursor/mcp.json`을 만드세요:

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

Cursor MCP 설정에서 서버를 활성화하세요. 도구 목록이 이미 로드되었다면 에이전트를 다시 시작하고 `list_products` 호출을 요청하세요. [공식 Cursor MCP 문서](https://prod.cursor.com/docs/mcp)를 참고하세요.

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