MCP

Der STP.Documents MCP-Server stellt dokumentbezogene Funktionen als Tools für KI-Agenten zur Verfügung. Er ist unter https://common.stp-cloud.de/documents3/bot/mcp erreichbar und unterstützt zustandslose Streamable HTTP-Anfragen.

Autorisierung

Der STP.Documents MCP-Server ist eine durch STP.Identity geschützte Ressource. Leider unterstützt STP.Identity keine Client ID Metadata Documents oder Dynamic Client Registration, daher benötigt jeder MCP-Host, der den STP.Documents MCP-Server nutzt, eine STP.Identity-Client-Registrierung (genauso wie für die Universal API).

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

Der Scope doc3.mcp3 ist für die Verwendung mit spezifikationskonformer OAuth-Autorisierung vorgesehen, was die Nutzung des Ressourcenindikators des MCP-Servers beim Token-Erwerb erfordert. Dadurch werden die Token-Scopes auf die speziell für den STP.Documents MCP-Server vorgesehenen Scopes beschränkt. Wenn der STP.Documents MCP-Server ausschließlich diesen Scope erhält, nutzt er intern einen Token-Austausch, um ein weiteres Zugriffstoken zu erhalten, mit dem er im Namen des Nutzers nachgelagerte STP.Documents-APIs aufruft.

Beispielcode ist unter STP.Documents.Example zu finden.

Tools

Folgende Tools stehen zur Verfügung:

stp_doc_get_current_user

Informationen über den aktuellen Nutzer abrufen.

stp_doc_search_contexts

Akten oder andere Kontexte finden. Das Laden erfolgt über die Universal API.

stp_doc_list_documents

Dokumente einer Akte oder eines anderen Kontexts auflisten. Das Laden erfolgt über die Universal API.

stp_doc_search_documents

Dokumente finden, deren Inhalt semantisch zur Suchanfrage passt. Dafür müssen alle auffindbaren Dokumente zuvor indexiert worden sein. Das Laden erfolgt über die Universal API.

stp_doc_get_document_metadata

Metadaten eines Dokuments wie Kontexte, Akten oder benannte Werte abrufen. Dies umfasst die gleichen Metadaten, die auch über die Universal API verfügbar sind.

stp_doc_read_document

Den Textinhalt eines Dokuments abrufen. Die Volltext-Version (stp.doc.fulltext.txt) ist standardmäßig verfügbar. Gibt es keine Volltext-Version, aber der Dokumenttyp ist text/plain, text/markdown, text/xml, application/xml oder application/json, wird die Originalversion gelesen. Ist die Originalversion application/pdf, wird die Textebene bei Bedarf extrahiert. Bei allen anderen Typen wird die Vorschau-Version (immer PDF) geladen und die Textebene bei Bedarf extrahiert.

Das Laden erfolgt über die Universal API.

stp_doc_create_document

Ein neues Dokument mit Textinhalt (Dateiendung .txt) erstellen. Der Zugriff erfolgt über die Universal API.

stp_doc_search_courtdecisions

Gerichtsentscheidungen finden, die semantisch zur Suchanfrage passen. Führt eine semantische Suche unter allen für Legal Twin®: Smart Legal Research verfügbaren Gerichtsentscheidungen durch.

• Der Mandant muss Legal Twin - Smart Legal Research lizenziert haben.
• Der Nutzer benötigt die Rolle LegalTwin.LegalResearcher.

stp_doconprem_list_tasks

Alle meine offenen Aufgaben (On-Premise) auflisten. Das Laden erfolgt über unverschlüsselte Anfragen über Channel.OnPremise.

stp_doconprem_complete_task

Eine einzelne Aufgabe oder einen Schritt einer Aufgabenliste (On-Premise) abschließen. Der Zugriff erfolgt über unverschlüsselte Anfragen über Channel.OnPremise.

stp_doconprem_search_containers

On-Premise gespeicherte Akten oder andere Container finden. Das Laden erfolgt über unverschlüsselte Anfragen über Channel.OnPremise.

stp_doconprem_list_documents

On-Premise gespeicherte Dokumente einer Akte oder eines anderen Containers auflisten. Das Laden erfolgt über Channel.OnPremise. Das Laden erfolgt über unverschlüsselte Anfragen über Channel.OnPremise.

stp_doconprem_read_document

Den Textinhalt eines On-Premise gespeicherten Dokuments abrufen. Es wird immer im PDF-Format geladen und die Textebene bei Bedarf extrahiert. Das Laden erfolgt über Channel.OnPremise. Das Laden erfolgt über unverschlüsselte Anfragen über Channel.OnPremise.

Ressourcen

Folgende Ressourcen stehen zur Verfügung:

stpdocuments://contexts/{contextReference}

Die Dokumentenliste des angegebenen Kontext-Referenz abrufen.

stpdocuments://documents/{documentId}/fulltext

Die Volltext-Version des Dokuments abrufen.

stpdocuments://documents/{documentId}/preview

Die Vorschau-Version des Dokuments abrufen.

stpdocuments://documents/{documentId}/original

Die Originalversion des Dokuments abrufen.