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.

Endpunkte unter https://mcp.docurex.com
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:

  1. In docurex anmelden und Einstellungen öffnen.
  2. Den Reiter API-Token wählen.
  3. API-Token erzeugen wählen und mit Ihrem aktuellen Passwort bestätigen (bei aktiver Zwei-Faktor-Anmeldung zusätzlich mit dem Code).
  4. 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:

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.

Stand 17.11.2026. „Belegt“: der Befehl stammt aus der Projektvorgabe. „Mit Anbieterdoku abgeglichen“: Dateiname, Schlüssel und Variablen-Schreibweise stimmen mit der öffentlichen Doku des Anbieters überein. „Nicht verifiziert“: das ist nicht abgeglichen; Dateinamen, Schlüssel und Menüs können abweichen. Getestet haben wir noch keinen Client.
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:

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:

  1. Vorschau zuerst. Der erste Aufruf ändert nichts. Er liefert eine Vorschau und einen Bestätigungs-Token, der fünf Minuten gilt.
  2. 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.
  3. Rückfrage im Client. Unterstützt der Client Rückfragen (Elicitation), muss der Mensch die Ausführung zusätzlich bestätigen.
  4. 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.
  5. Protokoll und Wiederherstellung. Jede Ausführung steht im Betriebsprotokoll (ohne Namen). Das Ergebnis nennt, wie sich das Objekt mit docurex_restore_from_recyclebin zurü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

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.

Limits

Standardwerte; Anfragen je Token, Upload, Download und Ausgabe kann der Betreiber je Umgebung ändern, das Adress-Limit ist fest.
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