Gebruik van PaperOffice met Claude, ChatGPT, Grok en Cursor (MCP): de complete gids

Wat de connector doet

MCP (Model Context Protocol) is een open standaard waarbij een AI-assistent de tools van een ander systeem gebruikt. PaperOffice biedt hiervoor een externe MCP-server. Eenmaal verbonden kan een assistent zoals Claude werken met de documenten in uw PaperOffice werkruimten: zoeken, lezen, samenvatten, data extraheren, uploaden, hernoemen, verplaatsen, handtekeningen aanvragen en workflows starten, altijd binnen uw PaperOffice rechten.

Er hoeft niets te worden geïnstalleerd. De assistent verbindt met een URL, u logt in met uw PaperOffice account en de PaperOffice tools verschijnen in de chat.

Ondersteunde assistenten en connector-URL's

• Claude (claude.ai, Claude Desktop, Claude Code): https://mcp.paperoffice.ai/claude, inloggen met OAuth 2.1.
• ChatGPT: https://mcp.paperoffice.ai/chatgpt, inloggen met OAuth 2.1.
• Grok: https://mcp.paperoffice.ai/grok, inloggen met OAuth 2.1.
• Cursor: https://mcp.paperoffice.ai/cursor, met een persoonlijke gebruikers-token of een groeps-token.

De profielen verwijzen naar dezelfde server en verschillen alleen in het bereik van de tools.

Wat u nodig heeft

• Een PaperOffice account met ten minste één werkruimte.
• Credits op het account. Tool-aanroepen worden gefactureerd zoals API-aanroepen.
• Een assistent-abonnement dat connectors toestaat, bijvoorbeeld Claude Pro, Max, Team of Enterprise. Bij Team- en Enterprise abonnementen kan een beheerder de connector eerst moeten inschakelen.

Verbind Claude

1. Open in claude.ai Instellingen → Connectors.
2. Kies Aangepaste connector toevoegen, voer de naam PaperOffice en de URL https://mcp.paperoffice.ai/claude in. Laat client-ID en geheim leeg; het OAuth-inlogproces start automatisch.
3. Kies Verbinden en log in met uw PaperOffice account. Controleer de gevraagde toegang en bevestig.
4. Schakel in de chat de PaperOffice tools in voor het gesprek.

Claude Desktop gebruikt dezelfde connectorlijst als claude.ai. Voeg in Claude Code de server toe met claude mcp add --transport http paperoffice https://mcp.paperoffice.ai/claude en voltooi het inlogproces met /mcp.

Eerste test: vraag "Welke PaperOffice werkruimten kan ik benaderen?" Claude moet uw werkruimten vermelden.

Verbind ChatGPT en Grok

ChatGPT: open Instellingen → Connectors, voeg een aangepaste connector toe met de naam PaperOffice, de URL https://mcp.paperoffice.ai/chatgpt en OAuth als authenticatie, verbind vervolgens en meld u aan. Afhankelijk van uw abonnement moet mogelijk de ontwikkelaarsmodus worden ingeschakeld voor aangepaste connectors. Het ChatGPT profiel is een samengestelde selectie van tools; deze bevat bijvoorbeeld geen handtekening- of workflowtools.

Grok: open grok.com/connectors, maak een aangepaste connector aan met de URL https://mcp.paperoffice.ai/grok en meld u aan bij de eerste verbinding met uw PaperOffice account. Het Grok profiel is eveneens een samengestelde selectie van tools.

Verbind Cursor met een token

1. Log in op de PaperOffice app en open Account → API.
2. Maak een gebruikers-token aan of gebruik een groeps-token van uw beheerder. U kunt het token op elk moment bekijken en kopiëren op de API-pagina; bewaar het veilig.
3. Voeg de server toe aan het mcp.json-bestand van Cursor met de URL https://mcp.paperoffice.ai/cursor en het token als een bearer-token in de Authorization-header.
4. Herstart Cursor of laad de MCP-servers opnieuw.

Commit nooit een mcp.json-bestand met een echt token naar een repository. Geheime sleutels en openbare sleutels van de REST API zijn geblokkeerd voor MCP.

Machtigingen: de assistent krijgt nooit meer dan u

De assistent werkt met de machtigingen van de ingelogde PaperOffice-gebruiker. Werkruimte-lidmaatschap, rollen, gedeelde mappen, retentiebeleid (WORM) en juridische holds blijven ongewijzigd van toepassing. Een alleen-lezen gebruiker in PaperOffice blijft alleen-lezen in de assistent.

Elke tool heeft een titel en geeft aan of deze alleen leest of iets wijzigt. De assistent gebruikt deze hints om u te vragen voordat hij handelt. Het verwijderen, legen van de prullenbak en het verzenden van handtekeningverzoeken worden gemarkeerd als destructief, dus verwacht een bevestigingsvraag. Verwijderde documenten gaan eerst naar de PaperOffice prullenbak en kunnen in de app worden hersteld.

Accountinstellingen, facturering, gebruikersbeheer en het aanmaken van API-sleutels zijn niet beschikbaar via de connector. Deze blijven in de PaperOffice-app.

Gegevensstroom: wat de assistent ziet en wat PaperOffice ontvangt

1. U schrijft een verzoek in de assistent.
2. De assistent beslist welke PaperOffice-tool moet worden aangeroepen en verzendt de parameters, bijvoorbeeld een zoekterm of een document-ID, naar de PaperOffice MCP-server.
3. PaperOffice voert de aanroep uit met uw machtigingen en retourneert het resultaat, bijvoorbeeld de tekst van één document of een lijst met bestandsnamen.
4. Het resultaat wordt onderdeel van uw gesprek met de assistent en wordt behandeld onder de voorwaarden van de assistent-provider.

PaperOffice ontvangt uw chatgeschiedenis, uw prompts of de antwoorden van de assistent niet. Alleen de toolaanroep zelf bereikt de server: toolnaam, parameters, tijd en gebruiker. PaperOffice uploadt geen documenten naar de assistent-provider; de provider ontvangt alleen wat de assistent heeft opgevraagd.

Elke toolaanroep wordt geregistreerd met tijd, gebruiker en Credits. Beheerders zien de aanroepen onder API & Ontwikkelaars → API-gebruik.

Facturering

Elke toolaanroep via de connector wordt gefactureerd in Credits, precies zoals de overeenkomstige API-aanroep. Er is geen apart connectorabonnement. Sommige status- en gezondheidsqueries worden niet in rekening gebracht; details staan in de API-documentatie. Wanneer Credits opraken, worden aanroepen afgewezen met een duidelijke boodschap; er wordt niets verwijderd. Meer informatie in de handleiding over facturering en Credits: Facturering en Credits in PaperOffice AI.

Toegang intrekken

1. Verwijder of koppel de PaperOffice-connector los in de assistent. De assistent stopt onmiddellijk met het gebruik ervan; gesprekken die al PaperOffice-resultaten bevatten, behouden die tekst.
2. In PaperOffice opent u Account → API. Assistentverbindingen verschijnen in de tokenlijst met een MCP-badge. Verwijder daar het token van die verbinding.
3. Voor Cursor draait of verwijdert u het token op dezelfde pagina.

Het intrekken van toegang verwijdert geen gegevens.

Probleemoplossing

• Het inlogvenster opent niet: sta pop-ups toe voor de assistent en probeer een privébrowservenster. Bij Team- of Enterprise-abonnementen vraagt u de beheerder of de connector is ingeschakeld.
• Verbonden, maar geen PaperOffice-tools verschijnen: schakel de tools in voor het gesprek, of start een nieuw gesprek.
• “Unauthorized” tijdens een toolaanroep: de verbinding is ingetrokken of verlopen. Koppel opnieuw. Controleer bij een token of het een gebruikers- of groeps-token is.
• De assistent vindt geen documenten: vraag eerst naar de lijst met werkruimten. De verbonden gebruiker heeft mogelijk geen toegang tot de werkruimte die u verwacht. Onlangs geüploade documenten hebben een moment nodig totdat de verwerking is voltooid.
• Niet genoeg Credits: laad op in de PaperOffice-app of schakel automatische aanvulling in.

Nog steeds vastgelopen? Open een supportticket met de assistent en het abonnement, de exacte boodschap, de tijd met tijdzone en, indien mogelijk, een screenshot zonder persoonlijke gegevens.

Aanbeveling voor IT-teams

• Domeinen om toe te staan: mcp.paperoffice.ai, api.paperoffice.ai en app.paperoffice.ai. Al het verkeer gebruikt HTTPS; er is geen inkomende verbinding naar uw netwerk vereist.
• Begin met een pilot: één werkruimte en alleen-lezen rollen. Schrijfrollen per werkruimte inschakelen na de pilot.
• Bekijk het API-gebruik regelmatig tijdens de eerste weken.

Veelgestelde vragen

• Moet ik iets installeren? Nee. De assistent maakt verbinding met een URL.
• Kan de assistent al mijn documenten zien? Alleen wat uw PaperOffice-gebruiker mag zien.
• Leest PaperOffice mijn chats? Nee. Alleen de toolaanroepen bereiken PaperOffice.
• Is er een apart abonnement voor de connector? Nee. Aanroepen worden in rekening gebracht in Credits zoals API-aanroepen.
• Hoe beëindig ik de toegang? Verwijder de connector in de assistent en verwijder het token van de verbinding onder Account → API.