# 워크스페이스

> list_workspaces와 select_workspace로 내 Nodaro 계정이 속한 조직과 워크스페이스를 나열하고, AI 어시스턴트의 작업이 저장될 곳을 고르세요.

Source: https://nodaro.ai/ko/docs/mcp/tools/workspaces

**워크스페이스 도구**는 내 Nodaro 계정이 학교나 팀 같은 조직에 속해 있을 때, 어시스턴트의 작업이 저장될 곳을 고릅니다. 웹 앱에서는 워크스페이스 전환 메뉴에서 워크스페이스를 고르지만, MCP 클라이언트에는 전환 메뉴가 없습니다. 그래서 `list_workspaces`가 “어디에서 작업할 수 있나요?”에 답하고, `select_workspace`가 “그곳에서 작업하세요”에 답합니다. 조직에 대해서는 [워크스페이스](https://nodaro.ai/docs/concepts/workspaces)에서 자세히 알아보세요.

이 도구는 조직이 켜져 있는 Nodaro Cloud 인스턴스에만 있습니다. 그 밖의 모든 곳에서는 도구가 없으므로, 클라이언트는 아무 일도 하지 않는 스위치를 찾는 대신 워크스페이스가 적용되지 않는다는 것을 알게 됩니다. 조직이 생기기 전에 승인한 연결에는 워크스페이스 권한이 없습니다. 커넥터를 제거하고 다시 추가해 권한을 허용하세요.

## `list_workspaces`
내 계정이 속한 조직과 워크스페이스, 그리고 지금 세션이 작업 중인 워크스페이스를 반환합니다.

**권한:** `workspaces:read`. **크레딧:** 무료. **Nodaro Cloud 전용.**

이 도구에는 매개변수가 없습니다.

**반환값:**

```json
{
"workspaces": [
{ "id": "uuid", "orgId": "uuid", "name": "Class 1", "slug": "class-1", "role": "member", "memberStatus": "active", "archived": false }
],
"organizations": [
{ "id": "uuid", "slug": "kent-high", "name": "Kent High", "kind": "school", "status": "active", "role": "owner" }
],
"selectedWorkspaceId": "uuid"
}
```

목록이 비어 있으면 계정이 어느 조직에도 속하지 않는다는 뜻입니다. 이는 오류가 아니라 정상입니다.

## `select_workspace`
세션이 워크스페이스에서 작업하게 하고, 다음 세션을 위해 그 선택을 기억합니다. 개인 공간으로 돌아가려면 `null`을 보내세요.

**권한:** `workspaces:write`. **크레딧:** 무료. **Nodaro Cloud 전용.**

| 매개변수 | 타입 | 설명 |
| --- | --- | --- |
| `workspace_id` | string 또는 null | **필수.** `list_workspaces`에서 받은 워크스페이스 ID, 또는 개인 공간을 뜻하는 `null`입니다. |

**반환값:** 워크스페이스가 선택되었는지 거부되었는지입니다.

- **서버가 결정합니다.** 도구는 워크스페이스를 제안하고, Nodaro가 이를 수락하거나 거부합니다. 수락된 워크스페이스만 기억됩니다.
- **선택은 세션마다 확인됩니다.** 두 세션 사이에 멤버십이 끝날 수 있습니다. 저장된 워크스페이스에 내가 더 이상 속하지 않으면, Nodaro는 선택을 지우고 세션은 개인 공간에서 계속됩니다.
- **선택해도 권한이 생기지 않습니다.** 선택은 세션의 작업이 어디에 속하는지만 기록합니다. 액세스 권한을 주지 않고 작업을 옮기지도 않으므로, 잘못 골라도 한 단계를 더 거칠 뿐 아무것도 노출되지 않습니다.

조직의 사용량 보고서는 MCP로 볼 수 없습니다. SDK, CLI 또는 REST API로 확인하세요.

## 자주 묻는 질문

### 내 어시스턴트에 워크스페이스 도구가 없는 이유는 무엇인가요?

이 도구는 조직이 켜져 있는 Nodaro Cloud 인스턴스에만 있습니다. 다른 인스턴스에는 이 도구가 없으며, 워크스페이스가 생기기 전에 승인한 연결은 다시 연결할 때까지 필요한 권한이 없습니다.

### 어시스턴트가 내가 고른 워크스페이스를 기억하나요?

네. select_workspace는 다음 세션을 위해 선택을 저장하며, Nodaro는 세션이 시작될 때마다 그 선택을 다시 확인합니다. 내가 그 워크스페이스에서 나갔다면 세션은 개인 공간으로 돌아갑니다.

### 개인 공간으로 돌아가려면 어떻게 하나요?

workspace_id를 null로 설정해 select_workspace를 호출해 달라고 어시스턴트에게 요청하세요.