Was der Connector leistet
MCP (Model Context Protocol) ist ein offener Standard, über den ein KI-Assistent die Tools eines anderen Systems nutzt. PaperOffice stellt dafür einen Remote-MCP-Server bereit. Sobald eine Verbindung besteht, kann ein Assistent wie Claude mit den Dokumenten in Ihren PaperOffice-Workspaces arbeiten: suchen, lesen, zusammenfassen, Daten extrahieren, hochladen, umbenennen, verschieben, Unterschriften anfordern und Workflows starten – stets mit Ihren PaperOffice-Berechtigungen.
Es ist nichts zu installieren. Der Assistent verbindet sich mit einer URL, Sie melden sich mit Ihrem PaperOffice-Konto an, und die PaperOffice-Tools erscheinen im Chat.
Unterstützte Assistenten und Connector-URLs
- Claude (claude.ai, Claude Desktop, Claude Code):
https://mcp.paperoffice.ai/claude, Anmeldung mit OAuth 2.1. - ChatGPT:
https://mcp.paperoffice.ai/chatgpt, Anmeldung mit OAuth 2.1. - Grok:
https://mcp.paperoffice.ai/grok, Anmeldung mit OAuth 2.1. - Cursor:
https://mcp.paperoffice.ai/cursor, mit einem persönlichen Benutzer-Token oder einem Gruppen-Token.
Die Profile verweisen auf denselben Server und unterscheiden sich nur im Umfang der Tools.
Was Sie benötigen
- Ein PaperOffice-Konto mit mindestens einem Workspace.
- Credits auf dem Konto. Tool-Aufrufe werden wie API-Aufrufe abgerechnet.
- Ein Assistenten-Plan, der Connectors erlaubt, z. B. Claude Pro, Max, Team oder Enterprise. Bei Team- und Enterprise-Plänen muss ein Administrator den Connector möglicherweise zunächst aktivieren.
Claude verbinden
- Öffnen Sie in claude.ai Einstellungen → Connectors.
- Wählen Sie Benutzerdefinierten Connector hinzufügen, geben Sie den Namen PaperOffice und die URL
https://mcp.paperoffice.ai/claudeein. Lassen Sie Client-ID und Secret leer; die OAuth-Anmeldung startet automatisch. - Wählen Sie Verbinden und melden Sie sich mit Ihrem PaperOffice-Konto an. Überprüfen Sie die angeforderten Zugriffsrechte und bestätigen Sie diese.
- Aktivieren Sie im Chat die PaperOffice-Tools für das Gespräch.
Claude Desktop verwendet dieselbe Connector-Liste wie claude.ai. Fügen Sie in Claude Code den Server mit claude mcp add --transport http paperoffice https://mcp.paperoffice.ai/claude hinzu und schließen Sie die Anmeldung mit /mcp ab.
Ein erster Test: Fragen Sie „Auf welche PaperOffice-Workspaces kann ich zugreifen?“ Claude sollte Ihre Workspaces auflisten.
ChatGPT und Grok verbinden
ChatGPT: Öffnen Sie Einstellungen → Connectors, fügen Sie einen benutzerdefinierten Connector mit dem Namen PaperOffice, der URL https://mcp.paperoffice.ai/chatgpt und OAuth als Authentifizierung hinzu, verbinden Sie sich dann und melden Sie sich an. Je nach Plan muss möglicherweise der Entwicklermodus für benutzerdefinierte Connectors aktiviert sein. Das ChatGPT-Profil ist eine kuratierte Auswahl an Werkzeugen; es enthält zum Beispiel keine Signatur- und keine Workflow-Werkzeuge.
Grok: Öffnen Sie grok.com/connectors, erstellen Sie einen benutzerdefinierten Connector mit der URL https://mcp.paperoffice.ai/grok und melden Sie sich beim ersten Verbinden mit Ihrem PaperOffice-Konto an. Auch das Grok-Profil ist eine kuratierte Auswahl an Werkzeugen.
Cursor mit einem Token verbinden
- Melden Sie sich in der PaperOffice-App an und öffnen Sie Konto → API.
- Erstellen Sie ein Benutzer-Token oder verwenden Sie ein Gruppen-Token von Ihrem Administrator. Das Token können Sie auf der API-Seite jederzeit ansehen und kopieren; bewahren Sie es sicher auf.
- Fügen Sie den Server in die mcp.json-Datei von Cursor mit der URL
https://mcp.paperoffice.ai/cursorund dem Token als Bearer-Token im Authorization-Header hinzu. - Starten Sie Cursor neu oder laden Sie die MCP-Server neu.
Legen Sie eine mcp.json-Datei mit echtem Token niemals in einem Repository ab. Geheime Schlüssel und veröffentlichbare Schlüssel der REST-API sind für MCP gesperrt.
Berechtigungen: Der Assistent erhält nie mehr Rechte als Sie
Der Assistent arbeitet mit den Berechtigungen des angemeldeten PaperOffice-Benutzers. Workspace-Mitgliedschaft, Rollen, freigegebene Ordner, Aufbewahrungsregeln (WORM) und Legal Holds gelten unverändert. Ein Nur-Lese-Benutzer in PaperOffice bleibt im Assistenten ein Nur-Lese-Benutzer.
Jedes Tool trägt einen Titel und gibt Hinweise darauf, ob es nur liest oder etwas ändert. Der Assistent nutzt diese Hinweise, um Sie vor einer Aktion zu fragen. Das Löschen, das Leeren des Papierkorbs und das Senden von Unterschriftanfragen sind als zerstörerisch markiert; erwarten Sie daher eine Bestätigungsfrage. Gelöschte Dokumente gehen zunächst in den PaperOffice-Papierkorb und können in der App wiederhergestellt werden.
Kontoeinstellungen, Abrechnung, Benutzerverwaltung und die Erstellung von API-Schlüsseln sind über den Connector nicht verfügbar. Sie verbleiben in der PaperOffice-App.
Datenfluss: Was der Assistent sieht und was PaperOffice empfängt
- Sie schreiben eine Anfrage in den Assistenten.
- Der Assistent entscheidet, welches PaperOffice-Tool aufgerufen werden soll, und sendet die Parameter, beispielsweise einen Suchbegriff oder eine Dokument-ID, an den PaperOffice MCP-Server.
- PaperOffice führt den Aufruf mit Ihren Berechtigungen aus und gibt das Ergebnis zurück, beispielsweise den Text eines Dokuments oder eine Liste von Dateinamen.
- Das Ergebnis wird Teil Ihrer Konversation mit dem Assistenten und unterliegt den Bedingungen des Assistentenanbieters.
PaperOffice empfängt weder Ihren Chatverlauf, Ihre Prompts noch die Antworten des Assistenten. Nur der Tool-Aufruf selbst erreicht den Server: Tool-Name, Parameter, Zeitpunkt und Benutzer. PaperOffice lädt keine Dokumente eigenständig an den Assistentenanbieter hoch; der Anbieter erhält nur das, was der Assistent angefragt hat.
Jeder Tool-Aufruf wird mit Zeit, Nutzer und Credits protokolliert. Administratoren sehen die Aufrufe unter API & Entwickler → API-Nutzung.
Abrechnung
Jeder Tool-Aufruf über den Connector wird in Credits abgerechnet, genau wie der entsprechende API-Aufruf. Es gibt kein separates Connector-Abonnement. Einige Status- und Health-Abfragen werden nicht berechnet; Details finden Sie in der API-Dokumentation. Wenn Credits aufgebraucht sind, werden Aufrufe mit einer klaren Meldung abgelehnt; es wird nichts gelöscht. Mehr im Leitfaden zur Abrechnung und zu Credits: Abrechnung und Credits in PaperOffice AI.
Zugriff widerrufen
- Entfernen oder trennen Sie im Assistenten den PaperOffice-Connector. Der Assistent verwendet ihn sofort nicht mehr; Konversationen, die bereits PaperOffice-Ergebnisse enthalten, behalten diesen Text.
- Öffnen Sie in PaperOffice Konto → API. Verbindungen von Assistenten stehen dort in der Token-Liste mit dem Kennzeichen MCP. Löschen Sie dort das Token dieser Verbindung.
- Für Cursor rotieren oder löschen Sie das Token auf derselben Seite.
Das Widerrufen des Zugriffs löscht keine Daten.
Fehlerbehebung
- Das Anmeldefenster öffnet sich nicht: Erlauben Sie Pop-ups für den Assistenten und versuchen Sie ein privates Browserfenster. Bei Team- oder Enterprise-Plänen fragen Sie den Administrator, ob der Connector aktiviert ist.
- Verbunden, aber keine PaperOffice-Tools erscheinen: Aktivieren Sie die Tools für die Konversation oder starten Sie eine neue Konversation.
- „Unauthorized“ während eines Tool-Aufrufs: Die Verbindung wurde widerrufen oder ist abgelaufen. Stellen Sie die Verbindung erneut her. Prüfen Sie bei einem Token, ob es sich um ein Benutzer- oder Gruppentoken handelt.
- Der Assistent findet keine Dokumente: Fragen Sie zuerst nach der Workspace-Liste. Der verbundene Benutzer hat möglicherweise keinen Zugriff auf den erwarteten Workspace. Kürzlich hochgeladene Dokumente benötigen einen Moment, bis die Verarbeitung abgeschlossen ist.
- Nicht genug Credits: Laden Sie in der PaperOffice-App auf oder aktivieren Sie die automatische Aufladung.
Kommen Sie nicht weiter? Öffnen Sie ein Support-Ticket mit dem Assistenten und Plan, die genaue Meldung, den Zeitpunkt mit Zeitzone und, falls möglich, einen Screenshot ohne persönliche Daten.
Empfehlung für IT-Teams
- Freizugebende Domains: mcp.paperoffice.ai, api.paperoffice.ai und app.paperoffice.ai. Der gesamte Verkehr nutzt HTTPS; keine eingehende Verbindung zu Ihrem Netzwerk ist erforderlich.
- Beginnen Sie mit einem Piloten: ein Workspace und Nur-Lese-Rollen. Aktivieren Sie Schreibrollen pro Workspace nach dem Piloten.
- Überprüfen Sie die API-Nutzung regelmäßig in den ersten Wochen.
Häufig gestellte Fragen
- Muss ich etwas installieren? Nein. Der Assistent verbindet sich mit einer URL.
- Kann der Assistent alle meine Dokumente sehen? Nur das, was Ihr PaperOffice-Benutzer sehen darf.
- Liest PaperOffice meine Chats? Nein. Nur die Tool-Aufrufe erreichen PaperOffice.
- Gibt es ein separates Abonnement für den Connector? Nein. Die Aufrufe werden in Credits wie API-Aufrufe abgerechnet.
- Wie beende ich den Zugriff? Entfernen Sie den Connector im Assistenten und löschen Sie das Token der Verbindung unter Konto → API.