클라이언트 등록
Claude Code, Claude Desktop, Cursor, VS Code에 Goono MCP 서버를 등록하는 방법
Goono MCP 서버는 Streamable HTTP 엔드포인트 하나(POST /mcp)와 X-Goono-Key 헤더 인증을 씁니다. HTTP 전송과 커스텀 헤더를 지원하는 클라이언트라면 URL과 헤더만 넣으면 됩니다.
| 항목 | 값 |
|---|---|
| 서버 URL | http://192.168.200.21:30021/mcp — 개발 서버, 사내망 전용 (HTTPS 전환 전 임시) |
| 인증 헤더 | X-Goono-Key: gno_live_<key_id>_<secret> |
| 전송 방식 | Streamable HTTP (stateless). SSE·stdio 미지원 |
아래 예시의 gno_live_<key_id>_<secret>를 발급받은 키로 바꾸세요. 스테이징 환경 키는 gno_test_로 시작합니다.
터미널에서 한 줄로 등록합니다.
claude mcp add --transport http goono http://192.168.200.21:30021/mcp \
--header "X-Goono-Key: gno_live_<key_id>_<secret>"- Claude Code에서
/mcp를 실행해goono가 connected 상태인지 확인합니다. - "내 프로젝트 목록 보여줘"처럼 물어보면
get_me→list_projects순으로 호출됩니다.
프로젝트 단위로만 쓰려면 --scope project를 붙여 .mcp.json에 기록합니다. 이 경우 키가 파일에 남으므로 커밋하지 마세요.
그 밖의 클라이언트
Windsurf, Codex 등 "HTTP 전송 + 커스텀 헤더"를 지원하는 클라이언트는 위와 같은 URL·헤더 조합으로 등록할 수 있습니다. 헤더를 지원하지 않는 클라이언트는 Claude Desktop 예시처럼 mcp-remote로 감싸면 됩니다.
claude.ai 웹 커넥터는 현재 연결할 수 없습니다
claude.ai의 커스텀 커넥터는 OAuth만 지원하고 커스텀 헤더를 보낼 수 없습니다. Goono MCP 서버는 API 키 헤더 인증만 제공하므로 지원 대상이 아닙니다.
연결 확인
등록 직후 아래 흐름이 정상이면 연결된 것입니다.
get_me— 키 소유자, 워크스페이스, 스코프를 반환합니다.list_projects— 키 소유자가 멤버인 프로젝트 목록을 반환합니다.
401이 반복되면 헤더 이름(X-Goono-Key)과 키 접두사(gno_live_ / gno_test_)를 확인하세요. 서버는 헤더 존재와 접두사 형식만 검사하고 유효성은 Goono 백엔드가 판정합니다.