Jahresabschluss.io
ENAnmeldenRegistrieren →

Goose

Buchhaltung mit Goose: Erweiterung einrichten und Autonomie abschalten

Goose verbinden Sie mit Ihrer Buchhaltung bei jahresabschluss.io über eine Erweiterung vom Typ Streamable HTTP mit der Adresse unseres MCP-Servers und der Kopfzeile Authorization: Bearer – per goose configure, in der Desktop-App oder direkt in ~/.config/goose/config.yaml. Bevor Sie einen Schlüssel mit Schreibrecht verbinden, ändern Sie eine Grundeinstellung: Goose arbeitet ab Werk im autonomen Modus und ruft Werkzeuge ohne Rückfrage auf. Stellen Sie „Manual Approval“ ein und beginnen Sie mit einem Schlüssel nur mit Leserecht.

Stand: 2026-10-19

Goose im Oktober 2026

Offen und herstellerunabhängig

Goose wurde von Block gegründet und gehört heute zur Agentic AI Foundation (AAIF) bei der Linux Foundation. Das Repository liegt unter github.com/aaif-goose/goose, die Dokumentation unter goose-docs.ai. Goose ist quelloffen und kostet nichts.

Desktop-App und Kommandozeile

Es gibt eine Desktop-App für macOS, Linux und Windows und eine CLI. Beide nutzen dieselbe Konfiguration; welches Sprachmodell Goose verwendet, wählen Sie selbst, auch ein lokales.

Autonom als Grundeinstellung

Laut Dokumentation gilt ab Werk der Modus „Completely Autonomous“ (GOOSE_MODE auto): Goose nutzt Werkzeuge, ohne zu fragen. Für eine Buchhaltung ist das die falsche Grundeinstellung.

Zuerst: Freigabe-Modus umstellen

Goose kennt vier Modi. Für die Buchhaltung kommt nur einer mit Rückfrage in Frage:

  • Completely Autonomous (auto) – Werkzeuge ohne Rückfrage. Nicht mit einem Schreibschlüssel verwenden.
  • Manual Approval (approve) – Goose fragt vor Werkzeugen und Erweiterungen. Das ist der Modus für die Buchhaltung.
  • Smart Approval (smart_approve) – Goose gibt nach eigener Einschätzung geringes Risiko frei und legt den Rest vor.
  • Chat Only (chat) – keine Werkzeuge, nur Unterhaltung.
  • Umstellen: in der Sitzung mit /mode approve; dauerhaft über goose configure → goose settings → goose mode oder mit der Umgebungsvariable GOOSE_MODE=approve; in der Desktop-App unter Settings → Chat → Default Mode. Dort gilt die Einstellung für neue Sitzungen, laufende behalten ihren Modus.

Schritt 1: Schlüssel anlegen – nur Lesen für den Anfang

  • In der App unter Buchhaltung → Einstellungen → „KI-Agent & API“. Administratoren und der Ersteller des Arbeitsbereichs legen Schlüssel an, bestätigt mit dem zweiten Faktor.
  • Nehmen Sie zuerst nur read. Unser Server bietet Goose dann ausschließlich lesende Werkzeuge an. Selbst wenn eine Einstellung in Goose falsch sitzt, kann nichts gebucht werden.
  • Laufzeit: 30 Tage, 90 Tage oder ein Jahr. Für einen Test mit Goose genügen 30 Tage; der Schlüssel beginnt mit jab_live_ und öffnet genau eine Gesellschaft.
  • Die Kopfzeile tippen Sie im Assistenten im Klartext ein; Goose speichert sie unter headers in config.yaml. Halten Sie diese Datei privat und wählen Sie eine kurze Laufzeit.

Schritt 2: die Erweiterung eintragen

Der einfachste Weg ist der Assistent der CLI. Nach „Remote Extension (Streamable HTTP)“ fragt Goose Name, Adresse, Zeitgrenze, Beschreibung und auf Wunsch eigene Kopfzeilen ab:

goose configure
  → Add Extension
  → Remote Extension (Streamable HTTP)
     Name:        buchhaltung
     URI:         https://api.jahresabschluss.io/functions/v1/bookkeeping-mcp
     Timeout:     300
     Header:      Authorization = Bearer jab_live_…

# in einer laufenden Sitzung auf manuelle Freigabe umstellen
/mode approve

In der Desktop-App öffnen Sie in der Seitenleiste Extensions → Add custom extension, wählen den Typ Streamable HTTP, tragen die Adresse als Endpoint ein und die Kopfzeile unter Request Headers. Der Schalter --with-streamable-http-extension für eine einzelne Sitzung nimmt keine Kopfzeilen an und eignet sich deshalb nicht für unseren Server.

So sieht der Eintrag in config.yaml aus

Die Felder type, name, enabled, uri, headers, env_keys, envs und timeout folgen dem Beispiel für streamable_http aus der Goose-Dokumentation; GOOSE_MODE setzt den Freigabe-Modus:

# ~/.config/goose/config.yaml
extensions:
  buchhaltung:
    type: streamable_http
    name: buchhaltung
    enabled: true
    uri: "https://api.jahresabschluss.io/functions/v1/bookkeeping-mcp"
    headers:
      Authorization: "Bearer jab_live_…"
    env_keys: []
    envs: {}
    timeout: 300

# Freigabe-Modus: Grundeinstellung ist "auto" (ohne Rückfrage)
GOOSE_MODE: "approve"

Unter Windows liegt die Datei unter %APPDATA%\Block\goose\config\config.yaml. Mit available_tools lässt sich die Werkzeugliste einer Erweiterung zusätzlich einschränken. timeout steht in Sekunden.

Werkzeugrechte: auf die Einschätzung von Goose nicht allein verlassen

  • Always Allow für reine Abfragen wie get_saldenliste, list_open_items, list_tax_deadlines oder list_tax_filings.
  • Ask Before für alles Schreibende: create_journal_entry, book_bank_transaction, match_bank_transaction, confirm_receipt, create_outgoing_invoice, record_incoming_invoice_payment.
  • Never Allow für finalize_bookkeeping_period und send_outgoing_invoice – Festschreiben und Rechnungsversand erledigen Sie in der App. Noch sicherer: einen Schlüssel ohne die Rechte finalize und send anlegen; dann bietet unser Server diese Werkzeuge gar nicht an.

Auch im Modus Manual Approval fragt Goose laut Dokumentation nur bei Werkzeugen nach, die es als schreibend einschätzt; diese Einordnung nimmt das Sprachmodell vor und ist ein Bemühen, keine Garantie. Legen Sie deshalb für die Buchhaltung feste Werkzeugrechte an: goose configure → goose settings → Menüpunkt für Werkzeugrechte, oder in der Desktop-App über die Einstellungen neben dem gewählten Modus.

Aufträge an Goose: Fristen im Blick

„Welche Steuerfristen stehen im November an?“

list_tax_deadlines liefert die Fristen eines Jahres wie im Steuerkalender der App, mit Erledigung und Überfälligkeit. list_tax_filings zeigt den Übermittlungsstand der Meldungen.

„Ist die Voranmeldung für Oktober plausibel?“

get_vat_return liest die Kennzahlen als Vorschau; mit Schreibrecht lässt check_tax_filing sie amtlich prüfen, ohne etwas zu übermitteln. Höchstens 30 Prüfungen je Stunde und Schlüssel.

„Bereite die Übermittlung vor und gib mir den Link.“

prepare_tax_filing friert Werte und Prüfwert für 30 Minuten ein und nennt Hindernisse; request_tax_filing_approval liefert einen Freigabe-Link, der 7 Tage gilt. Die App rechnet den Stand neu, und Sie übermitteln dort mit Ihrer PIN.

Grenzen und Recht

  • Ein Recht, mit dem der Agent selbst an ELSTER übermittelt, vergeben wir derzeit nicht. Auch der autonomste Modus von Goose ändert daran nichts – die Grenze setzt der Server.
  • Auch im autonomen Modus kommt Goose nicht an die Bankanbindung, die Einstellungen der Gesellschaft, die Bankverbindungen der Geschäftspartner oder freie Datenbankabfragen – unser Server bietet dafür keine Werkzeuge an.
  • Jede Buchung durchläuft den Buchungskern der App. § 146 Abs. 1 AO verlangt Buchungen einzeln, vollständig, richtig, zeitgerecht und geordnet; nach § 146 Abs. 4 AO darf der ursprüngliche Inhalt nicht unkenntlich werden – Korrekturen laufen deshalb per Storno.
  • Erklärungen geben Sie nach § 150 Abs. 2 AO nach bestem Wissen und Gewissen ab. Diese Bestätigung bleibt beim Menschen, nicht beim Agenten.
  • Ausgaben des Agenten sind Vorschläge; die Software ersetzt keine Steuerberatung. Ihre Kanzlei kann in derselben Software mitarbeiten.

Häufige Fragen

Wie verbinde ich Goose mit meiner Buchhaltung?

Mit goose configure → Add Extension → Remote Extension (Streamable HTTP), der Adresse unseres MCP-Servers und der Kopfzeile Authorization: Bearer jab_live_…. In der Desktop-App geht das über Extensions → Add custom extension mit dem Typ Streamable HTTP.

Warum bucht Goose, ohne zu fragen?

Weil Goose ab Werk im autonomen Modus arbeitet. Stellen Sie mit /mode approve, GOOSE_MODE=approve oder in den Einstellungen „Manual Approval“ ein und legen Sie für schreibende Werkzeuge der Buchhaltung das Recht Ask Before fest.

Reicht der Modus Manual Approval allein?

Nicht ganz: Goose fragt dort nur bei Werkzeugen, die das Sprachmodell als schreibend einstuft. Feste Werkzeugrechte und ein Schlüssel nur mit den nötigen Rechten machen die Grenze verlässlich.

Kann ich mit Goose ein lokales Modell nutzen?

Ja, Goose lässt Sie das Sprachmodell selbst wählen, auch ein lokales. Die Anbindung an die Buchhaltung bleibt gleich; die gelesenen Daten verarbeitet dann Ihr eigenes Modell.

Kann Goose meine Steuern übermitteln?

Nein. Goose kann Fristen lesen, amtlich prüfen lassen, eine Übermittlung vorbereiten und einen Freigabe-Link anfordern. Übermittelt wird in der App mit Ihrer PIN.

Kostet die Anbindung extra?

Goose selbst ist quelloffen und kostenlos. Schlüssel für unseren MCP-Server gibt es ohne Aufpreis zum Buchhaltungs-Abo (Solo oder Gesamtpaket) und zum EÜR-Abo; mit dem kostenlosen Steuer-Modul allein erreichen sie die Steuer-Werkzeuge und die Stammdaten.

Vom selben Anbieter: Jahresabschluss nach HGB – der komplette Leitfaden auf jahresabschluss.io.