소개 | Goono MCP

Goono MCP 서버는 Goono 연구노트·연구파일·점검 데이터를 MCP(Model Context Protocol) 도구로 노출하는 원격 서버입니다. Claude Code, Claude Desktop, Cursor 같은 MCP 클라이언트에 등록하면 LLM이 프로젝트 → 폴더 → 노트로 드릴다운하며 조회하고 사용자 승인을 받은 뒤 폴더를 정리할 수 있습니다.

MCP 클라이언트 ──POST /mcp + X-Goono-Key──▶ MCP 서버 ──X-Goono-Key──▶ Goono Open API
 (Claude Code 등)                             형태만 검사              키 검증·권한·rate limit

할 수 있는 일

조회 — 프로젝트, 폴더, 연구노트 목록과 상세, 노트 파일 내용, 연구초안, 점검(리뷰) 현황
검색 — 워크스페이스 통합 검색(프로젝트·폴더·파일명·태그·OCR 본문)
정리 — 폴더 생성·이름 변경·삭제, 노트 이동 (write 스코프 키 필요)
프롬프트 — 연구노트 요약, 점검 리포트, 홈 파일 정리, 폴더 구조 개편 절차

용어 대응

Goono 화면	MCP 도구에서
연구 노트	프로젝트(`projects`)
연구 폴더	폴더(`folders`). 폴더 밖은 프로젝트 홈(`folderId: null`)
연구 파일	노트(`notes`). 노트 1건 = 업로드된 파일 1건
에디터 파일	연구초안(`research-drafts`)
점검	리뷰(`reviews`)

계층은 워크스페이스 → 프로젝트 → 폴더(1단계) → 노트입니다.

알아 둘 점

키 = 워크스페이스 1개. API 키는 워크스페이스 + 사용자 단위로 발급됩니다. 도구가 볼 수 있는 범위는 키 소유자의 Goono 권한과 정확히 같습니다.
서버는 크리덴셜을 저장하지 않습니다. 헤더로 들어온 키를 백엔드에 그대로 넘기고 만료·폐기·권한은 백엔드가 판정합니다.
전송 방식은 Streamable HTTP 하나입니다. stdio 패키지는 없습니다.
OAuth는 지원하지 않습니다. 커스텀 헤더를 보낼 수 없는 클라이언트(claude.ai 웹 커넥터 등)는 현재 연결할 수 없습니다.