# ワークスペース

> list_workspaces と select_workspace で、Nodaro アカウントが所属する組織とワークスペースを一覧表示し、AI アシスタントの作業の保存先を選びます。

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

**ワークスペースのツール**は、Nodaro アカウントが学校やチームなどの組織に所属している場合に、アシスタントの作業をどこに保存するかを選びます。Web アプリでは切り替えメニューでワークスペースを選びますが、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 or null | **必須**。`list_workspaces` で取得したワークスペース ID です。個人スペースにする場合は `null` です。 |

**戻り値**：ワークスペースが選択されたか、拒否されたかです。

- **決めるのはサーバーです**。ツールはワークスペースを提案し、Nodaro がそれを受け入れるか拒否します。記憶されるのは、受け入れられたワークスペースだけです。
- **選択はセッションごとに確認されます**。メンバーシップは、セッションとセッションの間に終わることがあります。保存されたワークスペースにあなたがもう所属していない場合、Nodaro は選択を解除し、セッションは個人スペースで続きます。
- **選択しても、何の権限も与えられません**。選択は、セッションの作業の所属先を記録するだけです。アクセス権を与えることも、作品を移動することもありません。そのため、選択を間違えても、やり直しの手間が 1 回かかるだけで、何かが公開されることはありません。

組織の使用状況レポートは、MCP からは取得できません。SDK、CLI、または REST API で確認してください。

## Frequently asked questions

### アシスタントにワークスペースのツールがないのはなぜですか？

ワークスペースのツールは、組織機能が有効になっている Nodaro Cloud のインスタンスにだけ存在します。ほかのインスタンスにはありません。また、ワークスペース機能ができる前に承認した接続には、再接続するまで必要な権限がありません。

### 選んだワークスペースを、アシスタントは覚えていますか？

はい。select_workspace は選択を次回以降のセッションのために保存し、Nodaro はセッションが始まるたびにその選択を確認し直します。そのワークスペースから退出していた場合、セッションは個人スペースに戻ります。

### 個人スペースに戻るにはどうすればよいですか？

workspace_id を null にして select_workspace を呼び出すよう、アシスタントに依頼してください。