> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tiro.ooo/llms.txt
> Use this file to discover all available pages before exploring further.

# 노트 폴더 조회

> 노트가 속한 폴더 목록을 노트 GUID로 역방향 조회

## 개요

`get_note_folders`는 **역방향 조회** 도구입니다. 노트 GUID를 주면 그 노트가 속한 폴더 목록을 반환합니다. "이 노트는 어느 폴더에 들어 있나?"라는 질문에 답할 때 사용하며, 폴더 안의 노트를 나열하는 `list_notes`의 `filter.folderId`와 정반대 방향입니다.

폴더 검색 도구와는 용도가 다릅니다. 폴더 이름으로 폴더 트리를 탐색·검색하려면 `search_private_folders` / `search_team_folders`를, 이미 노트를 가지고 있고 그 노트의 폴더 소속을 알고 싶으면 `get_note_folders`를 사용하세요.

**주요 사용 사례:**

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

## 파라미터

| 파라미터       | 타입     | 필수 | 설명                   |
| ---------- | ------ | -- | -------------------- |
| `noteGuid` | string | 필수 | 폴더 목록을 조회할 노트의 GUID. |

## 응답 형식

```json theme={"system"}
{
  "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  | 반환된 폴더 개수.                                        |

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

## 사용 예시

**요청:**

```json theme={"system"}
{
  "noteGuid": "note_abc123"
}
```

**응답:**

```json theme={"system"}
{
  "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](https://platform.tiro.ooo/dashboard/api-keys)에서 설정하세요.

## 관련 도구

* **[`list_notes`](./list-notes)** — 정방향: `filter.folderId`로 폴더 안의 노트를 나열.
* **[`get_note`](./get-note)** — 노트 자체의 메타데이터와 콘텐츠 조회.
* **[`search_private_folders` / `search_team_folders`](./folder-search)** — 노트가 없을 때 폴더 이름으로 폴더 트리 검색.