Visao Geral de Paridade
A Copera expoe os mesmos recursos do workspace por meio de quatro superficies paralelas. Elas compartilham a API subjacente, mas nem todas expoem cada recurso — algumas sao intencionalmente somente leitura ou de escopo mais restrito.
- Public API — a API REST, que pode ser chamada de qualquer linguagem ou plataforma.
- CLI — opere boards, docs, drive e mensagens pelo seu terminal ou CI.
- Servidor MCP — conecte clientes de IA (Claude, Cursor e outros hosts MCP) ao seu workspace.
- IA nativa — um subconjunto somente leitura exposto diretamente a IA dentro do produto Copera (dados de boards + agenda pessoal).
Use esta pagina para decidir qual superficie se encaixa no seu caso de uso e para identificar onde um recurso esta ausente em uma determinada superficie.
Matriz de capacidades
Legenda: ✅ completo · ◑ somente leitura · — nenhum
| Dominio | Public API | CLI | MCP | IA |
|---|---|---|---|---|
| Workspace | ✅ | ✅ | ✅ | — |
| Boards/Linhas (leitura) | ✅ | ✅ | ✅ | ◑ |
| Linhas (criar/atualizar/excluir) | ✅ | ✅ | ✅ | — |
| Markdown de coluna rich-text de linha | ✅ | ✅ | — | — |
| Autenticar linha | ✅ | ✅ | — | — |
| Comentarios de linha + anexos | ✅ | ✅ | ✅ | — |
| Export de tabela (assincrono) | ✅ | ✅ | ✅ | — |
| Docs | ✅ | ✅ | ✅ | — |
| Drive (navegar/baixar/pastas) | ✅ | ✅ | ✅ | — |
| Upload multipart do Drive | ✅ | ✅ | — | — |
| Channels/Mensagens | ✅ | ✅ | ✅ | — |
| Busca | ✅ | ✅ | ✅ | — |
| Notificacoes | ✅ | ✅ | ✅ | — |
| Bookings | ✅ | — | — | ◑ |
Superficie de IA nativa
A IA nativa da Copera expoe um subconjunto somente leitura dos dominios de boards e bookings — o suficiente para consultar e ler dados estruturados, mas nada que altere o workspace. As ferramentas disponiveis sao:
Ferramentas de board:
copera_list_boardscopera_get_boardcopera_list_tablescopera_get_table_schemacopera_list_rowscopera_get_rowcopera_get_row_markdown
Ferramenta de agenda (escopo pessoal):
getMySchedule— le os proximos bookings e eventos do usuario autenticado. Esta e uma visao pessoal; nao expoe dados de bookings do workspace inteiro nem agendas de outros usuarios.
Para qualquer coisa alem de ler boards ou sua propria agenda — escritas, docs, drive, channels, busca, notificacoes ou dados de bookings do workspace inteiro — use a Public API ou o servidor MCP.
Lacunas conhecidas
Alguns recursos estao deliberadamente ausentes em superficies especificas:
- Sem CLI para Bookings — a CLI ainda nao inclui comandos
bookings. Use a Public API ate que o suporte chegue. Consulte o guia de Bookings para o Quick Start via REST. - Sem MCP para Bookings — nenhuma ferramenta MCP de bookings esta disponivel no momento. Use a Public API.
- Sem MCP ou IA para markdown de coluna rich-text de linha — disponivel apenas via Public API e CLI.
- Sem MCP ou IA para autenticar linha — apenas Public API e CLI.
- Sem MCP ou IA para upload multipart do Drive — apenas Public API e CLI.
- Acesso de IA a bookings e apenas de escopo pessoal —
getMySchedulele a agenda proxima do usuario autenticado. Dados de bookings do workspace inteiro nao estao acessiveis pela IA nativa; use a Public API. - A IA e somente leitura e limitada a boards + agenda pessoal — sem escritas e sem outros dominios.
Quando uma superficie nao cobre o que voce precisa, recorra a Public API, que e a superficie completa.
Para onde ir em seguida
- Visao geral da Public API — a superficie REST completa.
- Visao geral da CLI — fluxos no terminal e em CI.
- Visao geral do MCP — conecte clientes de IA ao seu workspace.