Buchhaltung mit JetBrains-KI: Junie und AI Assistant per MCP-Server

Drei Orte, an denen Junie MCP-Server findet

JetBrains bietet Junie inzwischen an mehreren Stellen an, und jede liest ihre MCP-Server woanders. Die Einstellungen und Dateien laut JetBrains-Dokumentation, Stand Oktober 2026:

AI Assistant (auch für Junie im AI Chat):
  Settings | Tools | AI Assistant | Model Context Protocol (MCP)
Weitergabe an Junie im AI Chat:
  Settings | Tools | AI Assistant | Agents → „Pass custom MCP servers“
Junie-Plugin:
  Settings | Tools | Junie | MCP Settings  → ~/.junie/mcp/mcp.json
Junie CLI:
  ~/.junie/mcp/mcp.json (Benutzer), .junie/mcp/mcp.json (Projekt), Befehl /mcp
Nicht verwechseln (Entwicklungsumgebung als Server für andere Programme):
  Settings | Tools | MCP Server

Schritt 1: Schlüssel anlegen

• Buchhaltung → Einstellungen → „KI-Agent & API“; anlegen dürfen Administratoren und der Ersteller des Arbeitsbereichs, bestätigt mit dem zweiten Faktor.
• Beginnen Sie mit read. Für den eigenen Chat des AI Assistant beschreibt JetBrains keine Freigabe-Regeln für MCP-Werkzeuge; mit einem Leseschlüssel bietet unser Server dort gar keine schreibenden Werkzeuge an.
• Laufzeit 30 Tage, 90 Tage oder ein Jahr; läuft er ab, tauschen Sie bei Weg B nur eine Zeile in der Kopfzeilen-Datei. Der Schlüssel beginnt mit jab_live_ und öffnet genau eine Gesellschaft.
• Ein Einsetzen von Umgebungsvariablen in MCP-Kopfzeilen dokumentiert JetBrains für keinen der Wege. Der Schlüssel steht also im Klartext in einer Datei – nie in einer Projektdatei, die ins Repository geht.

Weg A: Junie CLI mit url und headers

Die Junie-CLI-Dokumentation zeigt entfernte Server mit url und headers. Für die Buchhaltung tragen Sie in ~/.junie/mcp/mcp.json ein:

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

Die Benutzerdatei ist der richtige Ort, weil der Schlüssel zu Ihnen und einer Gesellschaft gehört. .junie/mcp/mcp.json im Projekt würde ihn mit dem Repository teilen. Kommt keine Verbindung zustande, nehmen Sie Weg B – die Brücke funktioniert auch für die Junie CLI.

Weg B: AI Assistant (und Junie im AI Chat) über mcp-remote

Der AI Assistant kennt im Dialog „New MCP Server“ die Reiter STDIO und HTTP. Kopfzeilen beschreibt JetBrains für HTTP nicht; im Fehlerverfolgungssystem von JetBrains berichten Nutzer zudem von Abbrüchen bei Servern, die – wie unserer – keinen Ereignisstrom per GET anbieten. Verlässlich ist der Reiter STDIO mit der Brücke mcp-remote, die laut ihrer Dokumentation Kopfzeilen auch aus einer Datei liest:

{
  "mcpServers": {
    "buchhaltung": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.jahresabschluss.io/functions/v1/bookkeeping-mcp",
        "--header-file",
        "/Users/ihr-name/.config/jab/buchhaltung-kopfzeilen.txt"
      ]
    }
  }
}

Öffnen Sie die MCP-Einstellungen des AI Assistant (Pfad oben), klicken Sie „Add“, wählen Sie STDIO, fügen Sie den Eintrag ein und legen Sie unter Server level fest, ob er global oder nur im Projekt gilt. Nach „Apply“ zeigt die Spalte Status, ob die Verbindung steht; über das Symbol dort sehen Sie die Werkzeuge. Für npx muss Node.js installiert sein.

Die Datei mit der Kopfzeile

--header-file liest eine Kopfzeile je Zeile. Laut mcp-remote hält das den Schlüssel aus der Prozessliste heraus, in der andere Nutzer des Rechners Befehlsargumente lesen könnten:

# /Users/ihr-name/.config/jab/buchhaltung-kopfzeilen.txt
# eine Kopfzeile je Zeile, Zeilen mit # sind Kommentare
Authorization: Bearer jab_live_…

Legen Sie die Datei außerhalb jedes Projekts ab und machen Sie sie nur für Ihr Benutzerkonto lesbar. Eine Datei, die mcp-remote nicht lesen kann, gilt laut Dokumentation als Fehler – die Anfrage geht dann nicht ohne Anmeldung hinaus. Läuft der Schlüssel ab, tauschen Sie nur diese eine Zeile.

Freigaben: Safe statt Brave

• Junie im AI Chat fragt mit Ja, Nein und „Always allow“. Wählen Sie im Modus-Wähler Safe, nicht Auto oder Brave, und erlauben Sie dauerhaft höchstens lesende Werkzeuge wie get_saldenliste oder list_fixed_assets.
• Im Junie-Plugin fragt Junie ab Werk vor MCP-Werkzeugen. Eine Regel vom Typ MCP in der Action Allowlist erlaubt laut Dokumentation alle MCP-Werkzeuge ohne Rückfrage – einzelne Server oder Werkzeuge lassen sich dort noch nicht auswählen. Legen Sie diese Regel für die Buchhaltung deshalb nicht an und lassen Sie Brave Mode aus.
• In der Junie CLI stehen Regeln in ~/.junie/allowlist.json unter mcpTools, je Server mit allow oder ask; die Grundeinstellung ist ask. /brave schaltet die Rückfragen ab – nicht mit einem Schreibschlüssel.
• Nicht verwechseln: Mit der Einstellung „MCP Server“ (Pfad oben) macht sich die Entwicklungsumgebung selbst zum MCP-Server für andere Programme. Das hat mit der Anbindung der Buchhaltung nichts zu tun.

Aufträge in der Entwicklungsumgebung: Anlagen und Abschluss

Grenzen und Recht

• Steuern: amtlich prüfen (check_tax_filing), vorbereiten (prepare_tax_filing), Freigabe-Link anfordern (request_tax_filing_approval). Übermittelt wird in der App mit Ihrer PIN.
• Auch aus der Entwicklungsumgebung nicht erreichbar: Bankanbindung, Einstellungen der Gesellschaft, Bankverbindungen der Geschäftspartner und freie Datenbankabfragen – Code, den Junie schreibt, nutzt dieselben dokumentierten Routen.
• Jede Buchung, auch ein AfA-Lauf, durchläuft den Buchungskern der App. Nach § 146 Abs. 4 AO und § 239 Abs. 3 HGB muss der ursprüngliche Inhalt feststellbar bleiben – Korrekturen sind Stornos.
• Die Daten, die der Agent liest, verarbeitet das Sprachmodell, das Sie in der Entwicklungsumgebung eingestellt haben. Prüfen Sie dessen Datenschutzbedingungen, bevor Sie Kundendaten abfragen.
• Vorschläge der KI prüfen Sie selbst oder mit Ihrer Steuerberatung, die in derselben Software arbeiten kann.

Häufige Fragen

Kann Junie meine Buchhaltung direkt per MCP anbinden?

Die Junie CLI ja: Ihre Dokumentation zeigt entfernte Server mit url und headers in ~/.junie/mcp/mcp.json. Für das Junie-Plugin nennt die Dokumentation derzeit keine Token in der MCP-Konfiguration; dort und im AI Assistant nutzen Sie die Brücke mcp-remote.

Warum über mcp-remote statt direkt per HTTP im AI Assistant?

Weil JetBrains für den HTTP-Reiter keine Kopfzeilen beschreibt und Nutzer von Abbrüchen bei Servern ohne GET-Ereignisstrom berichten. mcp-remote läuft als lokaler Befehl, sendet die Kopfzeile aus einer Datei und spricht unseren Server über Streamable HTTP an.

Brauche ich dafür Node.js?

Für den Weg über mcp-remote ja, denn die Brücke wird mit npx gestartet. Für die Junie CLI mit url und headers nicht.

Fragt Junie, bevor es bucht?

Im Modus Safe und ohne MCP-Regel in der Action Allowlist ja. Brave Mode und eine MCP-Regel würden alle MCP-Werkzeuge ohne Rückfrage erlauben – für die Buchhaltung nicht empfehlenswert.

Ist das dasselbe wie der MCP-Server der Entwicklungsumgebung?

Nein. Mit der Einstellung „MCP Server“ stellt die Entwicklungsumgebung eigene Werkzeuge für andere Programme bereit. Hier geht es um die umgekehrte Richtung: Die KI in der Entwicklungsumgebung nutzt unseren Server.

Kann Junie meine Steuern übermitteln?

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