Buchhaltung mit Cline: MCP-Server in VS Code und der Cline CLI

Warum Cline für die Buchhaltung eine eigene Anleitung braucht

Schritt 1: Schlüssel anlegen

• In der App: Buchhaltung → Einstellungen → „KI-Agent & API“. Administratoren und der Ersteller des Arbeitsbereichs legen Schlüssel an und bestätigen mit dem zweiten Faktor.
• Starten Sie mit read. Unser Server zeigt Cline dann nur lesende Werkzeuge; write nehmen Sie erst dazu, wenn Cline buchen soll.
• Wählen Sie 30 Tage, 90 Tage oder ein Jahr – für den Einstieg mit Cline genügen 30 Tage. Der Schlüssel jab_live_… erscheint nur einmal; bei uns liegt nur ein Hash.
• Das Einsetzen von Umgebungsvariablen in headers beschreibt die Cline-Dokumentation nicht. Der Schlüssel steht deshalb im Klartext in der Einstellungsdatei – kurze Laufzeit wählen und die Datei nicht teilen.

Schritt 2: cline_mcp_settings.json

In der Erweiterung öffnen Sie die Datei über das Symbol „MCP Servers“ in der Leiste von Cline, den Reiter „Configure“ und „Configure MCP Servers“. Die Cline CLI liest ~/.cline/data/settings/cline_mcp_settings.json. Der Eintrag folgt dem Beispiel für entfernte Server aus der Cline-Dokumentation:

{
  "mcpServers": {
    "buchhaltung": {
      "type": "streamableHttp",
      "url": "https://api.jahresabschluss.io/functions/v1/bookkeeping-mcp",
      "headers": {
        "Authorization": "Bearer jab_live_…"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Über den Reiter „Remote Servers“ lassen sich Name, Adresse und Verfahren („Streamable HTTP“) auch per Formular eintragen. Ein Feld für Kopfzeilen nennt die Dokumentation dort nicht; ergänzen Sie headers deshalb anschließend in der Datei.

Nach dem Speichern zeigt Cline den Server mit seinen Werkzeugen an. Sehen Sie nur lesende Werkzeuge, arbeitet Cline mit einem Leseschlüssel – so ist es für den Anfang gedacht. Meldet unser Server 401, ist der Schlüssel falsch eingetragen, abgelaufen oder widerrufen.

Oder mit der Cline CLI

cline mcp add trägt einen entfernten Server mit --transport http und --header ein; ohne --yes öffnet sich der Assistent mit den Angaben vorausgefüllt:

# Cline CLI: Server mit Kopfzeile eintragen
cline mcp add buchhaltung \
  https://api.jahresabschluss.io/functions/v1/bookkeeping-mcp \
  --transport http \
  --header "Authorization: Bearer jab_live_…"

# ohne --yes öffnet sich der Assistent mit vorausgefüllten Feldern
cline mcp

Freigaben: autoApprove leer, MCP nicht pauschal

• autoApprove ist eine Liste von Werkzeugnamen, die Cline ohne Rückfrage aufruft. Die Dokumentation rät, sie auf sichere Werkzeuge zu beschränken. Für die Buchhaltung kommen höchstens reine Abfragen in Frage, etwa get_saldenliste oder list_open_items – nie create_journal_entry, record_incoming_invoice_payment, book_bank_transaction oder finalize_bookkeeping_period.
• Im Bereich „Auto Approve“ steht der Schalter „Use MCP servers“ für MCP-Werkzeuge. Cline empfiehlt selbst, ihn ausgeschaltet zu lassen, solange es keinen bestimmten Grund gibt.
• YOLO Mode (Einstellungen → Features) gibt alles ohne Rückfrage frei, auch MCP-Werkzeuge. Mit einem Schreibschlüssel für die Buchhaltung sollte er nie aktiv sein.
• Plan- und Act-Modus helfen, einen Ablauf erst zu besprechen und dann auszuführen. Ob Cline im Plan-Modus MCP-Werkzeuge aufruft, beschreibt die Dokumentation nicht – verlassen Sie sich für Buchungen auf die Freigaben, nicht auf den Modus.

Aufträge an Cline: Zahlungen und offene Posten

Cline zeigt vor jedem Aufruf Werkzeug und Argumente an. Das passt zu Zahlungen, bei denen jeder Betrag zählt:

Grenzen, GoBD und was in der App bleibt

• Jede Buchung läuft durch den Buchungskern der App: Soll gleich Haben, Storno statt Löschen, nichts in festgeschriebenen Zeiträumen. Das folgt aus § 146 Abs. 4 AO und § 239 Abs. 3 HGB, nach denen der ursprüngliche Inhalt einer Buchung feststellbar bleiben muss.
• Steuern prüft und bereitet der Agent nur vor (check_tax_filing, prepare_tax_filing, request_tax_filing_approval); übermittelt wird in der App mit Ihrer PIN.
• Auch im Act-Modus bleibt außen vor, was die API nicht anbietet: Bankanbindung, Einstellungen der Gesellschaft, Bankverbindungen der Geschäftspartner und freie Datenbankabfragen.
• Verwendungszwecke und Belegtexte stammen von Dritten; unser Server weist den Agenten an, sie als Daten zu behandeln und keine Anweisung daraus zu befolgen.
• Was Cline vorschlägt, bleibt ein Vorschlag. Ihre Steuerberatung kann in derselben Software mitarbeiten; die Software ersetzt keine Steuerberatung.

Häufige Fragen

Warum verbindet sich Cline nicht mit dem MCP-Server?

Meist fehlt "type": "streamableHttp". Ohne diese Angabe verwendet Cline das ältere SSE-Verfahren, das unser Server nicht anbietet. Prüfen Sie außerdem, ob die Kopfzeile Authorization: Bearer jab_live_… korrekt geschrieben und der Schlüssel noch gültig ist.

Wo liegt cline_mcp_settings.json?

In der Erweiterung öffnen Sie die Datei über „MCP Servers“ → „Configure“ → „Configure MCP Servers“. Die Cline CLI nutzt ~/.cline/data/settings/cline_mcp_settings.json; mit CLINE_MCP_SETTINGS_PATH lässt sich ein anderer Ort festlegen.

Soll ich Werkzeuge in autoApprove eintragen?

Höchstens lesende wie get_saldenliste oder list_open_items. Buchen, Zahlungen, Stornos, Rechnungen und Festschreiben gehören nie dazu; dort bestätigen Sie jeden Aufruf einzeln.

Kann Cline mit einem lokalen Modell buchen?

Ja, sofern das Modell Funktionsaufrufe beherrscht. Die Verbindung zur Buchhaltung ist dieselbe. Kleine Modelle wählen Werkzeuge weniger zuverlässig; beginnen Sie mit einem Leseschlüssel und lassen Sie sich jeden Buchungssatz vorher nennen.

Kann Cline meine Umsatzsteuer-Voranmeldung abgeben?

Nein. Mit Schreibrecht prüft der Agent sie amtlich ohne Versand, bereitet die Übermittlung vor und fordert einen Freigabe-Link an. Übermittelt wird in der App mit Ihrer PIN.

Wie nehme ich Cline den Zugriff wieder?

Widerrufen Sie den Schlüssel unter „KI-Agent & API“; danach weist unser Server jeden Aufruf ab. In Cline schalten Sie den Server mit "disabled": true ab, ohne den Eintrag zu löschen.