시작하기
API 키를 발급하고 MCP 클라이언트에서 첫 호출까지
API 키 발급
Goono에 로그인해 키를 쓸 워크스페이스의 API 키 관리 화면으로 이동합니다. 워크스페이스 멤버라면 누구나 본인 키를 발급할 수 있습니다. 키 이름, 스코프, 만료 시각(선택)을 정해 발급합니다.
| 스코프 | 할 수 있는 일 |
|---|---|
read | 조회·검색·파일 내려받기 |
write | read + 폴더 생성·이름 변경·삭제, 노트 이동 |
평문 키는 발급 직후 한 번만 보입니다
Goono는 키의 해시만 저장합니다. 잃어버리면 폐기하고 새로 발급하세요. 키는 .env, 커밋, 채팅 로그에 남기지 않습니다.
- 키 형식은
gno_live_<key_id>_<secret>입니다. 스테이징 환경은gno_test_로 시작합니다. - 키는 워크스페이스 + 사용자 단위입니다. 워크스페이스가 여럿이면 각각 키를 발급해 서버를 따로 등록합니다.
- 사용자당 워크스페이스마다 활성 키는 최대 10개입니다. 폐기는 즉시 반영됩니다.
키가 차단되는 경우
| 상황 | 결과 |
|---|---|
| 본인 또는 워크스페이스 관리자가 키를 폐기 | 다음 요청부터 401 KEY_DEACTIVATED |
| 키를 발급한 사용자가 워크스페이스에서 제외되거나 탈퇴 | 키가 자동 폐기되어 401 |
| 만료 시각이 지남 | 401 KEY_EXPIRED |
| 워크스페이스 플랜 만료 | 403 WORKSPACE_PLAN_INACTIVE. 키는 유지되며 플랜이 갱신되면 다시 동작 |
| 워크스페이스 IP 허용 목록 밖에서 호출 | 403 FORBIDDEN_BY_IP_ACL |
키 발급·폐기 이력은 감사 기록으로 남습니다.