beplus-mcp 0.24.0 → 0.26.0

package/README.md

@@ -112,6 +112,23 @@ Reinicie o cliente. Rode a tool **`whoami`** para confirmar o vínculo.
 | `get_balance` | Saldo de diamantes. |
 | `whoami` | Conta vinculada (link check do PAT). |
 
+### Canvas online (boards colaborativos)
+Falam com `/api/v1/canvas`. **Não geram mídia nem gastam diamantes**: montam o fluxo; quem roda os nós é a pessoa, no Canvas. Funcionam com PAT e com o `beplus-mcp login`: ler boards pede `ialab:read`; criar, editar e compartilhar pede `ialab:spend`.
+
+| Tool | O que faz |
+|------|-----------|
+| `canvas_list_boards` | Boards de que você é membro (id, título, papel, seq). |
+| `canvas_read_board` | Resumo compacto: nós (tipo, nome, campos principais), ligações, vínculo com o IA Lab. Sem mídia. `node_ids` traz o `data` inteiro de alguns nós. **Obrigatório antes de editar.** |
+| `canvas_create_board` | Cria board vazio ou `template: "narration"` (Contexto, Narração, Roteiro e Locução ligados). |
+| `canvas_add_node` | Adiciona nó de um tipo do catálogo, com `label`, `data` e ligações de entrada/saída no mesmo passo. |
+| `canvas_update_node` | Grava chaves do `data` (null apaga), renomeia (`label`) e move. |
+| `canvas_connect` | Liga saída → entrada. |
+| `canvas_delete` | Apaga nós (com ligações e variações) e/ou ligações. |
+| `canvas_rename_board` | Troca o título (`board.set`). |
+| `canvas_list_members` · `canvas_set_member` · `canvas_remove_member` | Membros e papéis (`editor`/`viewer`) por userId. |
+
+Concorrência: cada edição relê o board, vai num envelope só (um `seq`) e é recusada, sem aplicar nada, se outra pessoa mexeu nos mesmos nós desde a sua leitura. Recusas do servidor (`node-missing` e afins) voltam em português com "releia".
+
 Toda geração mostra `Custo: N 💎 · Saldo: M 💎`. As tools de calls e listagem respeitam a visibilidade da equipe — só retornam o que a sua conta pode ver.
 
 ## Desenvolvimento