지원 도구
Goono MCP 서버가 제공하는 도구 18종의 역할과 예시 프롬프트
도구는 진입점 1종, 조회 9종, 점검 4종, 쓰기 4종입니다. 계층은 워크스페이스 → 프로젝트 → 폴더(1단계) → 노트이고, 키가 워크스페이스 1개에 귀속되므로 get_me가 진입점입니다.
공통 규칙
- 도구가 볼 수 있는 범위는 키 소유자의 Goono 권한과 같습니다. 코드별 의미는 에러 코드와 권한에 있습니다.
- 각 도구는 rate limit 버킷(
default/content/write)에 속합니다. Rate limit을 참고하세요.
진입점
get_me
키 소유자, 워크스페이스, 키의 스코프를 확인합니다. 연동 후 첫 호출로 키가 어느 워크스페이스에 어떤 권한으로 발급됐는지 확인할 때 씁니다.
예시 프롬프트
- 내 Goono 키가 어느 워크스페이스에 연결돼 있어?
- 이 키로 쓰기 작업이 가능해?
프로젝트·폴더 조회
list_projects
키 소유자가 멤버인 프로젝트만 보여줍니다. 대상 프로젝트가 모호하고 후보가 2개 이상이면 LLM이 목록을 제시하고 되묻습니다.
예시 프롬프트
- 내 프로젝트 목록 보여줘
- 최근에 만든 프로젝트 5개만 알려줘
get_project
프로젝트의 멤버와 폴더 구조를 보여줍니다.
예시 프롬프트
- "면역학 실험" 프로젝트에 누가 참여하고 있어?
- 이 프로젝트의 폴더 구조를 보여줘
list_folders
프로젝트의 폴더 목록입니다. 폴더는 1단계 깊이뿐이며, 폴더가 100개를 넘는 프로젝트에서만 따로 호출됩니다.
예시 프롬프트
- 이 프로젝트에 폴더가 몇 개야?
- 폴더 이름만 쭉 보여줘
연구노트·검색·파일
list_notes
사용자의 자연어 조건을 필터로 번역해 노트를 찾습니다. 작성일, 작성자, 원본 확장자, 태그, 파일명, 본문 텍스트로 거를 수 있고 조건은 모두 동시에 만족해야 합니다. 폴더를 지정하지 않으면 프로젝트 전체가 대상입니다.
태그 목록 API가 없습니다. 추측한 태그를 넣으면 빈 결과가 나오므로, LLM은 먼저 기존 노트의 태그를 보고 정확한 값을 고릅니다.
예시 프롬프트
- 지난달에 김연구원이 올린 PDF 파일 보여줘
- "PCR" 태그가 붙은 노트 중 최근 10개
- 본문에 "western blot"이 들어간 노트 찾아줘
get_note
노트의 상세 정보와 공증 여부를 보여줍니다. 파일이 아직 변환 중이면 파일 조회가 변환본 대신 원본을 줍니다.
예시 프롬프트
- 이 노트 공증됐어? 언제?
search
프로젝트·폴더·파일명·태그·OCR 본문 5개 섹션을 한 번에 검색합니다. 일부 섹션만 실패하면 나머지 결과는 그대로 유효합니다. OCR 본문 검색은 워크스페이스에 활성 플랜이 없으면 빈 결과입니다.
예시 프롬프트
- 워크스페이스 전체에서 "mitochondria" 찾아줘
- 파일명에 "2026-03"이 들어간 노트가 어느 프로젝트에 있어?
get_note_file
노트 내용에 접근하는 유일한 경로입니다. 파일 종류에 따라 이미지, 텍스트, 첨부 리소스 중 하나로 돌려줍니다. 변환본·원본·썸네일을 고를 수 있고, 변환 중이면 원본을 줍니다.
512KB를 넘는 파일은 내용을 읽을 수 없습니다
크기는 저장된 암호문 기준이라 평문보다 블록 패딩만큼 큽니다. OCR 텍스트를 노출하지 않으므로 대체 수단이 없습니다.
예시 프롬프트
- 이 노트 내용 요약해줘
- 어제 올린 실험 결과 이미지 보여줘
list_research_drafts
에디터로 작성한 연구초안 목록입니다. 상태로 거를 수 있습니다. 프로젝트 RW 권한이 필요합니다.
예시 프롬프트
- 작성 중인 연구초안 목록 보여줘
- 보관된 초안이 있어?
get_research_draft
연구초안의 정보와 본문을 보여줍니다. 본문 조회만 실패하면 정보는 그대로 두고 사유를 함께 알려줍니다. 초안이 변환 중이면 본문이 아직 없을 수 있습니다. 프로젝트 RW 권한이 필요하며, READONLY 멤버는 볼 수 없습니다.
예시 프롬프트
- "3월 실험 계획" 초안 내용 요약해줘
- 이 초안이 지금 어떤 상태야?
점검(리뷰)
점검 목록은 프로젝트 단위입니다. 워크스페이스 전체 점검 목록은 없습니다.
list_reviews
프로젝트의 점검 목록입니다. 요청자, 점검자, 진행 상태, 파일 수가 함께 옵니다. 상태로 거를 수 있습니다.
예시 프롬프트
- 이 프로젝트에서 반려된 점검 있어?
get_review
점검 한 건의 상세입니다. 점검자별 반려 사유와 응답 시각, 요청자 메모, 재요청 횟수를 보여줍니다.
예시 프롬프트
- 이 점검이 왜 반려됐어?
- 점검 요청자가 남긴 메모 보여줘
list_review_files
점검에 포함된 파일 목록입니다. 아직 변환이 끝나지 않은 파일은 내용을 바로 읽지 못할 수 있습니다.
예시 프롬프트
- 이 점검에 포함된 파일이 뭐야?
- 점검 대상 파일 중 PDF만 알려줘
get_review_file
점검 파일의 내용입니다. 노트 파일 내용과 같은 규칙(변환본·원본·썸네일, 512KB 상한)이 적용됩니다.
예시 프롬프트
- 점검 중인 첫 번째 파일 내용 요약해줘
- 반려된 점검의 파일 내용 보여줘
쓰기
쓰기 4종은 write 스코프 키와 프로젝트 RW 권한이 필요합니다. 사용자에게 보이는 정리 상태를 바꾸므로, LLM은 계획을 먼저 제시하고 승인을 받은 뒤 호출하도록 안내받습니다. 여러 건은 한 건씩 순차로 처리합니다.
create_folder
프로젝트에 폴더를 만듭니다. 하위 폴더는 만들 수 없습니다(1단계).
예시 프롬프트
- "2026 상반기" 폴더 만들어줘
- 실험 종류별로 폴더 세 개 만들어줘
rename_folder
폴더 이름을 바꿉니다.
예시 프롬프트
- "임시" 폴더 이름을 "원본 자료"로 바꿔줘
- 폴더 이름에 연도를 붙여줘
delete_folder
빈 폴더만 지워지며 되돌릴 수 없습니다. 노트가 남아 있거나 GitHub 저장소가 연동돼 있으면 거부됩니다. 프로젝트 삭제 잠금이 켜져 있으면 프로젝트 관리자만 지울 수 있습니다.
예시 프롬프트
- 비어 있는 폴더 지워줘
- "임시" 폴더 삭제해줘
move_note
노트 1건을 다른 폴더나 다른 프로젝트로 옮깁니다. 프로젝트 간 이동은 출발 프로젝트 ADMIN + 도착 프로젝트 RW 권한이 필요하고, 점검이 필수인 프로젝트로는 옮길 수 없습니다.
예시 프롬프트
- 홈에 있는 PDF들을 "원본 자료" 폴더로 옮겨줘 (분류안을 먼저 보여주고 승인 후 실행)
도구 요약표
| 도구 | 버킷 | 스코프 | 비고 |
|---|---|---|---|
get_me | default | read | 진입점 |
list_projects | default | read | |
get_project | default | read | 멤버·폴더 포함 |
list_folders | default | read | |
list_notes | default | read | 조건 동시 만족 |
get_note | default | read | 공증 정보 포함 |
search | default | read | 5섹션 |
get_note_file | content | read | 512KB 상한 |
list_research_drafts | default | read | 프로젝트 RW 필요 |
get_research_draft | content | read | 프로젝트 RW 필요 |
list_reviews | default | read | 프로젝트 단위 |
get_review | default | read | |
list_review_files | default | read | |
get_review_file | content | read | 512KB 상한 |
create_folder | write | write | |
rename_folder | write | write | |
delete_folder | write | write | 빈 폴더만 |
move_note | write | write | 단건 |