Gujo 위에서 만들기
계정 API, MCP, gujoctl 로 앱·에셋·강의를 다룹니다. 에이전트는 MCP 로 연결하고, 되돌리기 어려운 일은 사람이 승인합니다.
Markdown 으로 보기Gujo Developers 는 내 Gujo 계정에 있는 제품을 프로그램과 에이전트에서 다루는 방법을 설명합니다.
세 가지 방법
| 방법 | 언제 쓰나 | 자격 |
|---|---|---|
| 계정 API | 스크립트나 앱에서 라이브러리·상품·주문·구독을 조회할 때 | 계정 API 키 |
| MCP | Claude·Cursor 같은 에이전트가 같은 일을 도구로 부르게 할 때 | 로그인(OAuth). CI·스크립트는 mcp.read 능력이 있는 계정 API 키 |
| gujoctl | 터미널에서 로그인하고 산 제품을 설치할 때 | 기기 로그인으로 받은 키(직접 만들 필요 없음) |
세 방법 모두 같은 계정 API 위에서 움직입니다. MCP 도구 하나는 계정 API 의 문 하나이고, gujoctl 도 같은 문을 부릅니다. 그래서 키의 능력과 오류 코드는 어느 쪽으로 부르든 같습니다.
- 키 만들기와 능력, 오류는 인증과 API 키에 있습니다.
- 에이전트 연결은 MCP 연결하기에 있습니다.
- 터미널 설치는 gujoctl에 있습니다.
- 모든 문의 경로·능력·입력 칸은 API 참조에 있습니다.
제품별 문서
- 앱 배포 피드: 데스크톱 앱이 업데이트를 받는 Sparkle appcast 피드와 다운로드 주소입니다.
- Design Gallery: design.gujo.ai 의 화면 갤러리, 디자인 MCP, 에이전트 토큰입니다.
첫 요청
curl https://api.gujo.ai/api/library \
-H "Authorization: Bearer $GUJO_API_KEY"
키를 만드는 것부터 MCP 연결까지는 시작하기에 순서대로 있습니다.
에이전트가 읽는 형식
- 모든 문서는 주소 끝에
.md를 붙이면 원문 Markdown 으로 받습니다.Accept: text/markdown머리글로 요청해도 같습니다. - 문서 전체 목차는
/llms.txt, 전문은/llms-full.txt에 있습니다. - 계정 API 의 기계용 명세는
/openapi.json(OpenAPI 3.1)입니다.
바뀐 점은 변경 기록에 모읍니다.