# Gujo 위에서 만들기

> 계정 API, MCP, gujoctl 로 앱·에셋·강의를 다룹니다. 에이전트는 MCP 로 연결하고, 되돌리기 어려운 일은 사람이 승인합니다.

Gujo Developers 는 내 Gujo 계정에 있는 제품을 프로그램과 에이전트에서 다루는 방법을 설명합니다.

## 세 가지 방법

| 방법 | 언제 쓰나 | 자격 |
|---|---|---|
| **계정 API** | 스크립트나 앱에서 라이브러리·상품·주문·구독을 조회할 때 | 계정 API 키 |
| **MCP** | Claude·Cursor 같은 에이전트가 같은 일을 도구로 부르게 할 때 | 로그인(OAuth). CI·스크립트는 `mcp.read` 능력이 있는 계정 API 키 |
| **gujoctl** | 터미널에서 로그인하고 산 제품을 설치할 때 | 기기 로그인으로 받은 키(직접 만들 필요 없음) |

세 방법 모두 같은 계정 API 위에서 움직입니다. MCP 도구 하나는 계정 API 의 문 하나이고, gujoctl 도 같은 문을 부릅니다. 그래서 키의 능력과 오류 코드는 어느 쪽으로 부르든 같습니다.

- 키 만들기와 능력, 오류는 [인증과 API 키](auth.md)에 있습니다.
- 에이전트 연결은 [MCP 연결하기](mcp/index.md)에 있습니다.
- 터미널 설치는 [gujoctl](gujoctl.md)에 있습니다.
- 모든 문의 경로·능력·입력 칸은 [API 참조](api-reference.md)에 있습니다.

## 제품별 문서

- [앱 배포 피드](distribution-feeds.md): 데스크톱 앱이 업데이트를 받는 Sparkle appcast 피드와 다운로드 주소입니다.
- [Design Gallery](design.md): design.gujo.ai 의 화면 갤러리, 디자인 MCP, 에이전트 토큰입니다.

## 첫 요청

```bash
curl https://api.gujo.ai/api/library \
  -H "Authorization: Bearer $GUJO_API_KEY"
```

키를 만드는 것부터 MCP 연결까지는 [시작하기](getting-started.md)에 순서대로 있습니다.

## 에이전트가 읽는 형식

- 모든 문서는 주소 끝에 `.md` 를 붙이면 원문 Markdown 으로 받습니다. `Accept: text/markdown` 머리글로 요청해도 같습니다.
- 문서 전체 목차는 `/llms.txt`, 전문은 `/llms-full.txt` 에 있습니다.
- 계정 API 의 기계용 명세는 [`/openapi.json`](https://developers.gujo.ai/openapi.json)(OpenAPI 3.1)입니다.

바뀐 점은 [변경 기록](changelog.md)에 모읍니다.