Zum Hauptinhalt springen

DocuWare MCP-Server

Facets bilden in CLYE die semantische Verbindung zwischen Wissen, MCP-Tools und Prozesslogik. Wie dieses gemeinsame Architekturprinzip funktioniert, zeigt der Architekturvergleich von Facets, MCP-Tools und Tasks/Events. Der DocuWare MCP-Server verbindet Assistenten im CLYE AI mit DocuWare Cloud und DocuWare 7.11+. Er ist als gehosteter Dienst von CLYE verfügbar, OAuth-geschützt und nutzt die DocuWare Platform API. Du brauchst keinen lokalen MCP-Prozess.

Passwort, Single Sign-on und Mehrfaktor-Authentifizierung werden ausschließlich durch DocuWare verarbeitet. Der MCP-Server sieht das Passwort nicht.

Der Server​

Der Server läuft öffentlich unter:

https://docuware.mcp.clye.ai/mcp

Technische Details, OAuth-Metadaten und der Live-Status stehen auf docuware.mcp.clye.ai.

Voraussetzungen​

Bevor du den Server im CLYE AI anbindest, braucht ihr einmalig eine App-Registrierung in DocuWare. Dafür sind typischerweise folgende Angaben nötig:

  • DocuWare-URL der Organisation
  • Organization ID
  • Application (Client) ID und Client Secret
  • falls nicht automatisch erkennbar: Identity-Service- bzw. Issuer-URL

Die Registrierung legt ein DocuWare-Administrator unter DocuWare Configuration → Integrations → App Registration an.

App in DocuWare registrieren​

  1. Öffne DocuWare Configuration → Integrations → App Registration.

  2. Lege eine Web Application an.

  3. Trage als Redirect URL exakt ein:

    https://docuware.mcp.clye.ai/oauth/docuware/callback

  4. Erlaube folgende delegierte Scopes:

    docuware.platform dwprofile openid offline_access

  5. Notiere dir Client ID, Client Secret und die übrigen Verbindungsdaten für den Anmelde-Wizard.

Im CLYE AI verbinden​

  1. Öffne Einstellungen und wechsle zum Bereich MCP-Server.
  2. Klicke auf Manuell hinzufügen.
  3. Trage folgende Werte ein:
    • Server-ID: docuware
    • Typ: Streaming HTTP
    • URL: https://docuware.mcp.clye.ai/mcp
  4. Klicke auf Speichern.
  5. Wenn Anmeldung erforderlich angezeigt wird, klicke auf Anmelden.
  6. Gib im Browser-Wizard die App-Daten ein und melde dich anschließend normal bei DocuWare an.

Der OAuth-Ablauf übergibt den Resource-Indikator für die DocuWare-API jetzt bereits bei der Authorize-Anfrage und erneut beim Token-Austausch. Wenn deine DocuWare-Umgebung den Zugriff an eine konkrete geschützte Ressource bindet, funktioniert die Anmeldung damit zuverlässiger, ohne dass du zusätzliche Werte manuell eintragen musst.

Der Server erscheint danach in deiner Liste der installierten MCP-Server und steht in Assistenten zur Verfügung, die diesen MCP-Server nutzen dürfen.

Authentifizierungsablauf​

Der Ablauf ist für Nutzer:innen einfach, im Hintergrund aber bewusst sicher aufgebaut:

  1. Der MCP-Client startet die OAuth-Verbindung.
  2. Der MCP-Server konfiguriert das Deployment für deine DocuWare-Instanz.
  3. DocuWare übernimmt Anmeldung, SSO oder MFA.
  4. Der MCP-Server verschlüsselt die erhaltenen Tokens clientseitig als JWE.
  5. Der Client kann danach die DocuWare-MCP-Werkzeuge nutzen.

Verfügbare MCP-Werkzeuge​

Welche Daten und Aktionen verfügbar sind, richtet sich nach DocuWare-Version, Lizenz und den Berechtigungen des angemeldeten Benutzers.

WerkzeugZugriffBeschreibung
docuware_connection_infoNur lesenPlatform-Version, Servicebeschreibung und verfügbare API-Relations abrufen
docuware_list_file_cabinetsNur lesenSichtbare Archive und Briefkörbe der verbundenen Organisation ermitteln
docuware_getNur lesenEine relative Platform-API-URL oder eine von DocuWare zurückgegebene Relation sicher lesen
docuware_requestSchreibzugriffJSON-basierte POST-, PUT-, PATCH- und DELETE-Aktionen über eine DocuWare-Relation ausführen

Aktueller Stand: JSON-Funktionen der Platform API sind erreichbar. Spezialisierte binäre Upload- und Download-Werkzeuge für Dokumentdateien werden separat ergänzt.

Typische Einsatzfälle​

  • Archive finden: „Welche Ablagen und Briefkörbe habe ich in DocuWare?" – der Assistent listet sichtbare File Cabinets auf.
  • Metadaten lesen: Dokumente, Felder oder Relations über die Platform API auslesen, ohne die Oberfläche zu wechseln.
  • Prozesse anstoßen: JSON-Aktionen über docuware_request ausführen, wenn Berechtigungen und Relations das erlauben.
  • Onboarding: Neue Teammitglieder können DocuWare-Strukturen im Chat erkunden, statt zuerst alle Menüs manuell zu durchsuchen.

Sicherheit in Kurzform​

  • Der Server speichert keine Dokumente oder Suchergebnisse dauerhaft.
  • Es gibt keine persistenten Benutzerkonten auf dem MCP-Server.
  • Access Tokens sind kurzlebig; Refresh Tokens liegen verschlüsselt beim Client.
  • Ohne serverseitige Datenbank gibt es keine sofortige lokale Token-Sperrliste. Ein Wechsel des Verschlüsselungsschlüssels trennt bestehende Verbindungen.

Verwandte Seiten​

Inhalt