변경 기록

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

Markdown 으로 보기

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

2026-10

고객 MCP(https://api.gujo.ai/api/mcp)는 키 없이 연결합니다. 클라이언트에 주소만 넣으면 처음 쓸 때 브라우저에서 Gujo 계정으로 로그인하고 권한에 동의해 토큰을 받습니다(OAuth, MCP 2025-11-25 authorization).
MCP 연결하기의 설치 버튼과 설정은 이제 주소만 담습니다. 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 키에 있습니다.
스태프 MCP 도 사람 스태프는 로그인으로 연결합니다. 안내는 스태프 문서에 있습니다.

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

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

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