노트 폴더 조회

개요

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

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

파라미터

파라미터	타입	필수	설명
`noteGuid`	string	조건부	폴더 목록을 조회할 노트의 GUID.
`url`	string	조건부	`noteGuid` 대신 쓰는 티로 노트 주소. 공유 링크(`https://tiro.ooo/s/{shareId}`) 또는 노트 웹 주소(`/n/{noteId}`)를 받아요. `noteGuid`와 `url` 중 정확히 하나만 보내세요.

응답 형식

{
  "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:note:read와 mcp:folder:read 둘 다 요구합니다 — 노트를 기준으로 폴더 메타데이터(id, 이름, workspaceGuid, 팀/개인 여부)를 반환하기 때문에 search_*_folders 도구와 같은 mcp:folder:read가 필요하고, 조회가 특정 노트에 묶여 있어 mcp:note:read도 함께 필요해요. 두 scope 중 하나라도 없으면 호출이 거부됩니다. API Key는 Tiro Platform API Keys에서 설정하세요.

홈

시작하기

API

음성 파일

웹훅

MCP

CLI

개발자 리소스

노트 폴더 조회

개요

파라미터

응답 형식

사용 예시

스코프 요구사항

관련 도구

​개요

​파라미터

​응답 형식

​사용 예시

​스코프 요구사항

​관련 도구

개요

파라미터

응답 형식

사용 예시

스코프 요구사항

관련 도구