← Zurueck zur Startseite
MCP-Server live · OpenAPI-Spec live

Integrationen

Nutze SteuerOnline direkt in Claude.ai oder ChatGPT.

Kein Account noetig · anonyme Sessions · PII bleibt serverseitig anonymisiert

MCP-Connector-URL (Claude.ai)

https://ki.steuer-online.de/api/v1/mcp

OpenAPI-Spec (ChatGPT-GPT-Action)

https://ki.steuer-online.de/api/openapi.json

Claude.ai-Connector hinzufuegen

Verbinde SteuerOnline als Custom-Connector in Claude — Tools tauchen automatisch in der Tool-Liste auf.

1

Oeffne Claude.ai und logge dich ein.

2

Klicke unten links auf deinen Avatar → "Settings" → "Connectors".

3

Klicke "Add custom connector" (Schaltflaeche oben rechts).

4

Trage als Name ein: SteuerOnline und als URL: https://ki.steuer-online.de/api/v1/mcp

5

Auth: "None" auswaehlen (Phase 1 ist anonym, OAuth folgt in Phase 3).

6

Auf "Save" klicken. Der Connector erscheint mit 4 Tools in deiner Tool-Liste.

7

In einem neuen Chat oben rechts den Tools-Toggle aktivieren und SteuerOnline anhaken. Sage Claude dann z.B.: „Hilf mir bei meiner Einkommensteuererklaerung 2025 ueber den SteuerOnline-Connector. Ich bin Lehrer und wohne in Saarbruecken.“

Tipp: Wenn du den Browser oder Tab schliesst, geht die Steuer-Session verloren. In Phase 3 (OAuth) wird das persistent — solange merkt sich Claude die Session nur fuer den laufenden Chat.

ChatGPT-Custom-GPT mit SteuerOnline-Action

ChatGPT (GPT-Plus / Team / Enterprise) kann unsere OpenAPI-Spec direkt als Action verwenden. Drei Wege — der einfachste zuerst.

Variante A — Eigener Custom-GPT (5 Minuten)

1

Oeffne ChatGPT und klicke auf "Explore GPTs" (linke Seitenleiste).

2

Oben rechts auf "Create" klicken.

3

Im Tab "Configure" einen Namen geben (z.B. "SteuerOnline-Helfer"), Beschreibung und Profilbild.

4

Im Bereich „Actions“ auf „Create new action“ klicken.

5

Authentication: „None“ lassen.
Bei Schema auf „Import from URL“ klicken und unsere OpenAPI-Spec eintragen: https://ki.steuer-online.de/api/openapi.json

6

Bei Privacy Policy eintragen: https://ki.steuer-online.de/datenschutz

7

Im "Instructions"-Feld dem GPT erklaeren, was er tun soll — Vorlage unten.

8

Oben rechts „Save“ „Only me“ (privat testen) oder „Anyone with link“ (teilen) oder „Public“ (in den GPT Store).

Empfohlene Instructions-Vorlage (klicken zum Aufklappen)
Du bist ein Helfer fuer die deutsche Einkommensteuererklaerung 2025.
Nutze die SteuerOnline-Action, um:
  1. Mit start_tax_session eine Session anzulegen
  2. Mit chat das Interview Schritt fuer Schritt zu fuehren
  3. Mit get_tax_data_snapshot regelmaessig den Stand zu pruefen
  4. Mit get_session_status den User auf den PDF-Bericht hinzuweisen,
     sobald die Berechnung bereit ist.

Antworte immer auf Deutsch, freundlich und ohne Fachjargon.

WICHTIG: Du gibst KEINE Steuerberatung im Sinne des StBerG.
Bei Selbststaendigen-Einkuenften, Auslandseinkuenften oder Renten
verweise auf einen Steuerberater oder Lohnsteuerhilfeverein.

Variante B — Bei einer einmaligen Frage

Du kannst ChatGPT auch ohne Custom-GPT nutzen: schicke einfach unsere OpenAPI-URL in einer Nachricht und sage: „Nutze die OpenAPI-Spec unter https://ki.steuer-online.de/api/openapi.json und lege eine Steuer-Session fuer mich an.“ ChatGPT-Pro mit Web-Search holt sich die Spec und ruft die Endpunkte ab. Kein Setup, dafuer pro Konversation neu.

Variante C — Im offiziellen GPT Store

Wir arbeiten an einem offiziellen Eintrag im OpenAI GPT Store (Status: in Vorbereitung). Sobald freigeschaltet, kannst du „SteuerOnline“ im GPT Store suchen und mit einem Klick hinzufuegen — kein eigenes Setup mehr noetig.

Verfuegbare Tools

Diese vier Aktionen kann das LLM ueber deine Verbindung ausfuehren. Phase 2 erweitert um 8 weitere Tools + Resources + Prompts.

start_tax_session(tax_year, language, profession?)Legt eine neue Steuer-Session an, gibt session_id zurueck.
chat(session_id, message)Sendet eine Nachricht im Interview, liefert Antwort + neu erfasste Felder.
get_tax_data_snapshot(session_id)Aktueller Stand der erfassten Steuerfelder + Vollstaendigkeitsgrad.
get_session_status(session_id)Fortschritt, naechste Schritte, Link zum PDF-Bericht.

Haeufige Fragen

Datenschutz, Auth und was passiert wenn...

Sieht Claude / ChatGPT meine echten Steuerdaten?
Ja — die Sprachmodelle sehen deine Eingaben so wie sie in Claude oder ChatGPT eingegeben werden. Aber: Sobald unser Server die Daten weiterverarbeitet, anonymisieren wir alle personenbezogenen Angaben (Namen, Adressen, IBANs etc.) bevor sie an unser eigenes Backend-LLM (AWS Bedrock, EU) gehen. Die Klarnamen verlassen nie den deutschen Server. Details unter Datenschutz.
Brauche ich einen ChatGPT-Plus oder Claude-Pro-Account?
Fuer Custom-GPTs in ChatGPT brauchst du mindestens einen ChatGPT-Plus-Account (20€/Monat). Fuer Claude.ai-Custom-Connectors brauchst du Claude-Pro (18€/Monat) oder Team. Kostenlose Tarife haben diese Funktionen aktuell nicht.
Geht meine Session verloren, wenn ich den Chat schliesse?
Ja, aktuell schon. In Phase 1 sind die Sessions anonym und an die laufende Konversation gebunden. Du kannst dir am Ende den PDF-Bericht herunterladen oder die session_id notieren — dann kannst du im naechsten Chat fortfahren, indem du sie an die KI weitergibst. Phase 3 wird das mit OAuth-basierten Konten persistent machen.
Welche Tarife gelten ueber MCP / GPT Action?
Die gleichen wie im Web-Chat: Erfassung und Berechnung sind kostenlos. Das Premium-Bundle (PDF-Bericht, Optimierungs-Tipps, Export und ELSTER-Abgabe) kostet einmalig 14,99€ (Startangebot bis 31.12.2026, danach 19,99€) pro Steuerjahr. Die Bezahlung laeuft ueber die Web-UI. Die ELSTER-Abgabe aus dem MCP-Chat heraus erfordert zusaetzlich ein 5-Minuten-Consent-Token von /elster?session=...
Was passiert bei Fehlern oder Rate-Limits?
Pro Session sind 10 Chat-Aufrufe pro Minute erlaubt (gleich wie im Web-Chat). Bei Ueberschreitung antwortet der Server mit 429 Too Many Requests. Generelle API-Calls sind auf 30 pro Minute begrenzt.
Wann kommt OAuth-Login (Phase 3)?
Wir warten erst Nutzungs-Daten ab, ob persistente Konten via Claude/ChatGPT wirklich gebraucht werden. Bei genug Bedarf: etwa 3 Werktage Implementierung + ca. 1-3 Wochen Anthropic-Marktplatz-Review fuer das offizielle Listing.