KI-Assistenten mit docurex verbinden
Der docurex MCP-Server verbindet KI-Assistenten über das Model Context Protocol (MCP) mit Ihrem Datenraum: lesen, suchen, Fragen stellen, hochladen und – nur auf ausdrücklich gewähltem Endpunkt – in den Papierkorb verschieben. Endgültig löschen kann er nie.
Endpunkte
Jeder Endpunkt ist ein eigener Berechtigungsumfang. Beginnen Sie mit
/mcp/readonly und wechseln Sie nur bei Bedarf.
| Pfad | Was der Assistent darf | Tools |
|---|---|---|
/mcp/readonly |
Nur lesen: Ordner, Dokumente, Suche, Fragen an die docurex-KI, Q&A lesen. Empfohlen für den Einstieg. | 18 |
/mcp |
Lesen und schreiben: zusätzlich anlegen, umbenennen, verschieben, kopieren, hochladen, Metadaten und Tags ändern, Q&A stellen und beantworten. | 32 |
/mcp/full |
Wie /mcp, zusätzlich Ordner und Dokumente in den Papierkorb verschieben
(mit mehrstufigem Schutz).
|
34 |
Die Zahl nennt die Tools, die der Endpunkt in diesem Build anbietet. Alle Tools mit Parametern und Hinweisen stehen in der Tool-Referenz. „Nur lesen“ heißt: keine Änderung an Inhalten des Datenraums; Zusammenfassungen und KI-Fragen können trotzdem KI-Aufträge starten und KI-Kontingent verbrauchen.
Der Server speichert nichts. Er reicht Ihren docurex-API-Token bei jeder Anfrage an die docurex API weiter; der Assistent darf genau das, was Ihr Konto in docurex darf.
Nur https:// verwenden. Der Server weist unverschlüsselte
Anfragen an /mcp* mit 403 ab. Haben Sie Ihren Token versehentlich über
http:// gesendet, erzeugen Sie in docurex einen neuen.
API-Token beschaffen
Den Token erzeugen Sie in docurex selbst:
- In docurex anmelden und Einstellungen öffnen.
- Den Reiter API-Token wählen.
- API-Token erzeugen wählen und mit Ihrem aktuellen Passwort bestätigen (bei aktiver Zwei-Faktor-Anmeldung zusätzlich mit dem Code).
- Den Token sofort kopieren: er wird nur einmal angezeigt.
Ein Konto hat genau einen permanenten Token. Ein neuer Token ersetzt den alten; andere Anwendungen, die den alten Token nutzen, verlieren dann den Zugriff. Administratoren verwalten fremde Tokens in der Benutzerverwaltung.
Der Token gehört in einen dieser beiden Header jeder Anfrage:
Authorization: Bearer DOCUREX_API_TOKENX-API-Key: DOCUREX_API_TOKEN
Beide Header sind gleichwertig; senden Sie nur einen. Ohne gültigen Token antwortet der Server mit 401 und verweist auf diese Seite.
Quickstart je Client
In allen Beispielen steht DOCUREX_API_TOKEN für Ihren Token und
/mcp/readonly für den empfohlenen Einstiegs-Endpunkt. Legen Sie den Token in
einer Umgebungsvariablen ab, statt ihn in Dateien zu schreiben, die ins Repository
gelangen.
| Client | Token per Header | Stand |
|---|---|---|
| Claude Code | ja | Befehl belegt |
| Cursor | ja | Beispiel mit Anbieterdoku abgeglichen |
| VS Code | ja | Beispiel mit Anbieterdoku abgeglichen |
| Gemini CLI | ja | Schlüssel abgeglichen, Variablen-Schreibweise nicht verifiziert |
| Codex CLI | ja | Beispiel mit Anbieterdoku abgeglichen |
| n8n | ja | Menüführung nicht verifiziert |
| Claude Desktop, claude.ai | nur mit Beta „Request-Header“ | Menüführung nicht verifiziert |
| Copilot Studio | ja, per API-Schlüssel | Menüführung nicht verifiziert |
| Mistral, Langdock | ja, benutzerdefinierter Header | Menüführung nicht verifiziert |
| ChatGPT | nein, nur OAuth | nicht unterstützt |
Claude Code
export DOCUREX_API_TOKEN="hier-ihr-token"
claude mcp add --transport http docurex https://mcp.docurex.com/mcp/readonly \
--header "Authorization: Bearer $DOCUREX_API_TOKEN"
Der Befehl legt den Server in Ihrer lokalen Claude-Code-Konfiguration an, der Token steht
dort im Klartext. Für ein gemeinsames Projekt bleibt der Token mit einer
.mcp.json außerhalb der Datei, die Umgebungsvariable wird beim Start
eingesetzt (laut Anbieterdoku; sehr alte Claude-Code-Versionen setzten Variablen in
Headern nicht ein, dann bitte aktualisieren):
{
"mcpServers": {
"docurex": {
"type": "http",
"url": "https://mcp.docurex.com/mcp/readonly",
"headers": { "Authorization": "Bearer ${DOCUREX_API_TOKEN}" }
}
}
}
Cursor
In ~/.cursor/mcp.json oder .cursor/mcp.json:
{
"mcpServers": {
"docurex": {
"url": "https://mcp.docurex.com/mcp/readonly",
"headers": { "Authorization": "Bearer ${env:DOCUREX_API_TOKEN}" }
}
}
}
VS Code
In .vscode/mcp.json. VS Code fragt den Token beim ersten Start ab und
speichert ihn getrennt von der Datei:
{
"inputs": [
{
"type": "promptString",
"id": "docurex-token",
"description": "docurex API-Token",
"password": true
}
],
"servers": {
"docurex": {
"type": "http",
"url": "https://mcp.docurex.com/mcp/readonly",
"headers": { "Authorization": "Bearer ${input:docurex-token}" }
}
}
}
Gemini CLI
In ~/.gemini/settings.json:
{
"mcpServers": {
"docurex": {
"httpUrl": "https://mcp.docurex.com/mcp/readonly",
"headers": { "Authorization": "Bearer $DOCUREX_API_TOKEN" }
}
}
}
Codex CLI
In ~/.codex/config.toml. Codex liest den Token aus der genannten
Umgebungsvariablen:
[mcp_servers.docurex]
url = "https://mcp.docurex.com/mcp/readonly"
bearer_token_env_var = "DOCUREX_API_TOKEN"
n8n, Claude Desktop, Copilot Studio, Mistral, Langdock
Diese Clients richten Sie in der Oberfläche ein. Wir haben die Menüführung noch nicht geprüft und geben deshalb nur die Werte an, die überall gleich sind:
- Server-URL:
https://mcp.docurex.com/mcp/readonly - Transport: Streamable HTTP (kein SSE)
-
Authentifizierung: eigener Header, Name
Authorization, WertBearer DOCUREX_API_TOKEN– alternativ NameX-API-Key, Wert der Token
Nicht verifiziert: In n8n verwenden Sie den Knoten „MCP Client Tool“ mit „Header Auth“. In Copilot Studio wählen Sie für den benutzerdefinierten MCP-Connector die Authentifizierung per API-Schlüssel. In claude.ai (Team und Enterprise) gilt ein Zugang für alle Mitglieder eines Arbeitsbereichs; bedenken Sie das bei der Wahl des Kontos.
Papierkorb-Schutz
Der Server löscht nie endgültig und leert nie den Papierkorb. Auf
/mcp/full kann ein Assistent einzelne Dokumente und Ordner in den Papierkorb
verschieben – in jedem Fall wieder herstellbar. Dafür gelten mehrere Schutzschichten:
- Vorschau zuerst. Der erste Aufruf ändert nichts. Er liefert eine Vorschau und einen Bestätigungs-Token, der fünf Minuten gilt.
- Gebundener Token. Der Bestätigungs-Token gilt nur für dieses Ziel und Ihren API-Token und wird ungültig, sobald sich das Ziel ändert.
- Rückfrage im Client. Unterstützt der Client Rückfragen (Elicitation), muss der Mensch die Ausführung zusätzlich bestätigen.
- Grenzen. Der Wurzelordner wird nie verschoben, Ordner mit mehr als 200 Dokumenten werden abgelehnt, und je API-Token sind höchstens 50 Ausführungen pro Stunde möglich.
-
Protokoll und Wiederherstellung. Jede Ausführung steht im
Betriebsprotokoll (ohne Namen). Das Ergebnis nennt, wie sich das Objekt mit
docurex_restore_from_recyclebinzurückholen lässt.
Der Bestätigungs-Token erzwingt nur einen sichtbaren Zwischenschritt; er belegt nicht,
dass ein Mensch zugestimmt hat. Nutzen Sie /mcp/full nur mit Clients, die
Tool-Aufrufe zur Freigabe anzeigen.
Sicherheit
- Der Token ist ein Passwort. Wer ihn hat, handelt als Ihr Konto. Geben Sie ihn nicht weiter, schreiben Sie ihn nicht in Chats, Tickets oder Repositories.
- Eigenes Konto mit minimalen Rechten. Für Assistenten empfiehlt sich ein eigenes docurex-Konto, das nur die nötigen Ordner sieht. Die Rechte in docurex gelten unverändert; der Server erweitert sie nicht.
- Rotieren. Erzeugen Sie den Token neu, wenn jemand ausscheidet, ein Gerät verloren geht oder der Token an einer falschen Stelle stand.
- Inhalte sind Daten, keine Anweisungen. Dokumente, Chat-Antworten, Zusammenfassungen und Q&A-Texte stammen von Dritten und können Anweisungen enthalten, die den Assistenten täuschen sollen (Prompt Injection). Der Server kennzeichnet solche Inhalte; prüfen Sie Aktionen, die der Assistent nach dem Lesen fremder Inhalte vorschlägt, besonders vor Schreib- und Papierkorb-Aufrufen.
- Nur HTTPS, geprüfte Hosts. Der Server erzwingt HTTPS (mit HSTS) und lehnt fremde Hostnamen und Origins ab.
Datenschutz und Datenfluss
Ihr Client sendet die Anfrage mit dem Token an den docurex MCP-Server, dieser ruft damit die docurex API auf und gibt die Antwort an den Client zurück. Der Client leitet die Inhalte an das Sprachmodell weiter, das Sie dort eingerichtet haben.
- Der Server hat keine Datenbank und speichert weder Dokumente noch Antworten oder Token. Ein Neustart verliert nur flüchtige Zähler (Rate-Limits, Papierkorb-Stundenlimit).
-
Das Betriebsprotokoll enthält je Aufruf Tool, Ergebnis, Dauer und ein Kürzel des Tokens
(12 Zeichen eines Hashwerts) – keine Eingaben, keine Dokumentinhalte, keine Token. Die
Header
AuthorizationundX-API-Keywerden nie protokolliert. - Der Server ruft nur die feste, in der Konfiguration hinterlegte docurex API auf, nie ein Ziel aus einer Anfrage.
- Die Verarbeitung durch das Sprachmodell Ihres Clients unterliegt dessen Anbieter. Prüfen Sie, ob Ihr Auftragsverarbeitungsvertrag mit docurex und der Anbieter Ihres Clients die gewünschten Inhalte abdecken, bevor Sie vertrauliche Datenräume anbinden.
Limits
| Bereich | Grenze | Folge |
|---|---|---|
| Anfragen je Token | 120 pro Minute | HTTP 429 mit Retry-After |
| Anfragen je Adresse | 10 pro Sekunde, Spitze 20 | HTTP 429 |
| Upload | 10 MiB je Datei, in einem Schritt | Fehlermeldung des Tools |
| Download | 5 MiB je Datei | Fehlermeldung des Tools |
| Ausgabe eines Tools | 40 000 Zeichen | Kürzung mit Hinweis (truncated) |
| Listen | höchstens 100 Einträge je Seite | Weitere Seiten abrufen |
| Dauer eines Aufrufs | 120 Sekunden gesamt, 30 Sekunden je docurex-Aufruf, KI-Fragen 90 Sekunden | Fehlermeldung des Tools |
Version und Betrieb
- Laufende Version und Build: /version
- Alle Tools mit Parametern: Tool-Referenz
-
Änderungen je Version stehen im Changelog des Projekts (
CHANGELOG.mdim Repository).