# 변경 기록

> 개발자 문서와 공개 계약의 바뀐 점.

호환되지 않는 변경에는 **호환 깨짐** 표시를 붙입니다.

## 2026-10

### MCP 를 로그인으로 연결합니다 (2026-10-04)

- 고객 MCP(`https://api.gujo.ai/api/mcp`)는 키 없이 연결합니다. 클라이언트에 주소만 넣으면 처음 쓸 때 브라우저에서 Gujo 계정으로 로그인하고 권한에 동의해 토큰을 받습니다(OAuth, MCP 2025-11-25 authorization).
- [MCP 연결하기](mcp/index.md)의 설치 버튼과 설정은 이제 주소만 담습니다. Cursor·VS Code 는 버튼으로, Claude Code 는 `claude mcp add --transport http gujo <주소>` 뒤 `/mcp` 로, Codex 는 `codex mcp add gujo --url <주소>` 뒤 `codex mcp login gujo` 로, Claude.ai 는 커스텀 커넥터에 주소를 넣어 연결합니다.
- 기본 권한은 `mcp.read`·`products.read` 이고, 앱이 더 청한 권한은 동의 화면에서 체크해야 들어갑니다. 접근 토큰은 1시간이고 클라이언트가 스스로 갱신합니다. 연결한 앱은 계정 보안 설정의 **연결된 앱** 에서 보고 끊습니다.
- 계정 API 키로 붙이는 방식은 그대로 동작합니다. CI·스크립트용으로 클라이언트마다 **키로 붙이기** 에 남겼습니다. 바뀐 점과 고를 기준은 [인증과 API 키](auth.md)에 있습니다.
- 스태프 MCP 도 사람 스태프는 로그인으로 연결합니다. 안내는 스태프 문서에 있습니다.

### 고객 MCP 를 계정 API 에서 만듭니다 (호환 깨짐)

- 고객 MCP(`https://api.gujo.ai/api/mcp`)의 도구를 계정 API 에서 만듭니다. 계정 API 키로 부르는 문 하나가 도구 하나이고, 도구 이름은 [API 참조](api-reference.md)의 `tool` 칸입니다.
- **호환 깨짐**: 사용자가 등록한 MCP 서버·도구 행으로 만들던 옛 도구(`mcp_tool_{id}` 꼴 이름)를 없앴습니다. 그 이름으로 부르면 `-32602 Unknown tool` 입니다. 같은 일은 새 도구 이름으로 부릅니다.
- 처음 도구 목록은 메타 도구 `search_tools`·`enable_toolset`·`disable_toolset` 과 `library` 묶음입니다. 나머지는 묶음을 켜서 씁니다. 자세한 내용은 [MCP 연결하기](mcp/index.md)에 있습니다.
- 세션은 `initialize` 응답의 `Mcp-Session-Id` 머리글로 이어집니다.

### 스태프 MCP 와 사람 승인

- Gujo 스태프와 운영 에이전트가 쓰는 스태프 MCP 를 열었습니다. 에이전트는 조회와 되돌릴 수 있는 일을 바로 하고, 되돌리기 어려운 일은 승인 요청만 만듭니다. 사람 스태프가 승인하면 서버가 그 일을 한 번 실행합니다.
- 고객 MCP 와 자격·도구가 따로이고, 고객 키로는 부를 수 없습니다. 안내는 스태프 문서에만 있습니다.

### Design Gallery 실화면에 로그인이 필요합니다

- design.gujo.ai 의 실화면 갤러리, 화면 JSON(`/api/v1/*`), 디자인 이미지, 코드 자산, 검색 제안은 로그인한 Gujo 회원이나 `read` 역할 디자인 에이전트 토큰에만 열립니다. 로그인하지 않은 화면 요청은 로그인 벽, JSON·이미지 요청은 401 입니다.
- 랜딩·스타일·토큰·컴포넌트·패턴 문서와 MCP 안내는 공개 그대로입니다. 디자인 MCP 와 문서 API 의 자격은 바뀌지 않았습니다. 자세한 내용은 [Design Gallery](design.md)에 있습니다.

### 개발자 문서 사이트

- 개발자 문서 사이트를 열었습니다. 모든 문서를 `.md` 원문과 `/llms.txt`·`/llms-full.txt` 로도 받을 수 있습니다.
- [API 참조](api-reference.md)와 [`/openapi.json`](https://developers.gujo.ai/openapi.json)을 서버 라우터에서 만들어 싣습니다.
- [MCP 연결하기](mcp/index.md)에 클라이언트별 설치 버튼과 복사용 설정을 더했습니다.