Account and organization 7 Timp minim de citire

Utilizarea PaperOffice cu Claude, ChatGPT, Grok și Cursor (MCP): ghidul complet

Ce face conectorul

MCP (Model Context Protocol) este un standard deschis prin care un asistent AI utilizează instrumentele unui alt sistem. PaperOffice oferă un server MCP la distanță pentru acest scop. Odată conectat, un asistent precum Claude poate lucra cu documentele din spațiile de lucru PaperOffice: căutare, citire, rezumare, extragere date, încărcare, redenumire, mutare, solicitare de semnături și pornire de fluxuri de lucru, întotdeauna cu permisiunile dumneavoastră PaperOffice.

Nu este nevoie să instalați nimic. Asistentul se conectează la o adresă URL, vă autentificați cu contul dumneavoastră PaperOffice, iar instrumentele PaperOffice apar în interiorul chat-ului.

Asistenți compatibili și adrese URL ale conectorilor

  • Claude (claude.ai, Claude Desktop, Claude Code): https://mcp.paperoffice.ai/claude, autentificare cu OAuth 2.1.
  • ChatGPT: https://mcp.paperoffice.ai/chatgpt, autentificare cu OAuth 2.1.
  • Grok: https://mcp.paperoffice.ai/grok, autentificare cu OAuth 2.1.
  • Cursor: https://mcp.paperoffice.ai/cursor, cu un token de utilizator personal sau un token de grup.

Profilurile indică același server și diferă doar prin sfera de instrumente.

Ce aveți nevoie

  • Un cont PaperOffice cu cel puțin un spațiu de lucru.
  • Credits pe cont. Apelurile de instrumente se facturează ca apelurile API.
  • Un plan de asistent care permite conectorii, de exemplu Claude Pro, Max, Team sau Enterprise. În planurile Team și Enterprise, un administrator ar putea trebui să activeze mai întâi conectorul.

Conectați Claude

  1. În claude.ai, deschideți Setări → Connectors.
  2. Alegeți Adăugați conector personalizat, introduceți numele PaperOffice și adresa URL https://mcp.paperoffice.ai/claude. Lăsați ID-ul clientului și secretul goale; autentificarea OAuth începe automat.
  3. Alegeți Conectare și autentificați-vă cu contul dumneavoastră PaperOffice. Revizuiți accesul solicitat și confirmați.
  4. În chat, activați instrumentele PaperOffice pentru conversație.

Claude Desktop utilizează aceeași listă de conectori ca claude.ai. În Claude Code, adăugați serverul cu claude mcp add --transport http paperoffice https://mcp.paperoffice.ai/claude și completați autentificarea cu /mcp.

Un prim test: întrebați „Ce spații de lucru PaperOffice pot accesa?” Claude ar trebui să vă listeze spațiile de lucru.

Conectați ChatGPT și Grok

ChatGPT: deschideți Setări → Connectors, adăugați un conector personalizat cu numele PaperOffice, URL-ul https://mcp.paperoffice.ai/chatgpt și OAuth ca metodă de autentificare, apoi conectați-vă și autentificați-vă. În funcție de planul dumneavoastră, modul dezvoltator ar putea trebui activat pentru conectorii personalizați. Profilul ChatGPT este o selecție curată de instrumente; acesta nu conține, de exemplu, instrumente de semnătură sau fluxuri de lucru.

Grok: deschideți grok.com/connectors, creați un conector personalizat cu URL-ul https://mcp.paperoffice.ai/grok și autentificați-vă cu contul dumneavoastră PaperOffice la prima conectare. Profilul Grok este, de asemenea, o selecție curată de instrumente.

Conectați Cursor cu un token

  1. Autentificați-vă în aplicația PaperOffice și deschideți Cont → API.
  2. Creați un token de utilizator sau utilizați un token de grup din partea administratorului dumneavoastră. Puteți vizualiza și copia tokenul în orice moment pe pagina API; păstrați-l în siguranță.
  3. Adăugați serverul în fișierul mcp.json al Cursor cu adresa URL https://mcp.paperoffice.ai/cursor și tokenul ca bearer token în antetul Authorization.
  4. Reporniți Cursor sau reîncărcați serverele MCP.

Nu comiteți niciodată un fișier mcp.json cu un token real într-un depozit. Cheile secrete și cheile publicabile ale API-ului REST sunt blocate pentru MCP.

Permisiuni: asistentul nu primește niciodată mai multe decât dumneavoastră

Asistentul funcționează cu permisiunile utilizatorului PaperOffice conectat. Apartenența la spațiul de lucru, rolurile, folderele partajate, regulile de retenție (WORM) și blocajele legale se aplică nemodificate. Un utilizator doar în citire din PaperOffice rămâne doar în citire în asistent.

Fiecare instrument are un titlu și indică dacă citește sau modifică ceva. Asistentul utilizează aceste indicii pentru a vă întreba înainte de a acționa. Ștergerea, golirea coșului de gunoi și trimiterea solicitărilor de semnătură sunt marcate ca distructive, așa că așteptați-vă la o întrebare de confirmare. Documentele șterse merg mai întâi în coșul de gunoi PaperOffice și pot fi restaurate în aplicație.

Setările contului, facturarea, gestionarea utilizatorilor și crearea cheilor API nu sunt disponibile prin conector. Ele rămân în aplicația PaperOffice.

Fluxul de date: ce vede asistentul și ce primește PaperOffice

  1. Scrieți o solicitare în asistent.
  2. Asistentul decide care unealtă PaperOffice să apeleze și trimite parametrii, de exemplu un termen de căutare sau un ID de document, către serverul MCP PaperOffice.
  3. PaperOffice execută apelul cu permisiunile dumneavoastră și returnează rezultatul, de exemplu textul unui document sau o listă de nume de fișiere.
  4. Rezultatul devine parte a conversației dumneavoastră cu asistentul și este gestionat în conformitate cu termenii furnizorului asistentului.

PaperOffice nu primește istoricul chat-ului, prompturile sau răspunsurile asistentului. Doar apelul unealtei ajunge la server: numele unealtei, parametrii, ora și utilizatorul. PaperOffice nu încarcă documente în furnizorul asistentului pe cont propriu; furnizorul primește doar ceea ce a solicitat asistentul.

Fiecare apel de unealtă este înregistrat cu ora, utilizatorul și Credits. Administratorii văd apelurile sub API și dezvoltatori → Utilizare API.

Facturare

Fiecare apel de unealtă prin conector este facturat în Credits, exact ca și apelul API corespunzător. Nu există un abonament separat pentru conector. Unele interogări de stare și sănătate nu sunt taxate; detaliile se găsesc în documentația API. Când Credits se epuizează, apelurile sunt respinse cu un mesaj clar; nimic nu este șters. Mai multe în ghidul privind facturarea și Credits: Facturare și Credits în PaperOffice AI.

Revocarea accesului

  1. În asistent, eliminați sau deconectați conectorul PaperOffice. Asistentul încetează să îl utilizeze imediat; conversațiile care conțin deja rezultate PaperOffice păstrează acel text.
  2. În PaperOffice, deschideți Cont → API. Conexiunile asistentului apar în lista de tokenuri cu o insignă MCP. Ștergeți tokenul acelei conexiuni de acolo.
  3. Pentru Cursor, rotiți sau ștergeți tokenul pe aceeași pagină.

Revocarea accesului nu șterge niciun date.

Depanare

  • Fereastra de conectare nu se deschide: permiteți pop-up-urile pentru asistent și încercați o fereastră privată a browserului. În planurile Team sau Enterprise, întrebați administratorul dacă conectorul este activat.
  • Conectat, dar nu apar unealte PaperOffice: activați instrumentele pentru conversație sau începeți o conversație nouă.
  • „Neautorizat” în timpul unui apel de unealtă: conexiunea a fost revocată sau a expirat. Conectați-vă din nou. Cu un token, verificați că este un token de utilizator sau grup.
  • Asistentul nu găsește documente: întrebați mai întâi pentru lista spațiilor de lucru. Utilizatorul conectat poate să nu aibă acces la spațiul de lucru pe care îl așteptați. Documentele încărcate recent au nevoie de puțin timp până când procesarea este finalizată.
  • Nu sunt suficiente Credits: reîncărcați în aplicația PaperOffice sau activați reîncărcarea automată.

Încă blocați? Deschideți un tichet de suport cu asistentul și planul, mesajul exact, ora cu fusul orar și, dacă este posibil, o captură de ecran fără date personale.

Recomandare pentru echipele IT

  • Domenii de permis: mcp.paperoffice.ai, api.paperoffice.ai și app.paperoffice.ai. Tot traficul folosește HTTPS; nu este necesară nicio conexiune entrantă către rețeaua dumneavoastră.
  • Începeți cu un pilot: un spațiu de lucru și roluri doar în citire. Activați rolurile de scriere per spațiu de lucru după pilot.
  • Revizuiți utilizarea API-ului regulat în primele săptămâni.

Întrebări frecvente

  • Trebuie să instalați ceva? Nu. Asistentul se conectează la o adresă URL.
  • Poate asistentul să vadă toate documentele mele? Doar ceea ce utilizatorul dumneavoastră PaperOffice poate vedea.
  • Citește PaperOffice conversațiile mele? Nu. Doar apelurile de instrumente ajung la PaperOffice.
  • Există un abonament separat pentru conector? Nu. Apelurile sunt facturate în Credits ca apeluri API.
  • Cum închei accesul? Eliminați conectorul din asistent și ștergeți tokenul conexiunii sub Cont → API.