Buchhaltung mit Zed: MCP-Server für das Agent Panel einrichten

Zed und MCP im Oktober 2026

Schritt 1: Schlüssel anlegen

• In der App: Buchhaltung → Einstellungen → „KI-Agent & API“. Administratoren und der Ersteller des Arbeitsbereichs legen Schlüssel an, bestätigt mit dem zweiten Faktor.
• Starten Sie mit read; unser Server bietet Zed dann nur lesende Werkzeuge an. Für Buchungen kommt später ein zweiter Schlüssel mit write hinzu.
• Laufzeit: 30 Tage, 90 Tage oder ein Jahr. Der Schlüssel jab_live_… öffnet genau eine Gesellschaft; eine zweite Gesellschaft verbinden Sie mit einem zweiten Schlüssel und einem zweiten Eintrag unter context_servers.
• Ein Einsetzen von Umgebungsvariablen in Kopfzeilen beschreibt die Zed-Dokumentation nicht. Der Schlüssel steht deshalb im Klartext in den Einstellungen – wählen Sie eine kurze Laufzeit.

Schritt 2: der Eintrag unter context_servers

Öffnen Sie Ihre Benutzereinstellungen (macOS und Linux: ~/.config/zed/settings.json, Windows: %APPDATA%\Zed\settings.json) und ergänzen Sie den Server nach dem Muster der Zed-Dokumentation:

{
  "context_servers": {
    "buchhaltung": {
      "url": "https://api.jahresabschluss.io/functions/v1/bookkeeping-mcp",
      "headers": { "Authorization": "Bearer jab_live_…" }
    }
  }
}

Projekteinstellungen in .zed/settings.json wären der falsche Ort: Sie liegen im Repository, und Zed startet MCP-Server aus einem Projekt ohnehin erst, wenn Sie dem Arbeitsbereich vertrauen. Der Schlüssel gehört zu Ihnen und einer Gesellschaft, nicht zu einem Code-Projekt.

Ob die Verbindung steht, sehen Sie unter Settings → AI → MCP Servers. Meldet unser Server 401, ist der Schlüssel falsch, abgelaufen oder widerrufen; nach einem Tausch genügt es, den Wert in headers zu ersetzen.

Schritt 3: Werkzeugrechte mit tool_permissions

Werkzeuge eines MCP-Servers sprechen Sie in Zed mit dem Schlüssel mcp:<server>:<werkzeug> an; erlaubt sind confirm, allow und deny. Für die Buchhaltung bietet sich an:

{
  "agent": {
    "tool_permissions": {
      "default": "confirm",
      "tools": {
        "mcp:buchhaltung:get_saldenliste": { "default": "allow" },
        "mcp:buchhaltung:list_journal_entries": { "default": "allow" },
        "mcp:buchhaltung:list_cash_book": { "default": "allow" },
        "mcp:buchhaltung:finalize_bookkeeping_period": { "default": "deny" }
      }
    }
  }
}

So laufen Saldenliste, Journal und Kassenbuch ohne Rückfrage, das Festschreiben ist gesperrt, und alles andere – Buchen, Stornieren, Rechnungen – fragt nach. Bei der Rückfrage bietet Zed „Allow once“, „Deny once“ und „Always for …“; für MCP-Werkzeuge gilt die dauerhafte Freigabe je Werkzeug. Wählen Sie „Always“ nie bei einem schreibenden Werkzeug.

Ältere Fassungen vor 0.224.0 kannten nur den Schalter agent.always_allow_tool_actions; er muss für die Buchhaltung auf false bleiben.

Profile im Agent Panel

• Zed bringt die Profile Write, Ask und Minimal mit. Über die Profilauswahl im Agent Panel → Configure oder den Befehl agent::ManageProfiles legen Sie fest, welche Werkzeuge eines MCP-Servers ein Profil enthält.
• Ein eigenes Profil „Buchhaltung lesen“ mit nur lesenden Werkzeugen des Servers ist eine gute Ergänzung zum Leseschlüssel: Der Agent sieht dann gar keine schreibenden Werkzeuge, selbst wenn der Schlüssel sie erlaubt.
• Wichtig laut Zed: Profile entscheiden nicht, ob ein Aufruf ohne Rückfrage läuft – das regelt allein tool_permissions. Beides zusammen ergibt eine klare Grenze.

Aufträge im Agent Panel: Journal und Kasse

Grenzen und Recht

• Steuern: amtlich prüfen (check_tax_filing), vorbereiten (prepare_tax_filing), Freigabe-Link (request_tax_filing_approval). Die Übermittlung an ELSTER erfolgt in der App mit Ihrer PIN.
• Was Zed über unseren Server nie erreicht: die Bankanbindung, die Einstellungen der Gesellschaft, IBAN und BIC der Geschäftspartner und freie Datenbankabfragen.
• Storno statt Löschen ist keine Eigenheit der Software: § 146 Abs. 4 AO und § 239 Abs. 3 HGB verbieten, eine Buchung so zu verändern, dass der ursprüngliche Inhalt nicht mehr feststellbar ist.
• Wiederholt der Agent einen Aufruf nach einer Zeitüberschreitung mit derselben UUID (idempotency_key), entsteht keine zweite Buchung; eine neue UUID wäre ein neuer Vorgang.
• Welches Sprachmodell die gelesenen Daten verarbeitet, stellen Sie in Zed ein. Vorschläge des Agenten prüfen Sie selbst oder mit Ihrer Steuerberatung.

Häufige Fragen

Wie trage ich die Buchhaltung als MCP-Server in Zed ein?

Unter context_servers in ~/.config/zed/settings.json mit url (Adresse unseres MCP-Servers) und headers mit Authorization: Bearer jab_live_…. Alternativ über Settings → AI → MCP Servers → Add Server → Add Remote Server.

Brauche ich mcp-remote für Zed?

Nein. Zed verbindet entfernte MCP-Server per HTTP direkt und sendet die Kopfzeile selbst. Eine Brücke ist nicht nötig.

Fragt Zed, bevor es bucht?

Ja, in der Grundeinstellung confirm fragt Zed vor jedem Werkzeugaufruf. Mit tool_permissions erlauben Sie gezielt lesende Werkzeuge und sperren etwa das Festschreiben mit deny.

Kann ich den Schlüssel als Umgebungsvariable eintragen?

Die Zed-Dokumentation beschreibt das für Kopfzeilen nicht. Tragen Sie den Schlüssel deshalb in die Benutzereinstellungen ein, nicht in ein Projekt, und wählen Sie eine kurze Laufzeit.

Was ist der Unterschied zwischen Profil und tool_permissions?

Ein Profil legt fest, welche Werkzeuge der Agent sieht. tool_permissions legt fest, ob ein Aufruf ohne Rückfrage läuft, nachfragt oder gesperrt ist. Für die Buchhaltung nutzen Sie beides.

Kann Zed meine Steuern übermitteln?

Nein. Der Agent kann amtlich prüfen lassen, vorbereiten und einen Freigabe-Link anfordern. Übermittelt wird in der App mit Ihrer PIN.