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

# 문제 해결

> Claude, ChatGPT, Cursor에서 GetQR 커넥터를 사용할 때 자주 발생하는 문제를 해결하세요.

표시되는 메시지나 증상을 찾은 다음 해결 방법을 따르세요. 대부분의 문제는 멤버 역할, 구독 또는 만료된 연결 때문에 발생합니다.

## 빠른 확인

무엇보다 먼저 다음 세 가지를 확인하세요.

1. **역할.** 워크스페이스에서 Admin 또는 Editor여야 합니다. Viewer는 AI 커넥터를 사용할 수 없습니다.
2. **구독.** 워크스페이스 Admin의 구독이 활성 상태여야 합니다.
3. **연결.** **My Account** → **AI connectors**에서 어시스턴트가 **Active**로 표시되어야 합니다.

## 연결 중

> **“AI connectors aren't available”**
>
> GetQR 로그인 페이지에 "Viewers can't connect AI assistants. Ask an editor or the workspace owner."가 표시됩니다. 역할이 Viewer입니다. 워크스페이스 Admin에게 Editor로 역할을 변경해 달라고 요청하세요. [역할 및 권한](/ko/members/roles-and-permissions)을 참조하세요.

> **“An active subscription is required”**
>
> AI 어시스턴트는 활성 구독이 있는 GetQR 계정에만 연결할 수 있습니다.
>
> * **Admin:** **View plans**를 클릭해 갱신하세요. 결제 관련 질문은 [고객센터](https://getqr.com/help)를 참조하세요.
> * **Editor:** 페이지에 "The workspace owner needs an active subscription before you can connect an AI assistant."가 표시됩니다. 워크스페이스 Admin에게 문의하세요.

> **“This connection request is invalid”**
>
> GetQR로 보낸 앱을 인식할 수 없거나 리디렉션 주소가 일치하지 않습니다. 창을 닫고 어시스턴트에서 다시 연결하세요. 문제가 계속되면 어시스턴트에서 GetQR을 삭제하고 `https://getqr.com/api/mcp`로 다시 추가하세요.

> **“Couldn't connect this assistant. Try again.”**
>
> **Allow**를 클릭한 후 승인에 실패했습니다. **Allow**를 다시 클릭하거나 어시스턴트에서 연결을 다시 시작하세요.

> **GetQR 대화 상자가 “Waiting for…”에서 멈춤**
>
> GetQR은 연결을 승인할 때까지 기다립니다. 어시스턴트에서 로그인을 완료하고 GetQR 페이지에서 **Allow**를 클릭하세요. 대화 상자가 자동으로 업데이트됩니다. 어시스턴트 탭을 닫았다면 **Cancel**을 클릭하고 다시 시작하세요.

> **ChatGPT: “Set up ChatGPT on desktop”**
>
> ChatGPT 모바일 앱에서는 커넥터를 추가할 수 없습니다. 컴퓨터에서 chatgpt.com을 열어 GetQR을 연결하세요. [ChatGPT에 연결](/ko/ai-connectors/connect-chatgpt)을 참조하세요.

> **Cursor: “Set up Cursor on desktop”**
>
> Cursor는 데스크톱 앱이므로 컴퓨터에서만 연결할 수 있습니다. [Cursor에 연결](/ko/ai-connectors/connect-cursor)을 참조하세요.

> **Open Cursor 버튼으로 Cursor가 열리지 않음**
>
> Cursor 데스크톱 앱을 설치하고 브라우저가 앱을 열도록 허용하세요. 또는 `mcp.json`에 GetQR을 직접 추가하세요. [Cursor에 연결](/ko/ai-connectors/connect-cursor#수동으로-추가하기)을 참조하세요.

> **Connect 대화 상자에서 어시스턴트가 회색으로 비활성화됨**
>
> 이미 계정에 연결되어 있습니다. 처음부터 다시 시작하려면 먼저 연결을 취소하세요. [연결 관리](/ko/ai-connectors/manage-connections)를 참조하세요.

## 연결 후

> **어시스턴트가 토큰이 유효하지 않거나 만료되었다고 함**
>
> 액세스 토큰은 1시간 동안 유효하며 어시스턴트가 자동으로 갱신합니다. 어시스턴트를 30일 동안 사용하지 않았거나 연결이 취소된 경우 갱신에 실패합니다. 어시스턴트에서 다시 연결하고 **Allow**를 클릭하세요. [어시스턴트 다시 연결](/ko/ai-connectors/manage-connections#어시스턴트-다시-연결)을 참조하세요.

> **연결에 Expired가 표시됨**
>
> 어시스턴트를 30일 동안 사용하지 않았습니다. 어시스턴트에서 다시 연결하세요. 연결이 다시 **Active**로 표시됩니다.

> **커넥터가 작동하다가 “Active subscription required”와 함께 중지됨**
>
> 워크스페이스 구독이 더 이상 활성 상태가 아닙니다. 갱신될 때까지 모든 연결이 작동하지 않습니다. Admin은 GetQR에서 요금제를 확인할 수 있습니다. 결제 관련 질문은 [고객센터](https://getqr.com/help)를 참조하세요.

> **커넥터가 “AI connectors are not available for this role.”과 함께 중지됨**
>
> 역할이 Viewer로 변경되었거나 워크스페이스에서 삭제되었습니다. 워크스페이스 Admin에게 Editor 역할을 요청하세요.

> **어시스턴트가 GetQR을 사용하지 않음**
>
> "Using GetQR, list my QR codes"처럼 프롬프트에 GetQR을 언급하세요. 어시스턴트에서 이 채팅에 커넥터가 켜져 있는지 확인하세요.

> **어시스턴트가 잘못된 워크스페이스에서 작업함**
>
> 연결은 하나의 워크스페이스에 연결됩니다. 기본 워크스페이스 또는 처음 가입한 워크스페이스입니다. 

## 작업 및 결과

> **어시스턴트가 vCard, PDF 또는 기타 QR 유형을 만들 수 없음**
>
> 커넥터는 웹사이트 QR 코드만 생성합니다. 다른 유형은 [QR 코드 빌더](/ko/qr-types/overview)에서 만드세요.

> **어시스턴트가 단축 링크를 변경할 수 없음**
>
> QR 코드를 만든 후에는 단축 링크를 변경할 수 없습니다. 원하는 단축 링크로 새 QR 코드를 만드세요.

> **어시스턴트가 멤버를 관리할 수 없음**
>
> 멤버 관리는 워크스페이스 Admin만 사용할 수 있습니다. Editor에게는 권한 오류가 표시됩니다.

> **어시스턴트가 업로드한 로고나 AI 디자인을 사용할 수 없음**
>
> 업로드한 로고, Convert logo to QR, Branded 디자인, AI 디자인은 커넥터에서 사용할 수 없습니다. 추천 로고를 사용하거나 앱에서 코드 스타일을 지정하세요.

> **다운로드 또는 내보내기 링크가 작동하지 않음**
>
> 링크는 1시간 동안 유효합니다. 어시스턴트에게 새 링크를 요청하세요. 대용량 내보내기의 경우 빈 페이지는 파일이 아직 준비되지 않았다는 뜻이니 1분 정도 기다리세요. 5분 정도 지나도 비어 있으면 더 짧은 기간이나 CSV로 다시 내보내기를 요청하세요.

> **QR 코드에 도메인을 사용할 수 없음**
>
> 도메인이 활성 상태여야 하고 QR 코드에 사용자 지정 단축 링크가 있어야 합니다. 어시스턴트에게 도메인 확인을 요청하세요. 활성 상태가 아니면 어시스턴트가 알려 주는 CNAME 레코드를 DNS 제공업체에 추가하고(프록시 없이 DNS 전용) 1분 후 다시 확인하세요. [도메인 확인 및 문제 해결](/ko/custom-domains/verify-and-troubleshoot)을 참조하세요.

> **어시스턴트가 결제나 계정 삭제에 대해 물어봄**
>
> 구독, 결제, 계정 삭제는 어시스턴트에서 사용할 수 없습니다. GetQR 앱 또는 [고객센터](https://getqr.com/help)를 이용하세요.

## 여전히 해결되지 않나요?

사용 중인 어시스턴트, 요청한 내용, 표시된 오류 메시지를 적어 [help@getqr.com](mailto:help@getqr.com)으로 이메일을 보내세요.

## 다음 단계

> **[연결 관리](/ko/ai-connectors/manage-connections)**

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


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