Vai al contenuto principale

Panoramica di parità

Copera espone le stesse capacità del workspace attraverso quattro superfici parallele. Condividono l'API sottostante, ma non espongono tutte ogni capacità — alcune sono intenzionalmente read-only o più ristrette.

  • Public API — la REST API, chiamabile da qualsiasi linguaggio o piattaforma.
  • CLI — guida boards, docs, drive e messaging dal terminale o dalla CI.
  • MCP server — collega client IA (Claude, Cursor e altri host MCP) al workspace.
  • AI nativa — un subset read-only esposto direttamente all'AI in-product di Copera (dati di board + schedule personale).

Usa questa pagina per decidere quale superficie si adatta al tuo caso d'uso e per individuare dove manca una capacità su una data superficie.

Matrice delle capacità​

Legenda: ✅ full · ◑ read-only · — none

DomainPublic APICLIMCPAI
Workspace✅✅✅—
Boards/Rows (read)✅✅✅◑
Rows (create/update/delete)✅✅✅—
Row rich-text column markdown✅✅——
Row authenticate✅✅——
Row comments + attachments✅✅✅—
File-column upload/remove✅———
Table export (async)✅✅✅—
Docs✅✅✅—
Drive (browse/download/folders)✅✅✅—
Drive multipart upload✅✅——
Channels/Messaging✅✅✅—
Search✅✅✅—
Notifications✅✅✅—
Bookings✅——◑

Superficie AI nativa​

L'AI nativa di Copera espone un subset read-only dei domini board e bookings — abbastanza per cercare e leggere dati strutturati, ma niente che muti il workspace. I tool disponibili sono:

Tool Board:

  • copera_list_boards
  • copera_get_board
  • copera_list_tables
  • copera_get_table_schema
  • copera_list_rows
  • copera_get_row
  • copera_get_row_markdown

Tool Schedule (scope personale):

  • getMySchedule — legge i booking e il calendario imminenti dell'utente autenticato. È una vista personale; non espone dati di booking a livello workspace né i calendari di altri utenti.

Per qualsiasi cosa oltre alla lettura di board o del proprio schedule — scritture, docs, drive, channels, search, notifications o dati di booking a livello workspace — usa la Public API o l'MCP server.

Gap noti​

Alcune capacità sono deliberatamente assenti su superfici specifiche:

  • Nessuna CLI per Bookings — la CLI non spedisce ancora comandi bookings. Usa la Public API finché non arriva il supporto CLI. Vedi la guida Bookings per il Quick Start REST.
  • Nessun MCP per Bookings — al momento non sono esposti tool MCP di booking. Usa la Public API.
  • Nessun MCP o AI per markdown di colonna rich-text di riga — disponibile solo via Public API e CLI.
  • Nessun MCP o AI per row authenticate — solo Public API e CLI.
  • Nessun MCP o AI per upload multipart di Drive — solo Public API e CLI.
  • L'accesso AI ai bookings è solo a scope personale — getMySchedule legge lo schedule imminente dell'utente autenticato. I dati di booking a livello workspace (tutti gli host, tutti i tipi) non sono accessibili dall'AI nativa; usa invece la Public API.
  • L'AI è altrimenti read-only e limitata a boards + schedule personale — nessuna scrittura e nessun dominio non-board/schedule.

Quando una superficie non copre ciò di cui hai bisogno, torna alla Public API, che è la superficie completa.

Dove andare dopo​