Vai al contenuto principale

Copera MCP Cloud

Copera MCP Cloud è un endpoint hostato Model Context Protocol che consente ai client IA — Claude Desktop, Claude Code, Cursor e qualsiasi altro tool compatibile con MCP — di leggere e scrivere direttamente il tuo workspace Copera. Espone le stesse capacità della Copera Public API, confezionate come tool MCP nativi che un agente può scoprire e chiamare.

Punti il client IA a un URL, ti autentichi con un token e il modello ottiene un catalogo di 37 tool che coprono boards, documenti, search, chat, notifiche, drive, commenti ed export.

AI client (Claude / Cursor / …)
  │  MCP over Streamable HTTP, Authorization: Bearer cp_pat_… or cp_oat_…
  ▼
Copera MCP Cloud  (https://mcp.copera.ai/mcp)
  │  each tool call → HTTPS request to the Public API
  ▼
Copera Public API  (https://api.copera.ai/public/v1)

Come si collega alla Public API​

Copera MCP Cloud è un proxy sottile e stateless sopra la Copera Public API. Ogni chiamata a un tool diventa una richiesta HTTP tipizzata a https://api.copera.ai/public/v1/*, inoltrando il tuo token. Il servizio non mantiene stato di sessione e non memorizza dati propri — il token viene validato dalla Public API esattamente come per una chiamata REST diretta.

Ciò significa che Copera MCP Cloud eredita il modello di autorizzazioni, i rate limit e il comportamento della Public API. Se puoi fare qualcosa con un Personal Access Token via REST, puoi farlo tramite MCP — e un client IA lo ottiene come tool che già sa usare.

Stesse capacità, delivery nativa per l'IA

Copera MCP Cloud non aggiunge nuove capacità sopra la Public API — le rispecchia. Scegli MCP quando il consumatore è un client IA; scegli la REST API o la CLI per script e integrazioni.

Parità e gap attuali​

Il catalogo tool MCP segue da vicino la Public API, ma non è una mappatura uno-a-uno di ogni endpoint. Alcune capacità della Public API non hanno un tool MCP oggi:

  • Markdown a livello di colonna di riga tramite un endpoint dedicato oltre alla superficie set_row_markdown / get_row_markdown.
  • Autenticazione di riga (l'endpoint authenticate di table-row).
  • Upload multipart di Drive (start/finalize di upload multi-part con URL pre-firmati) — i tool drive MCP leggono e creano cartelle ma non caricano i byte dei file.
  • Bookings — nessun tool MCP è esposto per la superficie Bookings.

Per la matrice completa delle capacità tra Public API, MCP, CLI e tool Copera AI, vedi la panoramica di parità.

Quali client IA possono usarlo​

Qualsiasi client che parla il transport MCP Streamable HTTP può connettersi, tra cui:

  • Claude Desktop e Claude Code (tramite un remote MCP server / connector)
  • Cursor
  • L'MCP Inspector per test e debug manuali
  • Qualsiasi agente custom costruito su un SDK MCP

Prossimi passi​

Collega un client

URL dell'endpoint, config del client e test con l'MCP Inspector.

Autenticazione

Personal Access Token vs. OAuth, il flusso OAuth e come gli scope si mappano ai tool.

Riferimento tool

Tutti i 37 tool raggruppati per dominio, con la capacità Public API a cui ciascuno si mappa.

Casi d'uso

Workflow concreti di agenti e sequenze di esempio di chiamate ai tool.