L
legal.oszillation.com

Dokumenten-Schnittstelle: Legal-MCP

Anbindung deiner lokalen Chatbots (z.B. Claude Desktop, Cursor, VS Code) an das Legal Studio über das Model Context Protocol.

NEU: PROTOCOL SPEC 2026-07-28

🚀 Was bringt das neueste MCP-Update für Ihre Organisation & Ihr Unternehmen?

Das Model Context Protocol (MCP) ist der weltweite Open-Source-Standard für die sichere Anbindung externer KI-Modelle an lokale Fachdatenbanken. Mit dem neuesten System-Update auf die Protokoll-Spezifikation 2026-07-28 verbindet Legal Studio maximale Datenkontrolle mit einem mitdenkenden Support-Assistenten direkt in Ihrer Arbeitsumgebung.

💬

1. Context-Aware Support Assistant

Ein mitdenkender Studio-Assistent unten rechts, der genau weiß, auf welcher Seite Sie arbeiten. Er beantwortet Fragen zur Bedienung, erklärt Prozentwerte (z.B. 10% Pfadwahrscheinlichkeit) und ordnet Analyseergebnisse verständlich ein.

🛡️

2. Zero Real Case Data Policy (DSGVO)

Jede Eingabe wird vor der Verarbeitung durch unser lokales PII Shield (spaCy KI-Anonymisierung) automatisch gefiltert. Namen, E-Mails und IBANs werden in Platzhalter umgewandelt – echte Mandantsdaten verlassen niemals Ihr System.

🔌

3. Dynamisches Tool-Discovery (24 Tools)

Statt starrer Schnittstellen meldet der MCP-Server seine Fähigkeiten dynamisch an Chatbots wie Claude Desktop oder Cursor. Die Gesamtzahl der spezialisierten Werkzeuge wurde auf 24 MCP-Tools erweitert.

⚖️

4. Transparente Skill-Gewichtung (v3.35)

Ein Bayes'sches Experten-Netzwerk verteilt Entscheidungen gewichtet auf 6 Fachgebiete (Vertragsrecht 28%, Prozessrisiko 22%, Schadensersatz 18% u.a.). So bleiben alle Bewertungen mathematisch nachvollziehbar.

🛠️ Neue MCP-Tools im 2026-07-28 Standard (Erweiterung von 20 auf 24 Tools):

21. support_get_page_documentation
Liefert kontextsensitive Hilfe & UI-Erklärungen für die jeweils aktive Seite.
22. support_explain_agent_network
Erklärt die 6 KI-Fachagenten, deren Stimmgewichte & Bayes-Orchestrierung.
23. support_explain_analysis_execution
Ordnet MCTS-Simulationsknoten und Pfadwahrscheinlichkeiten (z.B. 10%) ein.
24. support_get_skill_weighting_matrix
Gibt die aktive Gewichtungsmatrix für juristische Risiko- & Vertragsprüfungen aus.

📥 Legal Studio Paket (Lokale Services)

Enthält alle Doppelklick-Startskripte, die isolierte Fall-Datenbank und die automatische KI-Agenten-Anleitung.

🤝 Unterstützung bei Einrichtung, Individualisierung & Erstgespräch

Du möchtest das Legal Studio für deine Organisation einrichten, wünschst dir Unterstützung bei der lokalen MCP-Anbindung oder möchtest die Multi-Agenten-Architektur auf deine spezifischen Branchenprozesse anpassen lassen?

Ob Recht, Medizin, Finanzen, Versicherung oder Handel – komplexe Fall- und Dokumentenanalysen erfordern 100% DSGVO- und EU AI Act-Konformität. Das Herzstück unseres Systems ist das Agent Network Protocol mit reaktiver Multi-Agenten-Orchestrierung, Bayes'schen Entscheidungsknoten und mathematischer Gewichtung zur verlässlichen Halluzinationsvermeidung.

Matthias Köhler (M.Sc.) steht dir persönlich zur Seite: Von der lokalen Ersteinrichtung über die Integration deiner Fachanforderungen bis hin zur maßgeschneiderten Unternehmens-Architektur.

💬 Lass uns dein Projekt in einem unverbindlichen Erstgespräch besprechen!

📦 Was steckt in der ZIP-Datei und wie bedienst du sie? (Ganz ohne Technik-Wissen)

📂 Inhalt von legal-studio-paket.zip – Deine Dateien auf einen Blick:
Start Icon
🚀 1-Klick Start-Knöpfe
Legal-Studio-Start.command (für Mac)
Legal-Studio-Start.bat (für Windows)
Doppelklick startet alle Dienste & öffnet den Browser.
Stop Icon
🛑 1-Klick Feierabend-Knöpfe
Legal-Studio-Stop.command (für Mac)
Legal-Studio-Stop.bat (für Windows)
Doppelklick beendet alle Hintergrund-Dienste sauber.
🔒 Lokale Server-Konfiguration
docker-compose.yml & Steuerungs-Skripte
• Startet Anonymisierung (Sanitizer-API), Postgres-DB & MCP-Gateway
Verschlüsselt und verarbeitet all deine Daten 100% lokal auf deinem PC.
▶️ Wie startest du das Legal Studio? (3 Klicks)
📖 WICHTIG VOR DEM ERSTEN START: Bitte lies unbedingt als Erstes die im Paket enthaltene README.md aufmerksam durch!
  1. Entpacke die heruntergeladene legal-studio-paket.zip-Datei.
  2. Stelle sicher, dass Docker Desktop auf deinem PC/Mac läuft.
  3. Doppelklicke auf:
    • Mac-Nutzer: Legal-Studio-Start.command (oder ⚡ Einmalig Freischalten.command vor dem 1. Start, falls Apple eine Gatekeeper-Warnung zeigt)
    • Windows-Nutzer: Legal-Studio-Start.bat
  4. Fertig! Das Terminal startet alles im Hintergrund und öffnet sofort https://legal.oszillation.com im Browser. Du musst im Terminal nichts eintippen!
⏹️ Wie beendest du die Arbeit? (Feierabend)
Du hast zwei ganz einfache Möglichkeiten:

1. Direkt in der Benutzeroberfläche:
Gehe im Browser auf Einstellungen → 🔌 Lokaler Container-Status und klicke auf 🛑 Feierabend / Dienste pausieren. Das spart sofort PC-Leistung für den Abend.

2. Rechner vollständig ausschalten:
Doppelklicke im Ordner einfach auf Legal-Studio-Stop.command (Mac) bzw. Legal-Studio-Stop.bat (Windows). Alle Dienste fahren sauber herunter. Deine Fälle & Dokumente bleiben zu 100% lokal auf deiner Festplatte gespeichert!
🤖 Alternative: Deinen eigenen KI-Assistenten beauftragen (Claude Desktop / Cursor)

Falls du einen lokalen KI-Desktop-Assistenten nutzt, kannst du ihm einfach diesen Text kopieren und geben:

"Ich habe legal-studio-paket.zip entpackt. Bitte prüfe, ob Docker Desktop läuft, starte den Server für mich per 'Legal-Studio-Start' und binde den MCP-Server in meine claude_desktop_config.json ein."
⚠️ Hinweis bei Nutzung von ChatGPT oder Claude im Browser

Nutzt du ein KI-Modell rein im Webbrowser (z.B. Claude.ai Web oder ChatGPT Web), antwortet die KI, dass sie in einer isolierten Cloud-Sandbox läuft und aus Sicherheitsgründen keinen Zugriff auf deinen Rechner hat.

Lösung: Das ist völlig normal! Nutze einfach die 1-Klick Starter oben (unter Windows Doppelklick auf Legal-Studio-Start.bat, unter macOS auf Legal-Studio-Start.command).

🔒 Das Prinzip der clientseitigen Anonymisierung (DSGVO)

Mithilfe des Model Context Protocols (MCP) können Anwälte direkt in ihrem vertrauten Desktop-Chatbot (wie Claude Desktop) oder ihrer bevorzugten IDE (wie Cursor/VS Code) auf die Fälle zugreifen. Das Besondere: Der MCP-Server lädt ausschließlich die bereits lokal anonymisierten Versionen der Dokumente aus deiner Datenbank. Sensible Daten (Namen, Orte) verlassen somit zu keinem Zeitpunkt dein lokales System.

🔄 Der kollaborative Live-Verbindungskreis (Dokumenten-Workspace ⇄ Desktop-KI)

Mit dieser Anwendung verbinden wir deine Fall-Übersicht nahtlos mit deiner lokalen Desktop-KI (z.B. Antigravity, Claude Desktop oder Cursor). Du profitierst von der maximalen Rechenleistung deiner Desktop-KI, während deine Falldaten vollständig lokal geschützt bleiben.

1. Auslösen im Workspace (Browser)

Du wählst im Web-Interface deine Dokumente und die gewünschten AI Panel-Spezialisten aus und klickst auf "Analyse starten". Die Webseite ist stateless und leitet den Auftrag sofort in eine lokale Warteschlange.

2. Live-Verarbeitung auf dem Desktop

Der im Hintergrund laufende Desktop-Orchestrator erkennt die Anfrage. Er liest die echten Skills aus deinem lokalen Verzeichnis und wendet sie per Subsumtion auf den Fall an.

3. Echtzeit-Rückübermittlung & Zitation

Die berechneten Analysen und der fertige Schriftsatz-Entwurf werden über die MCP-Schnittstelle zurück in den Workspace geschickt. Die Lade-Animation erlischt, und du siehst die echten Ergebnisse mitsamt präziser Quellennachweise (z.B. 📚 /skills/beamtenrecht/SKILL.md) und dem Zeitstempel der Auswertung.

📦 1. Installation & Integration

Da der MCP-Server vollständig isoliert im Docker-Netzwerk ausgeführt wird, ist keine lokale NodeJS- oder npm-Installation auf deinem Rechner erforderlich. Kopiere einfach die folgenden Konfigurationsblöcke in dein System:

🖥️ Claude Desktop (macOS / Windows)Konfigurations-Pfad: ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "legal-studio": {
      "command": "docker",
      "args": [
        "exec",
        "-i",
        "legal-mcp",
        "node",
        "build/index.js"
      ]
    }
  }
}
💡 Best Practice: Nutzt den bereits laufenden Compose-Container legal-mcp. Erzeugt 0 temporäre Untercontainer.
🚀 Cursor / Antigravity IDE (mcp_config.json)Konfigurations-Pfad: ~/.gemini/config/mcp_config.json
{
  "mcpServers": {
    "legal-studio": {
      "command": "/usr/local/bin/docker",
      "env": {
        "PATH": "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin"
      },
      "args": [
        "exec",
        "-i",
        "legal-mcp",
        "node",
        "build/index.js"
      ]
    }
  }
}
💡 Best Practice: Nutzt den bereits laufenden Compose-Container legal-mcp. Erzeugt 0 temporäre Untercontainer.

🛠️ 2. Die 24 Studio-MCP-Tools (Inkl. Support & Diagnostik)

📂 Fälle & Dokumente

1. law_list_casesFälle auflisten

Gibt alle aktiven Fälle deines Studios zurück. Ideal, um die case_id für nachfolgende Aktionen herauszufinden.

2. law_get_case_anonymizedFall einlesen (Anonymisiert - DSGVO Art. 4 Nr. 1)

Lädt alle hochgeladenen Dokumente des Falls herunter. Alle Klarnamen sind durch eckige Klammer-Token wie [PER_1] maskiert.

3. law_get_case_pseudonymizedFall einlesen (Pseudonymisiert - DSGVO Art. 4 Nr. 5)

Lädt alle hochgeladenen Dokumente des Falls mit flüssigen, realistischen Lesbarkeits-Pseudonymen (z. B. Max Mustermann GmbH, Muster Consulting GmbH) herunter. Ideal für kontextreiche KI-Analysen ohne Datenleaks.

4. law_save_draftSchriftsatz zurückspeichern

Speichert einen in deiner IDE oder deinem Chatbot geschriebenen Entwurf direkt im PostgreSQL-Workspace des Falls ab.

5. law_get_caseFall-Details (Intern)

Lädt die kompletten internen Falldaten und Anmerkungen.

📚 Studio-Bibliothek (Über 240+ Rechtsgebiete)

6. law_list_skillsRechtsgebiete auflisten

Gibt eine Liste aller im Studio-Archiv installierten Fachbereiche und Subsumtions-Ordner aus.

7. law_search_skillsFachbereiche durchsuchen

Durchsucht die Bibliothek nach Schlagworten (z. B. "Beamte", "Miete", "AGB"), um das passende Fachmodul zu finden.

8. law_get_skill_contentFachinhalte & Richtlinien laden

Lädt die Systemanweisungen und juristischen Richtlinien (README.md) eines bestimmten Skills (z.B. beamtenrecht), um diese als Systemprompt in deinem Chatbot zu verwenden.

🔒 Datenschutz, Anonymisierung & Pseudonymisierung

9. law_sanitize_textText maskieren (Dual-Mode)

Maskiert einen beliebigen juristischen Roh-Text über den lokalen NER-Service. Unterstützt den Parameter mode: "anonymize" (Token-Maskierung) oder mode: "pseudonymize" (Klarnamen-Pseudonymisierung).

10. law_desanitize_textRe-Anonymisierung / Ent-Pseudonymisierung

Ersetzt die Platzhalter oder Pseudonyme im generierten Entwurf wieder durch die echten Identitäten und Namen aus deiner lokalen Datenbank.

👥 Experten-Teamsteuerung (Kollaboration)

11. law_get_active_agentsAktives Team abrufen

Gibt zurück, welche AI Panel-Spezialisten (z.B. AGB-Prüfer) und Skills aktuell im Web-Interface für den Fall ausgewählt sind.

12. law_set_active_agentsTeam-Konfiguration überschreiben

Erlaubt der IDE, die ausgewählten Fachagenten (Slots) und deren Skill-Zuweisung im Web-Interface ferngesteuert zu verändern.

13. law_add_custom_agentNeuen Experten anlegen

Erstellt einen völlig neuen Experten-Slot für den Fall (z. B. "Mexiko-Spezialist") und weist ihm direkt einen spezifischen Skill zu.

14. law_get_editor_draftAktuellen Web-Editor-Entwurf auslesen

Liest den momentan im Browser-Editor ungespeichert geschriebenen Text live aus. Ideal, um ihn in der IDE direkt weiterzubearbeiten.

15. law_update_editor_draftWeb-Editor live beschreiben

Schreibt einen in deiner IDE oder deinem Chatbot überarbeiteten Schriftsatz live in Echtzeit zurück in das Textfeld der Webseite.

📐 Bayes-Steuerung & Multi-Agenten-Orchestrierung

16. law_get_pending_analysisAusstehende Dokumenten-Workspace-Analyse abrufen

Prüft, ob der Nutzer im Dokumenten-Workspace eine kollaborative Analyse von Schriftsätzen angefordert hat. Gibt den zu analysierenden Text sowie die ausgewählten Fachagenten und Skills zurück.

17. law_submit_analysis_resultAnalyseergebnisse an Dokumenten-Workspace übermitteln

Übermittelt berechnete Analyseergebnisse (Findings, Management-Summary, Schriftsatz-Entwurf) direkt zurück in den Dokumenten-Workspace.

18. law_get_bayes_metricsBayes-Belief-State & Risikoprofil auslesen

Liest den aktuellen mathematischen Bayes-Belief-State (Prior-/Posterior-Wahrscheinlichkeiten für $H_1$ Unwirksam vs. $H_2$ Wirksam, Dealbreaker-Risk-Scores, Data Sensitivity Score und MAUT-Profil) für einen Fall aus.

19. law_trigger_analysisMulti-Agenten- & Bayes-Analyse auslösen

Erlaubt externen KI-Clients das automatisierte Auslösen von Multi-Agenten-Analysen und Bayes-Steuerungsläufen (Modi: classical, bayes_basic, bayes_expert) für einen Fall.

20. law_get_analysis_resultsAnalyseergebnisse & Schriftsätze abfragen

Ruft die berechneten Fachgutachten aller Agenten, die Management-Zusammenfassung und den generierten Markdown-Schriftsatz ab.

💬 Support & System-Diagnostik (MCP Protocol Spec 2026-07-28)

21. support_get_page_documentationSeiten-Dokumentation & UI-Erklärung

Liefert kontextsensitive Erklärungen zur Bedienung und den Funktionen der aktuell geöffneten Studio-Seite.

22. support_explain_agent_networkKI-Agentennetzwerk & Bayes-Gewichte erklären

Liefert eine interaktive Aufschlüsselung aller 6 Fachagenten, deren Prozentanteilen und der Bayes'schen Ensemble-Auswertung.

23. support_explain_analysis_executionMCTS-Baumknoten & Prozentwerte aufschlüsseln

Erklärt in verständlicher Sprache, was Simulations-Knoten und z.B. 10% Pfadwahrscheinlichkeiten in der Risikoanalyse bedeuten.

24. support_get_skill_weighting_matrixSkill-Gewichtungsmatrix abrufen

Gibt die mathematische Gewichtungsmatrix der juristischen Subsumtions-Skills (v3.35) zur transparenten Nachvollziehbarkeit aus.

🚨 3. AI Compliance & DSGVO-Vorgaben (EU AI Act)

Da externe Desktop-Agenten (Claude Desktop, Cursor) auf externe Server des jeweiligen LLM-Anbieters zugreifen, müssen diese zwingend den Datenstrom anonymisieren, um sensible Falldaten zu schützen:

❌ UNZULÄSSIG (Verstoß)
  • Verwendung von law_get_case zur Textanalyse (enthält Klarnamen).
  • Direkte SQL-Queries über die Kommandozeile zur Extraktion von Texten für LLM-Prompts.
  • Manuelles Einfügen von Klarnamen in Chat-Eingabefelder für externe GPT- oder Claude-Modelle.
✅ COMPLIANT (Sicherer Pfad)
  • Ausschließliche Verwendung von law_get_case_anonymized oder law_get_case_pseudonymized für jegliche Schriftsatz-Analysen.
  • Beibehaltung der Pseudonyme oder Platzhalter beim Generieren von Entwürfen, damit das API Gateway im Browser die Klarnamen lokal einfügen kann.
  • Verwendung von law_sanitize_text vor dem Senden von Freitext-Prompts an externe KIs.

💬 3. Beispiel-Prompts (für Claude Desktop / Cursor)

Nutze diese exakten Prompts in deinem Chatbot, um direkt mit dem Fall, deiner Studio-Bibliothek und den Bayes-Regeln zu interagieren:

Prompt 1: Pseudonymisierte Dokumenten-Analyse (DSGVO Art. 4 Nr. 5)
"1. Lade alle Dokumente des Falls mit der ID '123' über das Tool law_get_case_pseudonymized.
2. Verwende die im Text enthaltenen Pseudonyme (wie Max Mustermann GmbH) direkt für den Entwurf.
3. Speichere den fertigen Schriftsatz mit law_save_draft im Fall '123' unter 'widerspruch-dsgvo.md' ab."
Prompt 2: Bayes-Analyse auslösen & MAUT-Risikoprofil abfragen
"1. Triggere die mathematische Bayes-Experten-Analyse für den Fall '123' mit law_trigger_analysis in der Domäne 'COMPLIANCE' (orchestration_mode: 'bayes_expert').
2. Rufe die berechneten Bayes-Metriken (Probabilities H1 vs H2 & Risk Scores) mit law_get_bayes_metrics ab.
3. Speichere die Zusammenfassung mit law_save_draft ab."

🐳 4. Lokales Studio-Paket (Docker-Compose)

Das herunterladbare Legal Studio Paket enthält die nachfolgende docker-compose.yml. Damit werden die verschlüsselte lokale PostgreSQL-Datenbank (mit pgvector), der DSGVO-Sanitizer, das API Gateway sowie der MCP-Server auf deinem Rechner lokal gebaut und isoliert gestartet (das Web-Interface verbindet sich automatisch per Localhost-CORS direkt mit deinem lokalen Tresor-Container):

version: '3.8'

services:
  db:
    image: ankane/pgvector:latest
    container_name: legal-db
    restart: always
    environment:
      POSTGRES_USER: legal_user
      POSTGRES_PASSWORD: legal_password
      POSTGRES_DB: legal_brain
    ports:
      - "5433:5432"
    volumes:
      - pgdata:/var/lib/postgresql/data
    networks:
      - default

  sanitizer-api:
    build:
      context: ./sanitizer-api
      dockerfile: Dockerfile
    container_name: legal-sanitizer
    ports:
      - "8001:8000"
    networks:
      - default

  api-gateway:
    build:
      context: ./api-gateway
      dockerfile: Dockerfile
    container_name: legal-gateway
    ports:
      - "4000:4000"
    networks:
      - default

  desktop-orchestrator:
    build:
      context: ./mcp-server
      dockerfile: Dockerfile
    container_name: legal-desktop-orchestrator
    networks:
      - default

networks:
  default:
    name: legal_oszillation_network

volumes:
  pgdata:
Führe im entpackten Paket einfach docker compose up -d --build aus (oder doppelklicke auf start-studio.sh / start-studio.bat). Die Services bauen und starten vollautomatisch im Hintergrund.
© 2026 ai.oszillation · Inhaber: Matthias Köhler (M.Sc.) · Senior AI Consultant & Project Leader
Haftungsausschluss: Dieses Tool ist ein technisches Forschungs- und Demonstrationsprojekt. Es erbringt keine Rechtsberatung oder Rechtsdienstleistungen im Sinne des Rechtsdienstleistungsgesetzes (RDG). KI-generierte Inhalte ersetzen keine qualifizierte anwaltliche Beratung.