Buchhaltung mit Raycast: MCP-Server in Raycast AI einrichten

Was Raycast für die Buchhaltung mitbringt

Schritt 1: Schlüssel anlegen

• In der App unter Buchhaltung → Einstellungen → „KI-Agent & API“. Administratoren und der Ersteller des Arbeitsbereichs legen den Schlüssel an und bestätigen mit dem zweiten Faktor.
• Für Raycast reicht oft read: Raycast ist für schnelle Fragen gemacht. Ein Leseschlüssel bekommt von unserem Server nur lesende Werkzeuge angezeigt.
• Die App bietet 30 Tage, 90 Tage oder ein Jahr. Einen reinen Leseschlüssel für schnelle Fragen können Sie länger laufen lassen, einen Schreibschlüssel halten Sie kurz. Der Schlüssel jab_live_… erscheint nur einmal und öffnet genau eine Gesellschaft.
• Ein Einsetzen aus Umgebungsvariablen beschreibt Raycast für HTTP-Kopfzeilen nicht; Sie tragen den Schlüssel direkt in das Formular ein. MCP-Server gehören zu den Bereichen, die Raycast per Cloud Sync abgleicht – ob dabei auch Kopfzeilen übertragen werden, sagt das Handbuch nicht. Prüfen Sie Ihre Sync-Einstellungen, wenn Raycast auf mehreren Geräten läuft.

Schritt 2: den Server in Raycast eintragen

Suchen Sie den Befehl „Install MCP Server“ oder nutzen Sie in „Manage MCP Servers“ die Aktion „Install New Server“, und füllen Sie das Formular so aus:

Raycast → Befehl „Install MCP Server“

Name:          Buchhaltung
Transport:     HTTP
URL:           https://api.jahresabschluss.io/functions/v1/bookkeeping-mcp
HTTP Headers:  Authorization = Bearer jab_live_…
Custom Instructions:
  Beträge in Euro, Datumsangaben als TT.MM.JJJJ. Vor jedem Aufruf,
  der bucht oder etwas anlegt, den Buchungssatz nennen und warten.

Speichern mit ⌘ ↵ (Mac) bzw. Ctrl ↵ (Windows)

OAuth brauchen Sie nicht: Unser Server meldet sich über die Kopfzeile an und bietet OAuth derzeit nicht an. Raycast speichert, verbindet und lädt die Werkzeugliste. In „Manage MCP Servers“ sehen Sie den Status (Running, Stopped oder Error) und die Werkzeuge. Steht dort Error mit 401, ist der Schlüssel falsch eingetragen, abgelaufen oder widerrufen.

Das Feld Custom Instructions liest Raycast AI jedes Mal, wenn es die Werkzeuge des Servers in Betracht zieht. Es ersetzt keine Freigabe, hilft aber, Antworten im gewohnten Format zu bekommen.

Schritt 3: Berechtigung auf „Ask“ stellen

• In den Einstellungen unter AI steht die Wahl „Permissions“ mit drei Stufen. Ask fragt bei allem, was nicht lesend ist oder per Regel erlaubt wurde. Auto – laut Handbuch die Grundeinstellung in bezahlten Tarifen – gibt zusätzlich Routineaktionen von selbst frei. Always Allow führt alles ohne Rückfrage aus.
• Für die Buchhaltung empfehlen wir Ask. Unser Server kennzeichnet seine Abfragen als lesend; sie laufen dann ohne Rückfrage, jede Buchung legt Raycast Ihnen vor.
• Wer Auto behalten will, legt unter „Auto-review Rules“ eine Regel an, die bei Buchungen, Stornos, Zahlungen und Rechnungen „Ask first“ verlangt. Bei widersprüchlichen Regeln gewinnt laut Handbuch „Ask first“.
• „Always allow“ auf einer Freigabekarte setzt das Werkzeug auf die globale Liste erlaubter Werkzeuge – für alle Chats. Verwenden Sie das nur für lesende Werkzeuge; die Liste lässt sich in den Einstellungen wieder leeren.

Buchhaltung per @-Erwähnung und Tastenkürzel

Auf Mac und Windows legt Raycast für jeden Server einen Befehl „Ask …“ in der Suche an, hier also „Ask Buchhaltung“, der Quick AI mit der Erwähnung vorbelegt. Wie jedem Befehl geben Sie ihm im Aktionsmenü (⌘ K bzw. Ctrl K) ein Tastenkürzel. Typische Fragen:

Grenzen: wofür Raycast nicht gedacht ist

• Lange Abläufe mit vielen Buchungen erledigen Sie besser in einem Agenten mit Sitzung und Verlauf, etwa Claude Code oder Codex, oder direkt in der App. Raycast ist stark bei kurzen Fragen.
• Übermittlungen an ELSTER laufen über die App: Der Agent kann amtlich prüfen (check_tax_filing) und einen Freigabe-Link anfordern (request_tax_filing_approval); Sie übermitteln mit Ihrer PIN.
• Raycast ist für Fragen gemacht, nicht für Einstellungen: Bankanbindung, Einstellungen der Gesellschaft und Bankverbindungen der Geschäftspartner pflegen Sie in der App; freie Datenbankabfragen gibt es über die Anbindung nicht.
• Gebucht wird – mit Schreibschlüssel – über den Buchungskern der App. § 146 Abs. 4 AO und § 239 Abs. 3 HGB verlangen, dass der ursprüngliche Inhalt einer Buchung feststellbar bleibt; deshalb gibt es Storno statt Löschen.
• Antworten der KI sind Vorschläge; die Software ersetzt keine Steuerberatung.

Häufige Fragen

Brauche ich Raycast Pro für die Buchhaltung?

Ja. MCP-Server sind laut Raycast-Handbuch Pro vorbehalten. Die Anbindung an unseren Server selbst kostet nichts extra; Schlüssel gibt es ohne Aufpreis zum Buchhaltungs- oder EÜR-Abo.

Kann Raycast den Schlüssel als Kopfzeile senden?

Ja. Beim Transport HTTP tragen Sie im Feld „HTTP Headers“ Authorization mit dem Wert Bearer jab_live_… ein. Raycast sendet das Paar mit jeder Anfrage.

Funktioniert das auch auf dem iPhone?

Ja. Auf iOS ist HTTP der einzige Transport. Sie richten den Server unter Konto-Symbol → AI → MCP Servers mit URL und HTTP Headers ein.

Fragt Raycast, bevor es bucht?

Mit der Berechtigung Ask ja: Raycast führt lesende Werkzeuge selbst aus und fragt bei allem anderen. In der Grundeinstellung Auto gibt Raycast zusätzlich Routineaktionen frei; stellen Sie für die Buchhaltung Ask ein oder legen Sie eine Regel mit „Ask first“ an.

Wie frage ich die Saldenliste per Tastenkürzel ab?

Geben Sie dem Befehl „Ask Buchhaltung“ im Aktionsmenü ein Tastenkürzel. Er öffnet Quick AI mit der Erwähnung des Servers; Sie schreiben nur noch die Frage, etwa nach der Saldenliste bis heute.

Kann Raycast meine Umsatzsteuer-Voranmeldung abgeben?

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