MCP Grundlagen

MCP ist in LedgerLou der standardisierte Weg, damit Agenten sicher auf Buchhaltungsfunktionen zugreifen.
Wichtig: MCP ist keine separate Datenwelt. Alle Tools arbeiten auf demselben Hauptbuch wie die REST API.

Was MCP in LedgerLou leistet

• Werkzeuge für Lesen, Buchen, Abstimmen und Review-Workflows
• Einheitliches Scope-Modell im Format modul:aktion (z. B. bank:read)
• Klare Guardrails für kritische Aktionen
• Nachvollziehbare Ausführung über Intent- und Journal-Logik

Transport und Laufzeitmodell

• Endpoint: /mcp
• Verfügbare Methoden: POST, GET (SSE), DELETE
• Tools werden serverseitig gegen Scope und Capability-Regeln validiert, bevor eine Aktion ausgeführt wird.

Wie ein typischer MCP-Flow aussieht

1. Agent erhält einen Key mit minimal nötigen Scopes.
2. Agent lädt Kontext über read-Tools.
3. Agent erstellt Vorschlag (z. B. Buchung oder Matching).
4. Bei Schreibaktionen erfolgt explizite Freigabe im Dashboard-UI.
5. Tool schreibt ins Hauptbuch und liefert intent_id/Status zurück.

Entscheidender Architekturpunkt

Ein Agent sollte nie “frei raten”, sondern immer über die vorhandenen Tools arbeiten:

• Konten über search_accounts finden
• Periodenstatus über get_periods prüfen
• Buchungen nur über post_booking oder post_booking_with_document schreiben

So bleibt Verhalten deterministisch, prüfbar und GoBD-konform.