Werkzeuge: CMIS und FIT-Connect
GovBridge-Werkzeuge für Behörden: cmis_* für die Aktenrecherche im DMS, fit_* für die OZG-Zustellung per FIT-Connect, mit Parametern und Ergebnissen.
GovBridge gibt dem Modell eine feste Liste von Werkzeugen: cmis_* für das DMS, fit_*
für FIT-Connect. Welche ein Endpunkt anbietet, hängt vom provisionierten Protokoll ab.
Andere Operationen sind nicht möglich, auch kein roher CMIS-SQL-Durchgriff (Least
Privilege).
CMIS: Akten und Dokumente
Lese-Werkzeuge (immer verfügbar)
| Werkzeug | Zweck | Pflicht-Parameter |
|---|---|---|
cmis_akte_suchen | Ordner/Akten (cmis:folder) per Namensmuster suchen | query |
cmis_dokument_suchen | Dokumente (cmis:document) per Name und/oder Volltext suchen | – (query und/oder fulltext) |
cmis_metadaten_lesen | Eigenschaften eines Objekts lesen | objectId |
cmis_dokument_holen | Inhalt eines Dokuments holen (mit Größen-Policy) | objectId |
Optionaler Parameter limit bei den Suchen: Trefferzahl, Default 25, Maximum 100.
Schreib-Werkzeuge (nur mit Freigabe)
Nur mit allow_writes = true stehen sie in tools/list und werden ausgeführt. Sonst
endet auch ein direkter Aufruf mit einem Tool-Fehler. Über die Marketplace-Vorlage
eingebunden, fragt SovrGPT zusätzlich vor jedem Aufruf im Chat nach einer Freigabe
(confirm_writes): jede Aktion einzeln, mit den angezeigten Angaben, eine Stunde gültig
(Freigaben im Chat).
| Werkzeug | Zweck | Pflicht-Parameter |
|---|---|---|
cmis_dokument_ablegen | Neues Dokument in einem Ordner anlegen (createDocument) | folderId, name, dazu text oder contentBase64 |
cmis_dokument_verschieben | Objekt zwischen Ordnern verschieben (moveObject) | objectId, sourceFolderId, targetFolderId |
Ergebnisformate
- Suchen liefern Name, Basistyp,
objectIdund gegebenenfalls Größe; mit derobjectIdarbeitet das Modell weiter. cmis_metadaten_lesengibt die Objekt-Eigenschaften als formatiertes JSON zurück.cmis_dokument_holenwendet die Größen-Policy an: Text bis 32 KB inline als Ressource, Allowlist-Binärtypen (PDF, DOC/X, XLS/X, PNG, JPEG) bis 5 MB als base64-Blob, alles Größere oder nicht Gelistete nur als Referenz (cmis://<objectId>) mit Metadaten, ohne Bytes.
FIT-Connect: Anträge zustellen
Ein auf fit-connect provisionierter Endpunkt bietet das fit_*-Set. Es bildet den
Sender-Ablauf der FIT-Connect Submission API v2 der FITKO ab: Anträge gehen
Ende-zu-Ende-verschlüsselt an einen Zustellpunkt (Destination). backend_base_url zeigt
auf die Submission-API-Instanz, das Dienstkonto (OAuth2 Client Credentials oder Basic)
authentisiert den Adapter. Das Modell füllt nur die fachlichen Felder und löst nie rohe
API-Aufrufe aus.
Lese-Werkzeug (immer verfügbar)
| Werkzeug | Zweck | Pflicht-Parameter |
|---|---|---|
fit_zustellpunkt_pruefen | Status eines Zustellpunkts, unterstützte Metadaten-Versionen und ob ein Verschlüsselungs-Key hinterlegt ist | destinationId |
Schreib-Werkzeug (nur mit Freigabe und Bestätigung)
fit_antrag_senden gibt es nur mit allow_writes = true. Über die Marketplace-Vorlage
eingebunden, fragt SovrGPT vor jedem Einreichen im Chat nach einer Freigabe
(confirm_writes), denn ein eingereichter Antrag lässt sich nicht zurückholen. Die Karte
zeigt alle Angaben des Antrags; eingereicht wird genau einmal und genau mit diesen
Angaben, solange die Freigabe gilt (eine Stunde). Text im Chat ist keine Freigabe
(Freigaben im Chat).
| Werkzeug | Zweck | Pflicht-Parameter |
|---|---|---|
fit_antrag_senden | Antrag E2E-verschlüsselt einreichen (announce → Anhänge → finalize) | destinationId, serviceName, serviceIdentifier, dazu data oder dataBase64 |
Weitere optionale Parameter: dataMimeType (Default application/json),
submissionSchemaUri (FIM-/Fachschema-URI) und attachments (max. 10 Anhänge,
je max. 5 MB, als filename + contentBase64 + mimeType).
Ablauf von fit_antrag_senden
- Destination prüfen und den öffentlichen Verschlüsselungs-Key (JWK) abrufen.
announce: die Einreichung mit den angekündigten Anhang-IDs anmelden.- Anhänge hochladen: jeden Anhang einzeln als Compact-JWE verschlüsselt.
finalize: verschlüsseltemetadata.json(mit SHA-512-Hashes) und verschlüsselte Antragsdaten übermitteln. Rückgabe sind diesubmissionIdund der Status.
Details zur verpflichtenden Verschlüsselung: Sicherheit & Datenschutz.
CMIS-1.1-Browser-Binding
Zum Backend spricht GovBridge das CMIS-1.1-Browser-Binding, die JSON-über-HTTP-Variante des OASIS-Standards CMIS:
- Suche über
cmisselector=querymit einer CMIS-SQL-SELECT-Anweisung. Sie entsteht ausschließlich aus escapten String-Literalen; Modelltext erreicht die Query nie wörtlich (Injection-Schutz). - Metadaten über
cmisselector=object. - Inhalt über
cmisselector=content, mit hartem Byte-Limit vor dem Puffern. - Schreiben über
cmisaction=createDocumentbzw.cmisaction=move(multipart-Form). - Das Repository-Service-Dokument wird einmal pro Endpunkt aufgelöst und 5 Minuten gecacht.
Die Backend-Adresse legen Sie je Endpunkt fest (backend_base_url); der Adapter liest von
dort in Echtzeit.
Abgedeckte DMS
Weil CMIS ein offener Standard ist, deckt ein Adapter mehrere DMS-Produkte ab, ohne produktspezifischen Konnektor:
| DMS | Standard | Anbindung |
|---|---|---|
| VIS-Suite (PDV) | CMIS 1.1 | direkt |
| nscale (Ceyoniq/Kyocera) | CMIS 1.1 | direkt |
| Fabasoft | CMIS 1.1 | direkt |
| Alfresco | CMIS 1.1 | direkt |
| OpenText / Documentum | CMIS 1.1 | direkt |
Voraussetzung ist jeweils, dass Ihre Installation das CMIS-1.1-Browser-Binding anbietet (die Bindings AtomPub und Web Services spricht GovBridge nicht) und ein Dienstkonto bereitsteht (Basic oder OAuth2 Client Credentials).
MCP-Methoden
Zu SovrGPT hin spricht GovBridge die nötigen MCP-Methoden: initialize
(Protokoll-Aushandlung 2025-06-18, Fallback 2024-11-05), tools/list (filtert
Schreibwerkzeuge nach allow_writes), tools/call und ping. Zum Protokoll:
MCP-Server.