> ## 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.

# list_workspaces

> API Key가 접근할 수 있는 워크스페이스 목록과 각 워크스페이스의 GUID를 조회해요. 다른 도구에 전달할 workspaceGuid를 여기서 확인해요.

## 개요

`list_workspaces`는 API Key가 접근할 수 있는 워크스페이스 목록을 반환해요. 각 워크스페이스의 `guid`를 노트, 폴더, 위키 도구의 `workspaceGuid`로 전달해요. 파라미터와 scope는 필요하지 않아요.

***

## 응답 형식

```json theme={"system"}
{
  "workspaces": [
    { "guid": "1a2b3c4d5e6f7", "name": "Acme", "isWikiEnabled": true },
    { "guid": "7f6e5d4c3b2a1", "name": "Personal", "isWikiEnabled": false }
  ]
}
```

| Field | Type | Description |
| - | - | - |
| `workspaces[].guid` | string | 워크스페이스 GUID. 다른 도구의 `workspaceGuid`에 그대로 전달해요 |
| `workspaces[].name` | string | 워크스페이스 이름 |
| `workspaces[].isWikiEnabled` | boolean | 요금제가 위키를 지원하고 관리자가 위키를 켠 워크스페이스면 `true`. 위키 도구에는 `true`인 워크스페이스의 `guid`를 전달해요 |

사용자 범위 key와 OAuth 토큰은 사용자가 속한 모든 워크스페이스를, 워크스페이스 범위 key는 연결된 워크스페이스 하나를, 조직 key는 조직의 워크스페이스를 반환해요.

***

## `workspaceGuid`를 받는 도구는 무엇인가요?

`list_workspaces`에서 얻은 `guid`는 아래 도구의 `workspaceGuid`로 전달해요.

* [`list_notes`](/ko/developers/mcp/tools/list-notes), [`search_notes`](/ko/developers/mcp/tools/search-notes): 선택. 검색 범위를 한 워크스페이스로 좁혀요
* [`search_private_folders`, `search_team_folders`](/ko/developers/mcp/tools/folder-search): 필수
* [`search_wiki`, `get_wiki_page`, `list_wiki_mentions`, `get_wiki_graph`](/ko/developers/mcp/tools/wiki): 필수

### 예시: 워크스페이스의 노트 검색하기

```json theme={"system"}
{
  "keyword": "분기 계획",
  "workspaceGuid": "1a2b3c4d5e6f7"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.