Account and organization 7 min di lettura

Utilizzo di PaperOffice con Claude, ChatGPT, Grok e Cursor (MCP): la guida completa

Cosa fa il connettore

MCP (Model Context Protocol) è uno standard aperto attraverso il quale un assistente AI utilizza gli strumenti di un altro sistema. PaperOffice fornisce un server MCP remoto per questo scopo. Una volta connesso, un assistente come Claude può lavorare con i documenti negli spazi di lavoro di PaperOffice: cercare, leggere, riassumere, estrarre dati, caricare, rinominare, spostare, richiedere firme e avviare flussi di lavoro, sempre con le autorizzazioni di PaperOffice.

Non è necessario installare nulla. L'assistente si connette a un URL, ci si accede con il proprio account PaperOffice e gli strumenti di PaperOffice appaiono all'interno della chat.

Assistenti supportati e URL del connettore

  • Claude (claude.ai, Claude Desktop, Claude Code): https://mcp.paperoffice.ai/claude, accesso con OAuth 2.1.
  • ChatGPT: https://mcp.paperoffice.ai/chatgpt, accesso con OAuth 2.1.
  • Grok: https://mcp.paperoffice.ai/grok, accesso con OAuth 2.1.
  • Cursor: https://mcp.paperoffice.ai/cursor, con un token utente personale o un token di gruppo.

I profili puntano allo stesso server e differiscono solo per l'ambito degli strumenti.

Cosa serve

  • Un account PaperOffice con almeno uno spazio di lavoro.
  • Credits sull'account. Le chiamate agli strumenti vengono fatturate come chiamate API.
  • Un piano per l'assistente che consenta i connettori, ad esempio Claude Pro, Max, Team o Enterprise. Nei piani Team e Enterprise, un amministratore potrebbe dover abilitare il connettore prima.

Connettere Claude

  1. In claude.ai, aprire Impostazioni → Connectors.
  2. Scegliere Aggiungi connettore personalizzato, inserire il nome PaperOffice e l'URL https://mcp.paperoffice.ai/claude. Lasciare vuoti client ID e secret; l'accesso OAuth inizia automaticamente.
  3. Scegliere Connetti e accedere con il proprio account PaperOffice. Rivedere l'accesso richiesto e confermare.
  4. Nella chat, abilitare gli strumenti PaperOffice per la conversazione.

Claude Desktop utilizza lo stesso elenco di connettori di claude.ai. In Claude Code, aggiungere il server con claude mcp add --transport http paperoffice https://mcp.paperoffice.ai/claude e completare l'accesso con /mcp.

Un primo test: chiedere "Quali spazi di lavoro PaperOffice posso accedere?" Claude dovrebbe elencare i propri spazi di lavoro.

Connettere ChatGPT e Grok

ChatGPT: aprire Impostazioni → Connectors, aggiungere un connettore personalizzato con il nome PaperOffice, l'URL https://mcp.paperoffice.ai/chatgpt e OAuth come metodo di autenticazione, quindi connettersi ed effettuare l'accesso. A seconda del piano sottoscritto, potrebbe essere necessario abilitare la modalità sviluppatore per i connettori personalizzati. Il profilo ChatGPT è una selezione curata di strumenti; ad esempio, non include funzionalità di firma o di workflow.

Grok: aprire grok.com/connectors, creare un connettore personalizzato con l'URL https://mcp.paperoffice.ai/grok ed effettuare l'accesso con il proprio account PaperOffice al primo collegamento. Il profilo Grok è anch'esso una selezione curata di strumenti.

Connettere Cursor con un token

  1. Accedere all'app PaperOffice e aprire Conto → API.
  2. Creare un token utente o utilizzare un token di gruppo fornito dall'amministratore. È possibile visualizzare e copiare il token in qualsiasi momento dalla pagina API; si prega di conservarlo con cura.
  3. Aggiungere il server al file mcp.json di Cursor con l'URL https://mcp.paperoffice.ai/cursor e il token come bearer token nell'intestazione Authorization.
  4. Riavviare Cursor o ricaricare i server MCP.

Non committare mai un file mcp.json con un token reale in un repository. Le chiavi segrete e le chiavi pubblicabili dell'API REST sono bloccate per MCP.

Autorizzazioni: l'assistente non ottiene mai più di quanto possiede l'utente

L'assistente opera con le autorizzazioni dell'utente PaperOffice effettuato all'accesso. L'appartenenza a uno spazio di lavoro, i ruoli, le cartelle condivise, le regole di conservazione (WORM) e i blocchi legali si applicano invariati. Un utente in sola lettura in PaperOffice rimane in sola lettura nell'assistente.

Ogni strumento è dotato di un titolo e indica se la sua funzione è solo di lettura o anche di modifica. L'assistente utilizza questi indicatori per chiedere conferma prima di agire. Le azioni di eliminazione, svuotamento del cestino e invio di richieste di firma sono contrassegnate come distruttive, pertanto ci si aspetta una domanda di conferma. I documenti eliminati vengono spostati inizialmente nel cestino PaperOffice e possono essere ripristinati nell'app.

Le impostazioni dell'account, la fatturazione, la gestione degli utenti e la creazione di chiavi API non sono disponibili tramite il connettore. Rimangono nell'app PaperOffice.

Flusso dei dati: ciò che l'assistente vede e ciò che PaperOffice riceve

  1. Si scrive una richiesta nell'assistente.
  2. L'assistente decide quale strumento PaperOffice chiamare e invia i parametri, ad esempio un termine di ricerca o un ID documento, al server MCP PaperOffice.
  3. PaperOffice esegue la chiamata con le Sue autorizzazioni e restituisce il risultato, ad esempio il testo di un documento o un elenco di nomi di file.
  4. Il risultato diventa parte della Sua conversazione con l'assistente ed è gestito secondo i termini del fornitore dell'assistente.

PaperOffice non riceve la cronologia delle chat, i prompt o le risposte dell'assistente. Raggiunge il server solo la chiamata allo strumento stesso: nome dello strumento, parametri, orario e utente. PaperOffice non carica documenti sul fornitore dell'assistente autonomamente; il fornitore riceve solo ciò che l'assistente ha richiesto.

Ogni chiamata allo strumento viene registrata con orario, utente e Credits. Gli amministratori vedono le chiamate sotto API & Sviluppatore → Utilizzo API.

Fatturazione

Ogni chiamata allo strumento tramite il connettore viene fatturata in Credits, esattamente come la corrispondente chiamata API. Non esiste un abbonamento separato per il connettore. Alcune query di stato e di integrità non sono addebitate; i dettagli si trovano nella documentazione dell'API. Quando i crediti Credits si esauriscono, le chiamate vengono rifiutate con un messaggio chiaro; nulla viene eliminato. Maggiori informazioni nella guida sulla fatturazione e sui crediti Credits: Fatturazione e crediti Credits in PaperOffice AI.

Revoca dell'accesso

  1. Nell'assistente, rimuovere o disconnettere il connettore PaperOffice. L'assistente smette di utilizzarlo immediatamente; le conversazioni che contengono già risultati di PaperOffice mantengono quel testo.
  2. In PaperOffice, aprire Conto → API. Le connessioni dell'assistente appaiono nell'elenco dei token con un badge MCP. Eliminare il token di tale connessione da questa sezione.
  3. Per Cursor, ruotare o eliminare il token nella stessa pagina.

La revoca dell'accesso non elimina alcun dato.

Risoluzione dei problemi

  • La finestra di accesso non si apre: consentire i popup per l'assistente e provare una finestra di navigazione in incognito. Nei piani Team o Enterprise, chiedere all'amministratore se il connettore è abilitato.
  • Connesso, ma non appaiono strumenti PaperOffice: abilitare gli strumenti per la conversazione o avviare una nuova conversazione.
  • "Non autorizzato" durante una chiamata allo strumento: la connessione è stata revocata o è scaduta. Riconnettersi. Con un token, verificare che sia un token utente o di gruppo.
  • L'assistente non trova documenti: chiedere prima l'elenco degli spazi di lavoro. L'utente connesso potrebbe non avere accesso allo spazio di lavoro previsto. I documenti caricati di recente richiedono un momento affinché l'elaborazione sia completata.
  • Crediti Credits insufficienti: ricaricare nell'app PaperOffice o abilitare il rifornimento automatico.

Ancora bloccati? Aprire un ticket di supporto con l'assistente e il piano, il messaggio esatto, l'orario con fuso orario e, se possibile, uno screenshot senza dati personali.

Raccomandazione per i team IT

  • Domini da consentire: mcp.paperoffice.ai, api.paperoffice.ai e app.paperoffice.ai. Tutto il traffico utilizza HTTPS; non è richiesta alcuna connessione in entrata alla propria rete.
  • Iniziare con un progetto pilota: uno spazio di lavoro e ruoli in sola lettura. Abilitare i ruoli di scrittura per spazio di lavoro dopo il progetto pilota.
  • Rivedere l'utilizzo dell'API regolarmente durante le prime settimane.

Domande frequenti

  • È necessario installare qualcosa? No. L'assistente si connette a un URL.
  • L'assistente può vedere tutti i miei documenti? Solo ciò che l'utente PaperOffice può vedere.
  • PaperOffice legge le mie chat? No. Solo le chiamate agli strumenti raggiungono PaperOffice.
  • È previsto un abbonamento separato per il connettore? No. Le chiamate vengono fatturate in Credits come le chiamate API.
  • Come terminare l'accesso? Rimuovere il connettore nell'assistente ed eliminare il token della connessione sotto Account → API.