노트 폴더 조회

개요

get_note_folders에 노트 GUID를 전달하면 그 노트가 속한 폴더를 반환해요. 폴더 안의 노트를 찾는 list_notes의 filter.folderId와 반대 방향으로 조회해요. 폴더 이름으로 찾으려면 search_private_folders나 search_team_folders를 사용하세요. 노트가 속한 폴더를 찾을 때만 get_note_folders를 사용해요. 사용할 때

노트가 위치한 곳 표시(“이 노트는 Engineering > Q1 Planning 아래에 정리되어 있습니다”).
후속으로 어떤 폴더 검색 도구를 쓸지 판단: 각 결과의 isTeamFolder 플래그로 해당 폴더가 팀(워크스페이스 공유) 폴더인지 개인 폴더인지 알 수 있습니다.

파라미터

파라미터	타입	필수	설명
`noteGuid`	string	필수	폴더 목록을 조회할 노트의 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[].folderId`	string	안정적인 폴더 식별자.
`content[].name`	string	폴더 이름.
`content[].workspaceGuid`	string	폴더가 속한 워크스페이스의 GUID. 항상 존재(노트 폴더는 항상 워크스페이스에 속함).
`content[].isTeamFolder`	boolean	팀(워크스페이스 공유) 폴더면 `true`, 개인 폴더면 `false`.
`total`	number	반환된 폴더 개수.

폴더 목록은 서버에서 접근 권한 필터링됩니다. 노트의 워크스페이스와 호출자 멤버십을 통해 호출자가 접근 가능한 폴더만 반환됩니다.

사용 예시

요청:

{
  "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 Key는 모든 스코프를 포함하며, OAuth 토큰은 두 스코프를 모두 부여받아야 합니다. API Key는 Tiro Platform API Keys에서 설정하세요.

홈

시작하기

API

음성 파일

웹훅

MCP

CLI

개발자 리소스

노트 폴더 조회

개요

파라미터

응답 형식

사용 예시

스코프 요구사항

관련 도구

​개요

​파라미터

​응답 형식

​사용 예시

​스코프 요구사항

​관련 도구

개요

파라미터

응답 형식

사용 예시

스코프 요구사항

관련 도구