> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getqr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cursor에 연결

> 클릭 한 번 또는 mcp.json으로 GetQR을 Cursor에 추가하세요.

GetQR을 Cursor에 MCP 서버로 추가하면 Cursor 채팅에서 QR 코드를 만들고 스캔을 확인할 수 있습니다. GetQR에서 클릭 한 번으로 설치하거나 `mcp.json` 파일에 추가하세요.

## 시작하기 전에

* Admin 또는 Editor 역할의 GetQR 계정 및 활성 구독. [AI 커넥터 개요](/ko/ai-connectors/overview)를 참조하세요.
* 컴퓨터에 설치된 Cursor 데스크톱 앱. Cursor는 컴퓨터에서만 연결할 수 있습니다.

## 클릭 한 번으로 설치하기

**1. My Account 열기**

컴퓨터의 GetQR에서 사이드바 하단의 이름을 클릭한 다음 **My Account**를 클릭합니다.

**2. AI connectors 탭 열기**

**AI connectors**를 클릭합니다.

**3. 연결 시작**

**Connect an assistant**를 클릭합니다. 이미 연결이 있는 경우 대신 **Connect**를 클릭합니다.

**4. Cursor 선택**

대화 상자에서 **Cursor**를 선택합니다.

**5. Cursor 열기**

**Open Cursor**를 클릭합니다. 브라우저에서 Cursor를 열지 묻는 메시지가 표시되면 허용합니다.

**6. 서버 설치**

Cursor에 정보가 이미 입력된 GetQR MCP 서버가 표시됩니다. 설치를 확인합니다.

**7. 로그인**

Cursor의 MCP 설정에서 GetQR 로그인을 시작합니다. 브라우저에서 GetQR 로그인 페이지가 열립니다.

**8. 액세스 승인**

요청이 있으면 GetQR에 로그인합니다. 권한을 검토하고 **Allow**를 클릭합니다.

**9. 연결 확인**

GetQR로 돌아오면 대화 상자가 자동으로 업데이트되어 "Cursor connected"가 표시됩니다. 이제 Cursor가 **Connected clients** 아래에 표시됩니다.

## 수동으로 추가하기

원클릭 설치가 작동하지 않거나 팀과 설정을 공유하려는 경우 이 방법을 사용하세요.

**1. Cursor에서 MCP 설정 열기**

Cursor에서 **Customize** → **MCPs** → **Add MCP**(Cursor 버전에 따라 **Add server**)를 엽니다.

**2. GetQR 서버 추가**

`mcp.json` 파일에 GetQR을 추가합니다.

```json Global (~/.cursor/mcp.json) theme={null}
{
  "mcpServers": {
    "GetQR": {
      "url": "https://getqr.com/api/mcp"
    }
  }
}
```

```json Project (.cursor/mcp.json) theme={null}
{
  "mcpServers": {
    "GetQR": {
      "url": "https://getqr.com/api/mcp"
    }
  }
}
```

파일에 이미 다른 서버가 있으면 `mcpServers` 안에 `"GetQR"` 항목을 나란히 추가합니다.

**3. 파일 저장**

`mcp.json`을 저장합니다. Cursor의 MCP 목록에 GetQR이 표시됩니다.

**4. 로그인 및 승인**

Cursor에서 GetQR 로그인을 시작합니다. GetQR 페이지에서 **Allow**를 클릭합니다.

> [!NOTE]
>
> API 키는 필요하지 않습니다. Cursor는 OAuth로 로그인하며 액세스를 자동으로 갱신합니다.

## 사용해 보기

Cursor 채팅을 열고 다음과 같이 요청하세요.

```text theme={null}
Using GetQR, create a Website QR code for https://example.com/launch titled "Launch page" and give me a PNG download link at 2048 px.
```

더 많은 아이디어는 [예시 프롬프트](/ko/ai-connectors/example-prompts)를 참조하세요.

## 자주 발생하는 문제

> **Open Cursor를 클릭해도 아무 반응이 없음**
>
> Cursor 데스크톱 앱이 설치되어 있는지 확인하고 브라우저가 앱을 열도록 허용하세요. 그래도 안 되면 [서버를 수동으로 추가](#수동으로-추가하기)하세요.

> **GetQR에 “Set up Cursor on desktop”이 표시됨**
>
> 휴대폰에서 대화 상자를 열었습니다. Cursor는 데스크톱 앱이므로 컴퓨터에서만 연결할 수 있습니다.

> **Cursor에서 GetQR에 로그인이 필요하거나 오류가 표시됨**
>
> 액세스 토큰은 1시간 동안 유효하며 Cursor가 자동으로 갱신합니다. Cursor를 30일 동안 사용하지 않았거나 액세스를 취소한 경우 Cursor의 MCP 설정에서 다시 로그인하세요.

> **GetQR 페이지에 “AI connectors aren't available”이 표시됨**
>
> Viewer는 AI 어시스턴트를 연결할 수 없습니다. 워크스페이스 Admin에게 Editor 역할을 요청하세요.

> **GetQR 페이지에 “An active subscription is required”가 표시됨**
>
> AI 어시스턴트는 활성 구독이 있는 계정에만 연결할 수 있습니다. 요금제 관련 질문은 [고객센터](https://getqr.com/help)를 참조하세요.

## 다음 단계

> **[할 수 있는 작업](/ko/ai-connectors/capabilities)**

> **[예시 프롬프트](/ko/ai-connectors/example-prompts)**


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.