Einstieg

In Minuten integriert.

LedgerLou bündelt Bank, Belege, Journal, Debitoren, Kreditoren und Auswertungen in einem zentralen Hauptbuch — zugänglich via REST API und MCP. Beide Wege teilen dieselbe Ledger-Engine, dieselben Scopes, dieselbe Audit-Logik.

REST APIMCPAPI-KeyScope-gesteuert

Empfohlener Einstieg

Authentifizierung & Scopes verstehenBevor du den ersten Request absetzt, lies wie API-Keys und Scopes funktionieren. Alle Routen und MCP-Tools sind scope-gesteuert — ein 403 ohne passendem Scope ist das häufigste erste Problem.

Integrationsart wählenEntscheide dich für deinen Zugangsweg: REST API für klassische System-zu-System-Integration oder MCP für Agenten-Workflows und toolbasierte Assistenz.

Mit Read-Zugriffen startenBeginne mit lesenden Abfragen (*:read), um Kontext aufzubauen — Journal, Banktransaktionen, Kontenrahmen. Kein Schreibzugriff nötig für den ersten Test.

Schreibrechte gezielt einsetzenErst wenn der lesende Zugriff stabil läuft, Schreib- und Review-Scopes hinzufügen. Pro Integration einen eigenen Schlüssel verwenden.

Erste Buchung in 5 Minuten

Via MCP (KI-Agent)

API-Key erstellenIm Dashboard unter Einstellungen → API-Keys einen Key mit den Scopes journal:read und journal:write erstellen.

MCP verbindenConfig-Snippet in deine App einfügen (Claude Desktop, Cursor, etc.):

{
  "mcpServers": {
    "ledgerlou": {
      "url": "https://api.ledgerlou.de/mcp",
      "headers": {
        "Authorization": "Bearer ll_dein-api-key"
      }
    }
  }
}

Agent beauftragenSag deinem Agenten z.B.: “Zeige mir den Kontenplan und buche eine Eingangsrechnung über 500 € netto von Lieferant XY auf Konto 3400.” — Der Agent nutzt automatisch die richtigen MCP-Tools.

Via REST API

Kontenplan laden

curl https://api.ledgerlou.com/v1/accounts \
  -H "Authorization: Bearer ll_dein-api-key"

Beleg hochladen

curl -X POST https://api.ledgerlou.com/v1/documents \
  -H "Authorization: Bearer ll_dein-api-key" \
  -F "file=@rechnung.pdf"

Buchung erstellen

curl -X POST https://api.ledgerlou.com/v1/journal/bookings \
  -H "Authorization: Bearer ll_dein-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "2026-04-14",
    "description": "Eingangsrechnung Lieferant XY",
    "line_items": [
      { "account": "3400", "debit": 500.00 },
      { "account": "1576", "debit": 95.00 },
      { "account": "1600", "credit": 595.00 }
    ]
  }'

Referenzen & Einstiegspunkte

Auth & ScopesAPI-Key-Modell, Scope-Format und Prüflogik für REST und MCP./start/auth-scopes

REST EndpointsVollständige Endpoint-Referenz mit Parametern, Responses und HTTP-Methoden./reference/rest-endpoints

MCP SetupÖffentlicher Überblick zum MCP-Verbindungsablauf und Scope-Modell./mcp/setup