> ## 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.

# AI 커넥터 개요

> Claude, ChatGPT, Cursor 같은 AI 어시스턴트에서 GetQR을 사용하세요.

AI 커넥터를 사용하면 AI 어시스턴트에서 QR 코드를 관리할 수 있습니다. Claude, ChatGPT 또는 Cursor를 GetQR에 연결한 다음 "지난주 메뉴 코드 스캔 실적은 어땠어?" 또는 "새 랜딩 페이지용 QR 코드를 만들어 줘"처럼 일상적인 말로 요청하세요.

## 작동 방식

GetQR은 MCP 서버(Model Context Protocol, AI 어시스턴트가 앱에 연결할 때 사용하는 개방형 표준)를 운영합니다. 어시스턴트에 서버를 한 번 추가하고 GetQR 계정으로 로그인하면 됩니다. 그 후에는 어시스턴트가 사용자를 대신해 워크스페이스의 데이터를 읽고 변경할 수 있습니다.

| | |
| - | - |
| **서버 URL** | `https://getqr.com/api/mcp` |
| **지원 어시스턴트** | Claude, ChatGPT, Cursor |
| **로그인** | 보안 OAuth 로그인 페이지를 통한 GetQR 계정 로그인 |

> [!NOTE]
>
> OAuth 로그인을 지원하는 원격 MCP 서버를 지원하는 다른 어시스턴트도 같은 URL로 연결할 수 있습니다. 이러한 어시스턴트는 연결 목록에 **Other MCP client**로 표시됩니다.

## 사용 가능한 사람

| 역할 | 어시스턴트 연결 가능 여부 |
| - | - |
| Admin | 예 |
| Editor | 예 |
| Viewer | 아니요. Viewer가 연결을 시도하면 "AI connectors aren't available"이 표시됩니다. |

워크스페이스에 활성 구독도 필요합니다. Editor는 Admin의 구독을 사용하므로 Admin의 요금제가 기준이 됩니다. 구독이 활성 상태가 아니면 로그인 페이지에 "An active subscription is required"가 표시되고, 갱신될 때까지 기존 연결도 작동하지 않습니다.

## 시작하기 전에

* Admin 또는 Editor 역할의 GetQR 계정. [역할 및 권한](/ko/members/roles-and-permissions)을 참조하세요.
* 워크스페이스 Admin 계정의 활성 구독. 요금제 및 결제 관련 질문은 [고객센터](https://getqr.com/help)를 참조하세요.
* Claude, 컴퓨터의 ChatGPT 또는 Cursor 데스크톱 앱.

## 어시스턴트가 할 수 있는 일

연결할 때 GetQR은 다음 권한을 승인하도록 요청합니다.

* 스캔 통계 및 분석 읽기
* QR 코드 생성 및 편집
* 템플릿 생성 및 적용
* 예약 보고서 생성 및 관리
* 멤버 초대 및 관리

실제로 어시스턴트는 QR 코드 목록 조회 및 검색, 웹사이트 QR 코드 생성, 목적지 및 디자인 변경, 일시 중지 또는 재개, 다운로드 링크 가져오기, 스캔 통계 조회, 스캔 데이터 내보내기, 템플릿 저장, 예약 보고서 설정, QR 코드 대량 생성, 사용자 지정 도메인 설정을 할 수 있습니다. 멤버 관리는 워크스페이스 Admin만 사용할 수 있습니다. 전체 목록은 [할 수 있는 작업](/ko/ai-connectors/capabilities)을 참조하세요.

## 어시스턴트가 할 수 없는 일

* **결제 및 계정.** 구독, 결제, 계정 삭제는 어시스턴트에서 사용할 수 없습니다.
* **기타 QR 유형.** 어시스턴트는 웹사이트 QR 코드만 생성합니다. 다른 유형은 앱에서 만드세요.
* **QR 코드 삭제.** 어시스턴트는 QR 코드를 일시 중지할 수 있지만 삭제할 수는 없습니다.
* **단축 링크 변경.** QR 코드를 만든 후에는 사용자나 어시스턴트 모두 단축 링크를 변경할 수 없습니다.
* **일부 디자인.** 업로드한 로고, Convert logo to QR, Branded 디자인, AI 디자인은 어시스턴트로 설정할 수 없습니다.

## 보안

* **모든 연결을 직접 승인합니다.** 어시스턴트는 비밀번호를 볼 수 없습니다. GetQR 페이지에서 로그인하고 **Allow**를 클릭합니다.
* **표준 OAuth.** 연결에는 PKCE를 사용하는 OAuth 2.1이 사용됩니다. 액세스 토큰은 1시간 동안 유효하며 어시스턴트가 자동으로 갱신합니다. 어시스턴트를 30일 동안 사용하지 않으면 연결이 만료되어 다시 로그인해야 합니다.
* **앱과 동일한 규칙.** 어시스턴트는 사용자의 역할 권한으로 사용자를 대신해 작동합니다. Editor의 어시스턴트는 Editor가 앱에서 할 수 없는 일을 할 수 없습니다.
* **하나의 워크스페이스.** 연결은 하나의 워크스페이스에 연결됩니다. 기본 워크스페이스 또는 처음 가입한 워크스페이스입니다.
* **언제든지 취소 가능.** **My Account** → **AI connectors**에서 연결을 삭제하세요. 어시스턴트는 즉시 액세스 권한을 잃습니다. [연결 관리](/ko/ai-connectors/manage-connections)를 참조하세요.

> [!WARNING]
>
> 어시스턴트는 인쇄된 QR 코드의 목적지 변경, 코드 일시 중지, 멤버 삭제 등 실제 변경을 할 수 있습니다. 확인하기 전에 어시스턴트가 수행하려는 작업을 읽어 보세요. 특히 인쇄된 코드를 변경할 때 주의하세요.

## 자주 발생하는 문제

> **AI connectors 탭이 보이지 않음**
>
> 이 탭은 Admin과 Editor에게만 표시됩니다. Viewer는 어시스턴트를 연결할 수 없습니다. 액세스가 필요하면 워크스페이스 Admin에게 역할 변경을 요청하세요.

> **어시스턴트가 어떤 작업을 할 수 없다고 함**
>
> [할 수 있는 작업](/ko/ai-connectors/capabilities)을 확인하세요. 결제, QR 코드 삭제, 기타 QR 유형, 일부 디자인은 어시스턴트에서 사용할 수 없습니다. 이러한 작업은 GetQR 앱에서 하세요.

> **연결이 작동하지 않음**
>
> 연결이 만료되었거나 취소되었거나 구독이 비활성 상태일 수 있습니다. [문제 해결](/ko/ai-connectors/troubleshooting)을 참조하세요.

## 다음 단계

> **[Claude에 연결](/ko/ai-connectors/connect-claude)**

> **[ChatGPT에 연결](/ko/ai-connectors/connect-chatgpt)**

> **[Cursor에 연결](/ko/ai-connectors/connect-cursor)**


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