연결 절차 개발 지식 필요 없음
- 1Quilo 계정으로 로그인
ChatGPT 연결 화면에서 이 Quilo 계정으로 로그인합니다.
- 2요청 권한 확인
ChatGPT가 사용할 기능을 확인하고 필요한 범위만 허용합니다.
- 3연결 완료
연결된 ChatGPT에서 Quilo 도구를 바로 확인합니다.
사용 방법을 고르면 필요한 절차만 보여드립니다. 개발 경험이 없어도 Test 연결부터 안전하게 시작할 수 있습니다.
한 가지를 선택하면 지금 필요한 단계만 펼쳐집니다.
ChatGPT 연결 화면에서 이 Quilo 계정으로 로그인합니다.
ChatGPT가 사용할 기능을 확인하고 필요한 범위만 허용합니다.
연결된 ChatGPT에서 Quilo 도구를 바로 확인합니다.
먼저 연결 확인용 최소 권한 토큰을 만듭니다.
QUILO_UPLOAD_ROOTS로 Codex가 사용할 폴더를 명시합니다.
설정 명령을 실행하고 Quilo 기능 목록을 확인합니다.
node ~/plugins/quilo/scripts/configure.mjs 'quilo_test_...'
export QUILO_UPLOAD_ROOTS="$HOME/Downloads:$HOME/Documents/Quilo"
codex plugin add quilo@personal
처음에는 계정 읽기만 허용한 Test 토큰을 권장합니다.
Bearer 토큰을 요청 헤더에 포함합니다.
GET /api/v1/account 응답으로 연결을 확인합니다.
curl https://quilolab.com/api/v1/account \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
{ "plan": "pro", "credits": 12 }Test로 안전하게 확인한 뒤, 실제 작업이 필요할 때만 Live로 바꿉니다.
토큰 권한은 그 연결이 할 수 있는 작업의 상한입니다. Pro·Max·관리자 권한을 새로 부여하지 않으며, 관리자 API로 승격할 수도 없습니다.
토큰은 생성 직후 한 번만 표시되고 1년 이내에 만료됩니다. 언제든 개별 폐기할 수 있습니다.
처음에는 계정 확인 요청 하나만 실행하고, 필요한 기능이 생기면 전체 문서를 펼쳐보세요.
모든 계정 API 요청의 Authorization 헤더에 Bearer 토큰을 포함합니다.
Authorization: Bearer YOUR_ACCESS_TOKEN
/api/catalog기능 목록/api/v1/account계정·크레딧/api/v1/jobs작업 목록/api/v1/files완료 파일/api/v1/reports보고서 생성/api/v1/tools/statistics통계 계산Idempotency-Key — 보고서·PDF 통번역 요청을 다시 보낼 때 같은 작업이 24시간 안에 중복 생성·과금되지 않도록 붙이는 식별값입니다.
Request ID — 오류 한 건을 API 기록과 고객지원에서 찾는 추적 번호입니다.
Codex나 API를 선택했다면 Test 토큰과 최소 권한으로 시작하세요. ChatGPT 연결에는 이 토큰이 필요하지 않습니다.
Test에서는 읽기·계산은 실제로 확인하고, 쓰기 작업은 저장·생성·과금 없이 시뮬레이션합니다.
최근 요청의 상태와 Request ID를 확인합니다. 오류가 나면 Request ID와 함께 문의하면 빠르게 찾을 수 있습니다.
| 시간 | 요청 | 상태 | 지연 | 오류 | Request ID |
|---|---|---|---|---|---|
| 로그인 후 표시됩니다. | |||||
기능 카탈로그를 불러오는 중...