메인 콘텐츠로 건너뛰기

​
개요

get_note_folders는 역방향 조회 도구입니다. 노트 GUID를 주면 그 노트가 속한 폴더 목록을 반환합니다. “이 노트는 어느 폴더에 들어 있나?”라는 질문에 답할 때 사용하며, 폴더 안의 노트를 나열하는 list_notes의 filter.folderId와 정반대 방향입니다. 폴더 검색 도구와는 용도가 다릅니다. 폴더 이름으로 폴더 트리를 탐색·검색하려면 search_private_folders / search_team_folders를, 이미 노트를 가지고 있고 그 노트의 폴더 소속을 알고 싶으면 get_note_folders를 사용하세요. 주요 사용 사례:
  • 노트가 위치한 곳 표시(“이 노트는 Engineering > Q1 Planning 아래에 정리되어 있습니다”).
  • 후속으로 어떤 폴더 검색 도구를 쓸지 판단: 각 결과의 isTeamFolder 플래그로 해당 폴더가 팀(워크스페이스 공유) 폴더인지 개인 폴더인지 알 수 있습니다.

​
파라미터

파라미터타입필수설명
noteGuidstring필수폴더 목록을 조회할 노트의 GUID.

​
응답 형식

{
  "content": [
    { "folderId": "12345", "name": "Project Discussion", "workspaceGuid": "ws_abc123", "isTeamFolder": true },
    { "folderId": "12346", "name": "Daily Standup", "workspaceGuid": "ws_abc123", "isTeamFolder": false }
  ],
  "total": 2
}
필드 설명:
필드타입설명
content[]array노트가 속한 폴더 목록. 어떤 폴더에도 정리되어 있지 않으면 빈 배열.
content[].folderIdstring안정적인 폴더 식별자.
content[].namestring폴더 이름.
content[].workspaceGuidstring폴더가 속한 워크스페이스의 GUID. 항상 존재(노트 폴더는 항상 워크스페이스에 속함).
content[].isTeamFolderboolean팀(워크스페이스 공유) 폴더면 true, 개인 폴더면 false.
totalnumber반환된 폴더 개수.
폴더 목록은 서버에서 접근 권한 필터링됩니다. 노트의 워크스페이스와 호출자 멤버십을 통해 호출자가 접근 가능한 폴더만 반환됩니다.

​
사용 예시

요청: 
{
  "noteGuid": "note_abc123"
}
응답: 
{
  "content": [
    { "folderId": "200", "name": "Engineering", "workspaceGuid": "ws_abc123", "isTeamFolder": true }
  ],
  "total": 1
}

​
스코프 요구사항

get_note_folders는 mcp:notes:read와 mcp:folders:read 스코프를 둘 다 요구합니다. 접근 가능한 노트를 키로 하지만(notes 스코프) 폴더 메타데이터를 반환하므로(folders 스코프 — search_*_folders 도구가 요구하는 것과 동일), 두 스코프가 모두 필요합니다. 추가로 노트 접근 권한으로도 게이팅됩니다. 노트를 읽을 수 없는 호출자는 그 노트의 폴더도 조회할 수 없습니다. API 키는 모든 스코프를 포함하며, OAuth 토큰은 두 스코프를 모두 부여받아야 합니다. API 키는 Tiro Platform API Keys에서 설정하세요.

​
관련 도구