Pular para o conteúdo principal

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

DominioPublic APICLIMCPIA
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_boards
  • copera_get_board
  • copera_list_tables
  • copera_get_table_schema
  • copera_list_rows
  • copera_get_row
  • copera_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 pessoalgetMySchedule le 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