MCP

Der STP.Documents MCP-Server stellt dokumentbezogene Funktionen als Tools für KI-Agenten bereit. Er ist unter https://common.stp-cloud.de/documents/bot/mcp verfügbar und unterstützt zustandsloses Streamable HTTP.

Autorisierung

Der STP.Documents MCP-Server ist eine durch STP.Identity geschützte Ressource. Leider unterstützt STP.Identity weder Client ID Metadata Documents noch Dynamic Client Registration, weshalb jeder MCP-Host, der den STP.Documents MCP-Server verwendet, eine STP.Identity-Client-Registrierung benötigt (genau wie bei der Universal API).

Der Documents MCP-Server erfordert die Lizenz lexdmsmcp, das Lizenzmodul documents3-mcp, die Berechtigung documents3-mcp, den Scope doc3.mcp4 oder die Rolle Documents3.McpUser. Für diese Rolle ist keine Standardgruppe vorhanden, sie muss daher manuell erstellt werden.

Der Scope doc3.mcp4 ist für die Verwendung mit spezifikationskonformer OAuth-Autorisierung vorgesehen, die den Resource Indicator des MCP-Servers beim Token-Abruf erfordert. Dadurch werden die Scopes des Tokens auf solche beschränkt, die ausschließlich für den STP.Documents MCP-Server vorgesehen sind. Wenn der STP.Documents MCP-Server diesen einzigen Scope erhält, verwendet er intern Token-Exchange, um ein weiteres Zugriffstoken zu beziehen und nachgelagerte STP.Documents-APIs im Namen des Benutzers aufzurufen.

Beispielcode ist unter STP.Documents.Example verfügbar.

Tools

Er stellt folgende Tools bereit:

stp_doc_get_current_user

Gibt Informationen über den aktuellen Benutzer zurück.

stp_doc_search_contexts

Sucht nach Mandaten oder anderen Kontexten. Der Abruf erfolgt über die Universal API.

stp_doc_list_documents

Listet Dokumente einer Akte oder eines anderen Kontexts auf. Der Abruf erfolgt über die Universal API.

stp_doc_search_documents

Sucht nach Dokumenten, deren Inhalt semantisch ähnlich zur Suchanfrage ist. Dazu müssen alle durchsuchbaren Dokumente zuvor indiziert worden sein. Der Abruf erfolgt über die Universal API.

stp_doc_get_document_metadata

Ruft Dokumentmetadaten wie Kontexte, Akten oder benannte Werte ab. Dies umfasst dieselben Metadaten, die auch über die Universal API verfügbar sind.

stp_doc_read_document

Gibt den Textinhalt des Dokuments zurück. Standardmäßig wird die Volltext-Rendition (stp.doc.fulltext.txt) verwendet. Ist keine Volltext-Rendition vorhanden und der ContentType des Dokuments ist text/plain, text/markdown, text/xml, application/xml oder application/json, wird die Original-Rendition gelesen. Ist die Original-Rendition vom Typ application/pdf, wird die Textebene bei Bedarf extrahiert. Bei jedem anderen Typ wird die Vorschau-Rendition (die stets im PDF-Format vorliegt) geladen und die Textebene bei Bedarf extrahiert.

Der Abruf erfolgt über die Universal API.

stp_doc_create_document

Erstellt ein neues Dokument mit Textinhalt (Erweiterung .txt). Der Zugriff erfolgt über die Universal API.

stp_doconprem_list_tasks

Listet alle eigenen offenen Aufgaben (On-Premise) auf. Der Abruf erfolgt über unverschlüsselte Anfragen über Channel.OnPremise.

stp_doconprem_complete_task

Schließt eine einzelne Aufgabe oder einen Aufgabenlistenschritt ab (On-Premise). Der Zugriff erfolgt über unverschlüsselte Anfragen über Channel.OnPremise.

stp_doconprem_search_containers

Sucht nach lokal gespeicherten Akten oder anderen Containern (On-Premise). Der Abruf erfolgt über unverschlüsselte Anfragen über Channel.OnPremise.

stp_doconprem_list_documents

Listet lokal gespeicherte Dokumente einer Akte oder eines anderen On-Premise-Containers auf. Der Abruf erfolgt über Channel.OnPremise. Der Abruf erfolgt über unverschlüsselte Anfragen über Channel.OnPremise.

stp_doconprem_read_document

Gibt den Textinhalt des lokal gespeicherten Dokuments zurück. Das Dokument wird stets im PDF-Format geladen und die Textebene bei Bedarf extrahiert. Der Abruf erfolgt über Channel.OnPremise. Der Abruf erfolgt über unverschlüsselte Anfragen über Channel.OnPremise.

Ressourcen

Er stellt folgende Ressourcen bereit:

stpdocuments://contexts/{contextReference}

Gibt die Dokumentenliste des Kontextreferenz zurück.

stpdocuments://documents/{documentId}/fulltext

Gibt die Volltext-Rendition des Dokuments zurück.

stpdocuments://documents/{documentId}/preview

Gibt die Vorschau-Rendition des Dokuments zurück.

stpdocuments://documents/{documentId}/original

Gibt die Original-Rendition des Dokuments zurück.