Account and organization 7 Min. vreme čitanja

Korišćenje PaperOffice sa Claude, ChatGPT, Grok i Cursor (MCP): kompletan vodič

Šta konektor radi

MCP (Model Context Protocol) je otvoreni standard putem kojeg AI asistent koristi alate drugog sistema. PaperOffice obezbeđuje udaljeni MCP server za ovo. Nakon povezivanja, asistent kao što je Claude može da radi sa dokumentima u vašim radnim prostorima u PaperOffice: pretražuje, čita, sumira, ekstrahuje podatke, otprema, menja naziv, premesta, traži potpise i pokreće tokove posla, uvek uz vaša ovlašćenja u PaperOffice.

Ne treba ništa instalirati. Asistent se povezuje na URL, ulazite sa svojim nalogom PaperOffice, a alati PaperOffice se pojavljuju unutar ćaskanja.

Podrženi asistenti i URL-ovi konektora

  • Claude (claude.ai, Claude Desktop, Claude Code): https://mcp.paperoffice.ai/claude, ulazak putem OAuth 2.1.
  • ChatGPT: https://mcp.paperoffice.ai/chatgpt, ulazak putem OAuth 2.1.
  • Grok: https://mcp.paperoffice.ai/grok, ulazak putem OAuth 2.1.
  • Cursor: https://mcp.paperoffice.ai/cursor, sa ličnim tokenom korisnika ili grupnim tokenom.

Profilii ukazuju na isti server i razlikuju se samo u obimu alata.

Šta vam je potrebno

  • PaperOffice nalog sa najmanje jednim radnim prostorom.
  • Credits na nalogu. Pozivi alata se naplaćuju kao API pozivi.
  • Plan asistenta koji dozvoljava konektore, na primer Claude Pro, Max, Team ili Enterprise. U planima Team i Enterprise, administrator možda mora prvo da omogući konektor.

Povežite Claude

  1. U claude.ai, otvorite Podešavanja → Connectors.
  2. Izaberite Dodaj prilagođeni konektor, unesite ime PaperOffice i URL https://mcp.paperoffice.ai/claude. Ostavite polja za klijentski ID i tajnu prazna; proces prijave putem OAuth-a počinje automatski.
  3. Izaberite Povežite i ulogujte se sa svojim PaperOffice nalogom. Pregledajte traženi pristup i potvrdite.
  4. U ćaskanju, omogućite alate PaperOffice za razgovor.

Claude Desktop koristi isti spisak konektora kao claude.ai. U Claude Code, dodajte server sa claude mcp add --transport http paperoffice https://mcp.paperoffice.ai/claude i završite ulazak sa /mcp.

Prvi test: pitajte „Koji radni prostori PaperOffice mogu da pristupim?” Claude treba da navede vaše radne prostore.

Povežite ChatGPT i Grok

ChatGPT: Otvorite Podešavanja → Connectors, dodajte prilagođeni konektor sa imenom PaperOffice, URL-om https://mcp.paperoffice.ai/chatgpt i OAuth kao metodom autentifikacije, zatim se povežite i prijavite. U zavisnosti od vašeg plana, za prilagođene konektore može biti potrebno omogućiti režim za developere. Profil ChatGPT je pažljivo odabrana kolekcija alata; on ne sadrži, na primer, alate za potpisivanje ni alate za radne tokove.

Grok: Otvorite grok.com/connectors, kreirajte prilagođeni konektor sa URL-om https://mcp.paperoffice.ai/grok i prijavite se svojim PaperOffice nalogom prilikom prvog povezivanja. Profil Grok je takođe pažljivo odabrana kolekcija alata.

Povežite Cursor sa tokenom

  1. Ulogujte se u aplikaciju PaperOffice i otvorite Račun → API.
  2. Kreirajte token za korisnika ili koristite grupni token od vašeg administratora. Token možete pregledati i kopirati na API stranici u bilo kom trenutku; čuvajte ga na sigurnom mestu.
  3. Dodajte server u mcp.json fajl Cursor sa URL-om https://mcp.paperoffice.ai/cursor i tokenom kao bearer token u zaglavlju Authorization.
  4. Restartujte Cursor ili osvežite MCP servere.

Nikada ne komitujte mcp.json fajl sa pravim tokenom u repozitorijum. Tajni ključevi i javni ključevi REST API-ja su blokirani za MCP.

Dozvole: asistent nikada ne dobija više nego Vi

Asistent radi sa dozvolama prijavljenog korisnika PaperOffice. Članstvo u radnom prostoru, uloge, zajednički folderi, pravila zadržavanja (WORM) i pravna zadržavanja se primenjuju nepromenjeno. Korisnik samo za čitanje u PaperOffice ostaje samo za čitanje i u asistentu.

Svaki alat nosi naslov i ukazuje da li samo čita ili menja nešto. Asistent koristi ove indikatore da vas pita pre nego što deluje. Brisanje, pražnjenje korpe i slanje zahteva za potpisivanje označeni su kao destruktivni, pa očekujte pitanje za potvrdu. Obrisani dokumenti prvo odlaze u PaperOffice korpu i mogu se vratiti u aplikaciji.

Podešavanja naloga, fakturisanje, upravljanje korisnicima i kreiranje API ključeva nisu dostupni kroz konektor. Oni ostaju u PaperOffice aplikaciji.

Protok podataka: šta asistent vidi i šta PaperOffice prima

  1. Vi pišete zahtev u asistentu.
  2. Asistent odlučuje koji će PaperOffice alat pozvati i šalje parametre, na primer pojam za pretragu ili ID dokumenta, na PaperOffice MCP server.
  3. PaperOffice izvršava poziv sa Vašim dozvolama i vraća rezultat, na primer tekst jednog dokumenta ili listu imena fajlova.
  4. Rezultat postaje deo Vašeg razgovora sa asistentom i obrađuje se pod uslovima provajdera asistenta.

PaperOffice ne prima Vašu istoriju ćaskanja, Vaše upite ili odgovore asistenta. Samo sam poziv alata stiže do servera: ime alata, parametri, vreme i korisnik. PaperOffice ne otprema dokumente na provajdera asistenta samostalno; provajder prima samo ono što je asistent tražio.

Svaki poziv alata se beleži sa vremenom, korisnikom i Credits. Administratori vide pozive pod API i programeri → API korišćenje.

Fakturisanje

Svaki poziv alata kroz konektor se fakturiše u Credits, tačno kao odgovarajući API poziv. Ne postoji posebna pretplata za konektor. Neka pitanja statusa i zdravlja se ne naplaćuju; detalji su u API dokumentaciji. Kada Credits potroše, pozivi se odbijaju sa jasnom porukom; ništa se ne briše. Više u vodiču o fakturisanju i Credits: Fakturisanje i Credits u PaperOffice AI.

Opoziv pristupa

  1. U asistentu, uklonite ili odspojite PaperOffice konektor. Asistent odmah prestaje da ga koristi; razgovori koji već sadrže rezultate PaperOffice zadržavaju taj tekst.
  2. U PaperOffice, otvorite Račun → API. Povezivanja asistenta pojavljuju se u listi tokena sa MCP oznakom. Obrišite token tog povezivanja tamo.
  3. Za Cursor, rotirajte ili obrišite token na istoj stranici.

Opoziv pristupa ne briše nikakve podatke.

Rešavanje problema

  • Prozor za prijavu se ne otvara: dozvolite iskačuće prozore za asistent i pokušajte u privatnom prozoru pregledača. U planovima Team ili Enterprise, pitajte administratora da li je konektor omogućen.
  • Povezano, ali se ne pojavljuju PaperOffice alati: omogućite alate za razgovor ili započnite novi razgovor.
  • "Neovlašćeno" tokom poziva alata: veza je opozvana ili istekla. Povežite se ponovo. Sa tokenom, proverite da li je u pitanju korisnički ili grupni token.
  • Asistent ne nalazi dokumente: prvo pitajte za listu radnih prostora. Priključeni korisnik možda nema pristup radnom prostoru koji očekujete. Nedavno otpremljeni dokumenti trebaju trenutak dok obrada ne završi.
  • Nedovoljno Credits: dopunite u PaperOffice aplikaciji ili omogućite automatsko dopunjavanje.

Još uvek zaglavili? Otvorite tiket za podršku sa asistentom i planom, tačnom porukom, vremenom sa vremenskom zonom i, ako je moguće, screenshotom bez ličnih podataka.

Preporuka za IT timove

  • Domeni za dozvolu: mcp.paperoffice.ai, api.paperoffice.ai i app.paperoffice.ai. Sav saobraćaj koristi HTTPS; nije potrebna ulazna veza ka Vašoj mreži.
  • Započnite sa pilotom: jedan radni prostor i uloge samo za čitanje. Omogućite uloge za pisanje po radnom prostoru nakon pilota.
  • Pregledajte korišćenje API-ja redovno tokom prvih nedelja.

Često postavljana pitanja

  • Da li moram ništa da instaliram? Ne. Asistent se povezuje na URL.
  • Da li asistent može da vidi sve moje dokumente? Samo ono što vaš PaperOffice korisnik može da vidi.
  • Da li PaperOffice čita moje razgovore? Ne. Samo pozivi alata stižu do PaperOffice.
  • Da li postoji posebna pretplata za konektor? Ne. Pozivi se naplaćuju u Credits kao API pozivi.
  • Kako da prekinem pristup? Uklonite konektor u asistentu i obrišite token povezivanja pod Nalog → API.