Nodaro ドキュメント
ドキュメントノードリファレンスモデルAI エージェント(MCP)開発者向けセルフホスティングリサーチ
ツールリファレンス

ワークスペース

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

Nodaro Cloud で利用できます

ワークスペースのツールは、Nodaro アカウントが学校やチームなどの組織に所属している場合に、アシスタントの作業をどこに保存するかを選びます。Web アプリでは切り替えメニューでワークスペースを選びますが、MCP クライアントには切り替えメニューがありません。そこで、list_workspaces が「どこで作業できる?」という問いに答え、select_workspace が「そこで作業して」という指示に応えます。組織について詳しくは、ワークスペースを参照してください。

これらのツールは、組織機能が有効になっている Nodaro Cloud のインスタンスにだけ存在します。それ以外の環境にはツール自体がありません。そのため、クライアントは、押しても何も起きない切り替えに出会うことなく、ワークスペースが対象外であることがわかります。組織機能ができる前に承認した接続には、ワークスペースの権限がありません。権限を付与するには、コネクタを削除してから追加し直してください。

list_workspaces

アカウントが所属する組織とワークスペース、そしてセッションが現在作業しているワークスペースを返します。

権限:workspaces:read。クレジット:無料。Nodaro Cloud のみ。

このツールにはパラメーターがありません。

戻り値:

{
  "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_idstring or null必須。list_workspaces で取得したワークスペース ID です。個人スペースにする場合は null です。

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

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

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

よくある質問

最終更新

目次