# Espaços de trabalho

> Liste as organizações e os espaços de trabalho da sua conta do Nodaro e escolha onde o assistente de IA trabalha, com list_workspaces e select_workspace.

Source: https://nodaro.ai/pt-BR/docs/mcp/tools/workspaces

As **ferramentas de espaço de trabalho** escolhem onde fica o trabalho de um assistente quando a sua conta do Nodaro pertence a uma organização, como uma escola ou uma equipe. No app web, você escolhe o espaço de trabalho num seletor; um cliente MCP não tem seletor, então `list_workspaces` responde “onde posso trabalhar?” e `select_workspace` responde “trabalhe ali”. Leia mais sobre organizações em [Espaços de trabalho](https://nodaro.ai/docs/concepts/workspaces).

As ferramentas só existem nas instâncias do Nodaro Cloud em que as organizações estão ativadas. Em todos os outros lugares, elas não aparecem, então um cliente entende que os espaços de trabalho não se aplicam, em vez de encontrar uma opção que não faz nada. As conexões autorizadas antes de as organizações existirem não têm as permissões de espaço de trabalho; remova o conector e adicione-o de novo para concedê-las.

## `list_workspaces`
Retorna as organizações e os espaços de trabalho de que a sua conta faz parte, e o espaço de trabalho em que a sessão trabalha agora.

**Permissão:** `workspaces:read`. **Créditos:** grátis. **Somente no Nodaro Cloud.**

Esta ferramenta não tem parâmetros.

**Retorna:**

```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"
}
```

Listas vazias significam que a conta não pertence a nenhuma organização. Isso é normal, não é um erro.

## `select_workspace`
Faz a sessão trabalhar num espaço de trabalho e lembra a escolha nas próximas sessões. Passe `null` para voltar ao seu espaço pessoal.

**Permissão:** `workspaces:write`. **Créditos:** grátis. **Somente no Nodaro Cloud.**

| Parâmetro | Tipo | Observações |
| --- | --- | --- |
| `workspace_id` | string or null | **Obrigatório.** Um ID de espaço de trabalho de `list_workspaces`, ou `null` para o seu espaço pessoal. |

**Retorna:** se o espaço de trabalho foi selecionado ou recusado.

- **Quem decide é o servidor.** A ferramenta propõe um espaço de trabalho, e o Nodaro o aceita ou o recusa. Só um espaço de trabalho aceito é lembrado.
- **A escolha é verificada a cada sessão.** A participação pode terminar entre duas sessões. Se você não faz mais parte do espaço de trabalho salvo, o Nodaro apaga a escolha e a sessão continua no seu espaço pessoal.
- **Selecionar não concede nada.** A seleção registra a que lugar pertence o trabalho da sessão. Ela não dá acesso nem move trabalho nenhum, então uma escolha errada custa um passo e não expõe nada.

Os relatórios de uso de uma organização não estão disponíveis pelo MCP. Leia-os com o SDK, a CLI ou a API REST.

## Frequently asked questions

### Por que o meu assistente não tem as ferramentas de espaço de trabalho?

As ferramentas só existem nas instâncias do Nodaro Cloud em que as organizações estão ativadas. Nas outras instâncias, elas não aparecem, e as conexões autorizadas antes de os espaços de trabalho existirem não têm as permissões até você se reconectar.

### O assistente lembra o espaço de trabalho que eu escolhi?

Sim. select_workspace salva a escolha para as próximas sessões, e o Nodaro a verifica de novo no início de cada sessão. Se você saiu do espaço de trabalho, a sessão volta para o seu espaço pessoal.

### Como volto para o meu espaço pessoal?

Peça ao assistente para chamar select_workspace com workspace_id definido como null.