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

# 할 수 있는 작업

> GetQR 커넥터로 할 수 있는 모든 작업을 영역별로 정리했습니다.

이 페이지에는 GetQR에서 어시스턴트에게 요청할 수 있는 모든 작업이 나와 있습니다. 어시스턴트가 알맞은 도구를 선택하며, 도구 이름은 참고용으로만 표시됩니다.

## 시작하기 전에

* 어시스턴트를 연결하세요: [Claude](/ko/ai-connectors/connect-claude), [ChatGPT](/ko/ai-connectors/connect-chatgpt) 또는 [Cursor](/ko/ai-connectors/connect-cursor).
* 어시스턴트는 사용자의 역할과 동일한 권한을 가집니다. 멤버 관리는 워크스페이스 Admin만 사용할 수 있습니다.

## QR 코드

| 요청할 수 있는 작업 | 세부 정보 | 도구 |
| - | - | - |
| QR 코드 목록 조회 또는 검색 | 페이지당 최대 50개. 활성 또는 일시 중지된 코드로 필터링합니다. | `list_qrs` |
| QR 코드 하나의 세부 정보 보기 | 목적지, 단축 링크, 스캔, 디자인, 비밀번호 및 일정 설정. | `get_qr` |
| 웹사이트 QR 코드 생성 | 목적지 URL, 선택 사항인 제목, 사용자 지정 단축 링크, 사용자 지정 도메인, 템플릿 또는 디자인. 비밀번호, 활성화 날짜, 일시 중지 날짜, 스캔 한도도 설정할 수 있습니다. | `create_qr` |
| QR 코드 변경 | 제목, 목적지 URL, 디자인, 템플릿, 비밀번호, 활성화 날짜, 일시 중지 날짜 또는 스캔 한도. | `update_qr` |
| QR 코드 일시 중지 또는 재개 | 일시 중지된 코드는 **My QR Codes**에 남아 있으며 Paused로 표시됩니다. | `set_qr_status` |
| 사용자 지정 단축 링크 사용 가능 여부 확인 | 3–15자: 영문 소문자, 숫자, 하이픈, 밑줄. 하이픈이나 밑줄로 시작하거나 끝날 수 없고 연속으로 사용할 수 없습니다. | `check_link_availability` |
| QR 코드 다운로드 | JPG, PNG, SVG, PDF(A4) 또는 EPS. JPG, PNG, EPS는 1024, 2048 또는 4096px. Branded 디자인과 AI 디자인은 1024px JPG 또는 PNG, 또는 PDF로 다운로드됩니다. 링크는 1시간 동안 유효합니다. | `download_qr` |

> [!WARNING]
>
> QR 코드를 만든 후에는 단축 링크를 변경할 수 없습니다. 인쇄된 QR 코드의 목적지 URL을 변경하면 인쇄된 모든 사본의 목적지가 바뀝니다.

## 디자인

| 요청할 수 있는 작업 | 세부 정보 | 도구 |
| - | - | - |
| 디자인 옵션 보기 | 프레임, QR 모양, 눈 모양, 추천 로고, 로고 크기(15–45%), 프레임 문구(최대 12자), 색상 견본. | `get_customization` |
| QR 코드 스타일 지정 | QR 코드를 만들거나 변경할 때 디자인을 전달합니다. | `create_qr`, `update_qr` |

어시스턴트에서 사용할 수 없는 기능: 업로드한 로고, Convert logo to QR, Branded 디자인, AI 디자인. 이러한 기능은 [QR 코드 빌더](/ko/design/overview)를 사용하세요.

## 분석

| 요청할 수 있는 작업 | 세부 정보 | 도구 |
| - | - | - |
| 스캔 통계 가져오기 | 워크스페이스 전체 또는 QR 코드 하나. 합계, 기간별 스캔, 국가, 도시, 기기, 브라우저, OS 등의 세부 분석. 기간: 최근 24시간, 7일, 30일 또는 90일, 1년, 월초·분기초·연초부터 현재까지, 전체 기간 또는 사용자 지정 날짜. | `get_analytics` |
| 스캔 데이터 내보내기 | CSV 또는 XLSX, 스캔당 한 행: QR 이름, QR 유형, 스캔 날짜(UTC), 국가, 도시, 대륙, 기기, OS, 브라우저, 목적지 URL. 기본 기간: 30일. 링크는 1시간 동안 유효합니다. | `export_analytics` |

## 템플릿

| 요청할 수 있는 작업 | 세부 정보 | 도구 |
| - | - | - |
| 템플릿 목록 조회 | 이름 및 생성 날짜. | `list_templates` |
| 디자인을 템플릿으로 저장 | 이름 최대 40자. 디자인만 저장됩니다. | `create_template` |
| 템플릿 적용 | QR 코드를 만들거나 변경할 때. | `create_qr`, `update_qr` |

## 예약 보고서

| 요청할 수 있는 작업 | 세부 정보 | 도구 |
| - | - | - |
| 예약 보고서 목록 조회 | 이름, 빈도, 범위, 상태, 다음 실행. | `list_scheduled_reports` |
| 예약 보고서 생성 | 매일, 매주 또는 매월. 모든 QR 코드, 선택한 코드 또는 코드 하나 대상. 선택 사항인 PDF. 이름 최대 40자. | `create_scheduled_report` |
| 보고서 변경, 일시 중지 또는 재개 | 모든 설정 또는 상태. | `update_scheduled_report` |
| 보고서 삭제 | | `delete_scheduled_report` |

## 대량 생성

| 요청할 수 있는 작업 | 세부 정보 | 도구 |
| - | - | - |
| 웹사이트 QR 코드 대량 생성 | 이름과 URL 목록으로 최대 100개 코드를 생성하며, 모두에 하나의 템플릿 또는 디자인을 적용합니다. 한 번에 하나의 대량 작업만 실행할 수 있습니다. | `create_bulk_qr_creation` |
| 진행 상황 확인 및 다운로드 | 상태 및 진행률. 완료되면 1시간 동안 유효한 ZIP 다운로드 링크가 제공됩니다. | `get_bulk_qr_creation` |
| 대량 작업 중지 | | `abort_bulk_qr_creation` |

## 사용자 지정 도메인

워크스페이스에서 사용자 지정 도메인이 활성화된 경우 사용할 수 있습니다.

| 요청할 수 있는 작업 | 세부 정보 | 도구 |
| - | - | - |
| 도메인 목록 조회 또는 보기 | 호스트 이름, 상태, 기본 도메인, DNS 레코드, 링크 수. | `list_domains`, `get_domain` |
| 하위 도메인 연결 | 예: `qr.yourbrand.com`. 루트 도메인과 `www`는 허용되지 않습니다. 어시스턴트가 DNS 제공업체에 추가할 CNAME 레코드를 알려 줍니다. | `add_domain` |
| 도메인 확인 | DNS와 인증서를 즉시 확인합니다. | `check_domain` |
| 실패한 인증서 재시도 | 시간당 재시도 횟수가 제한됩니다. | `retry_domain` |
| 도메인을 기본값으로 설정 | 활성 상태인 도메인만 가능. 새 QR 코드는 기본적으로 이 도메인을 사용합니다. | `set_default_domain` |

QR 코드를 내 도메인에 연결하려면 도메인이 활성 상태여야 하고 QR 코드에 사용자 지정 단축 링크가 있어야 합니다.

## 멤버(Admin 전용)

| 요청할 수 있는 작업 | 세부 정보 | 도구 |
| - | - | - |
| 멤버 및 초대 목록 조회 | | `list_members` |
| 사용자 초대 | 이메일로 Editor 또는 Viewer로 초대합니다. | `invite_member` |
| 멤버 역할 변경 | Editor 또는 Viewer. | `change_member_role` |
| 멤버 삭제 | | `remove_member` |

## 사용할 수 없는 기능

* 구독, 결제, 계정 삭제.
* 웹사이트 이외의 QR 유형 생성.
* QR 코드 삭제(일시 중지는 가능).
* 생성 후 단축 링크 변경.
* 업로드한 로고, Convert logo to QR, Branded 디자인, AI 디자인.

## 자주 발생하는 문제

> **다운로드 링크가 열리지 않음**
>
> 다운로드 및 내보내기 링크는 1시간 동안 유효합니다. 어시스턴트에게 새 링크를 요청하세요.

> **내보내기 링크에 빈 페이지가 표시됨**
>
> 대용량 내보내기는 생성하는 데 시간이 걸립니다. 1분 정도 기다린 후 링크를 다시 여세요. 5분 정도 지나도 비어 있으면 더 짧은 기간이나 CSV로 다시 내보내기를 요청하세요.

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

> **사용자 지정 단축 링크가 이미 사용 중임**
>
> 단축 링크는 요청 시점에 확인되지만 예약되지는 않습니다. QR 코드가 생성되기 전에 다른 사람이 사용할 수 있습니다. 다른 링크를 선택하세요.

## 다음 단계

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

> **[문제 해결](/ko/ai-connectors/troubleshooting)**


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