Gibt es einen PaperOffice-Node für n8n?
Nein. Es gibt keinen eigenen Node, kein fertiges Credential und keine veröffentlichten Vorlagen. Sie arbeiten mit den Standard-Knoten HTTP Request, Webhook und MCP Client gegen die dokumentierte REST-API und den MCP-Server.
Welchen Schlüssel brauche ich?
Sie erzeugen ihn in der App unter Konto → API. Für REST nutzen Sie po_sk_ oder po_ut_, für MCP po_ut_, po_gt_ oder OAuth 2.1; po_sk_ und po_pk_ lehnt der MCP-Server ab. Eine bestätigte E-Mail genügt. Die API gibt es in allen Plänen, auch in Free.
Wie erfährt n8n, dass ein Dokument fertig ist?
Über ein Webhook-Abo, ab Professional. Sie abonnieren document.processed mit der Produktions-URL Ihres Webhook-Knotens. Die Zustellung bringt pofid, workspace_id, Dokumenttyp, key_fields und die extrahierten Felder mit. Für Jobs, die n8n selbst startet, fragen Sie GET /job/get/{job_id} ab.
Welche Ereignisse kann n8n empfangen?
document.processed, document.edited, document.deleted, document.version_created, document.note_added, document.tag_added, document.comment_added, document.lifecycle_changed, document.legal_hold_placed, document.legal_hold_released, document.generated und task.completed. Das Ende eines API-Jobs fragen Sie über job/get ab.
Muss meine n8n-Instanz öffentlich erreichbar sein?
Für Webhooks ja. PaperOffice stellt nur per http oder https an öffentliche Adressen zu und folgt keinen Weiterleitungen. Private Adressen, localhost und Metadaten-Hosts sind gesperrt. Für Aufrufe an REST-API und MCP-Server braucht n8n nur ausgehenden Zugang zu api.paperoffice.ai und mcp.paperoffice.ai.
Kann ich Webhook-Abos in der App anlegen?
Nein. Webhook-Abos legen Sie per API mit POST /webhooks/subscribe oder über das MCP-Werkzeug po_webhooks_subscribe an. Mit POST /webhooks/test schicken Sie ein test.ping an Ihren Webhook-Knoten.
Wie prüfe ich, dass eine Zustellung von PaperOffice kommt?
Jede Zustellung trägt X-PaperOffice-Signature mit sha256= und dem HMAC-SHA256 über den Rohtext. Das secret steht in der Antwort auf das Abo. Zusätzlich können Sie einen eigenen Header mitschicken lassen und im Webhook-Knoten Header Auth einschalten.
Kann ein KI-Agent in n8n PaperOffice nutzen?
Ja, über den MCP-Client mit der Server-URL https://mcp.paperoffice.ai/dms und dem Transport Streamable HTTP oder SSE. Die Anmeldung läuft über OAuth 2.1 oder einen po_ut_- oder po_gt_-Token. Welche Werkzeuge bereitstehen, hängt von Ihrem Plan ab.
Kann n8n Geschäftsdaten an PaperOffice senden?
Ja, ab Plus. Unter Knowledge Base AI legen Sie eine operative Quelle vom Typ Push (Ingest-URL) an. n8n sendet Aufträge, Sendungen, Rechnungen oder Angebote als JSON, höchstens 500 Datensätze je Aufruf und 60 Aufrufe je 10 Minuten und Quelle. Chat- und Telefon-Agenten lesen diese Daten ab Professional, schreiben aber nichts zurück.
Gibt es Grenzen für Aufrufe?
Ja. Je Schlüssel sind in jedem Plan mindestens 5 Aufrufe pro Sekunde, 30 pro Minute, 100 pro Stunde und 500 pro Tag möglich, in bezahlten Plänen mehr. Abfrage-Schleifen zählen mit, planen Sie deshalb Pausen von 5 bis 10 Sekunden ein.
Geht das auch mit Make oder Zapier?
Ja, nach demselben Muster: in Make mit dem HTTP-Modul, in Zapier mit Custom Request gegen die REST-API, für KI-Agenten mit einem MCP-Client gegen https://mcp.paperoffice.ai/dms. Eigene Apps oder Module für Make und Zapier gibt es nicht.
Wo liegen die Daten?
Dokumente, die n8n an PaperOffice sendet, verarbeitet PaperOffice im eigenen EU-Rechenzentrum. Was n8n selbst speichert, liegt dort, wo Ihre n8n-Instanz läuft, ob selbst betrieben oder in n8n Cloud.