# Paperless-ngx MCP: Ihre KI findet Dokumente, ohne sie zu lesen

Stand: 16. November 2026 · Vorlage 1.0.0 · live erprobt gegen eine Test-Instanz (Paperless-ngx 3.2.1) am 30. September 2026

[Kostenlos starten](/docs/starten)

Drei Identities sind dauerhaft kostenlos, mit allen Funktionen.

**Die kurze Antwort**

Ihre KI kann über einen MCP-Server in Paperless-ngx Dokumente finden, filtern und einordnen: Titel, Korrespondent, Dokumenttyp, Tags und Datum. Den Inhalt eines Dokuments liest sie nicht, und eine Datei bekommt sie nie. Mit JanuaPort liegt Paperless als fertige Vorlage im Katalog, das Token bleibt im Tresor, und ändern kann die KI nichts.

## So ist Paperless angebunden

JanuaPort spricht über die REST-API mit Ihrem Paperless, als eigener Nutzer, der nur anzeigen darf. Sein Token liegt im Tresor Ihrer Anlage. Welche Felder Paperless schickt, steht fest in der Vorlage. Den Volltext, den Paperless sonst mit jedem Dokument mitschickt, fordert sie gar nicht erst an. Jede Liste liefert höchstens 50 Einträge, die KI blättert weiter.

## Was Ihre KI in Paperless tun kann

| Werkzeug | Art | Status |
|---|---|---|
| Dokumente auflisten und filtern: Titelteil, Korrespondent, Typ, Tag, Zeitraum, Archivnummer | liest | live erprobt |
| Dokumente im Volltext suchen, Ergebnis nur als Liste der Dokumente | liest | live erprobt |
| Ein Dokument mit seinen Angaben holen | liest | live erprobt |
| Korrespondenten, Dokumenttypen und Tags nachschlagen | liest | live erprobt |

Je Dokument bekommt die KI: Titel, Korrespondent, Dokumenttyp, Tags, Ausstellungs- und Eingangsdatum, Archivnummer, Seitenzahl und Dateityp.

## Was bewusst nicht geht

- Den Text eines Dokuments lesen, eine Datei, eine Vorschau oder einen Download-Link holen.
- Notizen, eigene Felder, Dateinamen und Speicherpfade sehen.
- Schreiben jeder Art: Der Nutzer darf nur anzeigen. Ändern, Löschen, Hochladen und Tags anlegen weist Paperless ab, live erprobt.
- Paperless 2.x: Die Vorlage ist für Paperless-ngx ab 3.0 gebaut und erprobt.

**Zwei Grenzen, die Sie kennen sollten:**

- **Die Suche verrät, ob ein Wort im Dokument steht.** Die KI bekommt zwar nur die Liste der Treffer, aber ein Treffer zeigt, dass Titel oder Text das Suchwort enthalten. Wer das nicht will, gibt die Suche nicht frei. Die übrigen Werkzeuge laufen weiter.
- **Sichtbar ist, was keinen Besitzer hat.** Paperless zeigt einem Nutzer seine eigenen, die freigegebenen und alle Dokumente ohne Besitzer. Über den Eingangsordner eingelesene Dokumente haben keinen Besitzer. Legen Sie Lohnunterlagen und Ähnliches deshalb einem eigenen Besitzer zu. Was der KI-Nutzer nicht sehen darf, findet sie dann auch nicht.

## Warum über JanuaPort (Stufe 1)

### Rechte je Werkzeug.

Ein Zugang sieht zunächst nichts. Sie geben die Werkzeuge frei, die er braucht, die Volltextsuche auch einzeln.

### Jeder Aufruf steht im Audit.

Wann, wer, welches Werkzeug, mit welchem Ergebnis. Suchbegriffe und Namensfilter stehen ab Werk geschwärzt darin.

### Selbst betrieben, das Token liegt im Tresor.

JanuaPort läuft bei Ihnen. Das Paperless-Token hat kein Ablaufdatum und trägt alle Rechte seines Nutzers. Deshalb gehört es in den Tresor und zu einem Nutzer, der nur anzeigen darf.

Eine Grenze bleibt: Titel stehen im Klartext und tragen oft Namen, etwa bei Gehaltsabrechnungen. Was Ihre KI über JanuaPort abruft, sieht auch ihr KI-Anbieter. Auf Wunsch ersetzt JanuaPort Muster wie IBAN, E-Mail und Telefonnummer in Titeln durch Kürzel. Namen findet kein Muster. Die Vorlage legt das nicht von sich aus fest, Sie entscheiden.

## In vier Schritten verbunden

1. In Paperless einen eigenen Nutzer anlegen, kein Admin, nur mit dem Recht „Anzeigen“ für Dokumente, Korrespondenten, Dokumenttypen und Tags. Besitz und Freigaben so setzen, dass er nur sieht, was die KI sehen darf.
2. Sein API-Token in den Tresor legen und die Vorlage auf die Adresse Ihres Paperless einstellen.
3. Rechte vergeben: die Werkzeuge freigeben, die der Zugang braucht, die Suche nur bewusst.
4. Claude oder ChatGPT verbinden, per SSO oder mit einem eigenen Token je Nutzer oder Ablauf.

## Status

Gebaut und gegen eine Test-Instanz (Paperless-ngx 3.2.1) live erprobt am 30. September 2026.

## Andere MCP-Server für Paperless-ngx

Paperless-ngx bringt seit Version 3.0 eine eigene KI mit, die Titel, Tags und Korrespondenten vorschlägt und Fragen zu Dokumenten beantwortet. Sie arbeitet in Paperless selbst mit dem Dokumenttext. Ein Zugang für Ihre KI-Assistenten von außen ist sie nicht.

Paperless-ngx selbst bietet keinen MCP-Server an, aus der Community gibt es mehrere (Stand 11. November 2026). Verbreitet ist zum Beispiel [baruchiro/paperless-mcp](https://github.com/baruchiro/paperless-mcp) (ISC-Lizenz). Er kann Dokumente auch herunterladen, bearbeiten und in Sammelaktionen ändern oder löschen. Das passt gut, wenn die KI Ihr Archiv auch pflegen soll, etwa Tags setzen oder Dokumente zusammenführen. JanuaPort passt, wenn die KI nur finden und einordnen soll, ohne den Inhalt Ihrer Dokumente zu lesen, und weitere Systeme dazukommen.

## Häufige Fragen

### Gibt es einen MCP-Server für Paperless-ngx?

Ja, mehrere aus der Community, etwa baruchiro/paperless-mcp auf GitHub. Paperless-ngx selbst bietet keinen an. JanuaPort bringt Paperless als fertige Vorlage im Katalog mit: Dokumente finden, filtern und einordnen, nur lesend, ohne Dokumenttext, mit Rechten je Werkzeug und jedem Aufruf im Audit.

### Wie verbinde ich Paperless-ngx sicher mit ChatGPT oder Claude?

Mit einem eigenen Paperless-Nutzer, der nur anzeigen darf, und Besitzrechten, die festlegen, was er sieht. Mit JanuaPort liegt sein Token im Tresor Ihrer eigenen Anlage, Ihre KI meldet sich per SSO oder mit einem Token an, sieht nur die freigegebenen Werkzeuge, und jeder Aufruf steht im Audit.

### Kann eine KI in Paperless etwas ändern?

Nicht über JanuaPort. Die Vorlage hat nur lesende Werkzeuge, und der Nutzer darf in Paperless nur anzeigen. Ändern, Löschen, Hochladen und Tags anlegen weist Paperless ab, das haben wir live erprobt.

### Wie findet eine KI Dokumente in Paperless, ohne den Inhalt zu lesen?

Über feste Felder. JanuaPort liefert je Dokument nur Titel, Korrespondent, Typ, Tags, Datum, Archivnummer, Seitenzahl und Dateityp, nie den Text, die Notizen oder die Datei. Was dem Lese-Nutzer in Paperless nicht gehört und nicht freigegeben ist, findet die KI gar nicht.

## Für Agenturen

Sie richten Paperless für Ihre Kunden ein? Mit JanuaPort liegt das Token beim Kunden, Ihr Ablauf bekommt einen eigenen Zugang mit genau den Rechten, die er braucht, und jeder Aufruf steht im Protokoll.
