Zum Hauptinhalt gehen

MCP-Connector: easybill mit KI-Assistenten verbinden

Aktualisiert

Mit dem easybill MCP-Connector verbindest du dein easybill-Konto mit einem KI-Assistenten wie Claude: Du beschreibst im Chat, was du brauchst, und der Assistent legt es in easybill an – Rechnung, Angebot oder Gutschrift. Technische Grundlage ist MCP (Model Context Protocol), ein offener Standard. Eingerichtet wird der Connector in deinem KI-Assistenten, nicht in easybill.

Direkteinstieg:

Voraussetzungen

  • Ein easybill-Konto im Tarif PROFESSIONAL oder PREMIUM. Der MCP-Connector arbeitet über die easybill REST API, die nur in diesen Tarifen enthalten ist. Darüber hinaus musst du in easybill nichts freischalten.
  • Einer der freigegebenen KI-Assistenten: Claude, ChatGPT oder Raycast

Hinweis zum Tarif: In den Tarifen FREE und STARTER ist der Connector nicht nutzbar. Die Verbindung lässt sich dort zwar einrichten und wird als aktiv angezeigt, jede Anfrage endet aber mit der Fehlermeldung HTTP 426 – „Upgrade to a premium package required.“ Das gilt auch, wenn du von einem höheren Tarif auf STARTER gewechselt hast.

Du brauchst keinen API Key und keine zusätzliche Software.

Freigegebene Assistenten: Der easybill MCP-Connector ist derzeit nur für Claude, ChatGPT und Raycast freigegeben. Andere MCP-fähige Clients werden aktuell nicht unterstützt – auch dann nicht, wenn sich die Adresse dort eintragen lässt.

Ob du eigene Konnektoren hinzufügen kannst, hängt vom Tarif deines KI-Anbieters ab:

  • Claude: In Team- und Enterprise-Tarifen können nur Owner eigene Konnektoren anlegen. Alle anderen klicken danach beim Konnektor auf Verbinden. Fehlt dir die Schaltfläche zum Hinzufügen, wende dich an den Owner eures Claude-Accounts.
  • ChatGPT: Nur in Business und Enterprise/Edu. Dort legt ein Admin den Connector im Browser unter Plugins → Add custom MCP server an. Pro kann nur lesen, Plus weder lesen noch schreiben.

Mit einem Steuerberater-Zugang funktioniert der Connector nicht.

MCP-Connector einrichten (einmalig, ca. 1 Minute)

Die Einrichtung findet in deinem KI-Assistenten statt. Am Beispiel von Claude:

  1. Öffne die Einstellungen und gehe zu den Konnektoren:

    Einstellungen > Konnektoren
  2. Klicke auf Hinzufügen.

  3. Trage als Adresse ein:

    https://mcp.easybill.com/mcp
  4. Es öffnet sich das easybill-Anmeldefenster. Melde dich mit deinem gewohnten easybill-Login an.
  5. Bestätige, dass der Assistent auf dein Konto zugreifen darf.
  6. Aktiviere im Chat den easybill-Konnektor.
  7. Fertig – der easybill-Konnektor ist aktiv. Die Verbindung bleibt bestehen, du musst dich nicht jedes Mal neu anmelden.

Wichtig: Die Adresse muss den Zusatz /mcp enthalten. Die Domain allein ist kein MCP-Endpunkt.

Die Adresse ist für alle freigegebenen Assistenten dieselbe. Nutzt du ChatGPT oder Raycast statt Claude, trage sie dort ebenso ein. Wie und wo Konnektoren hinzugefügt werden, entscheidet der jeweilige Anbieter.

Was du mit dem MCP-Connector machen kannst

  • Dokumente erstellen aus formloser Beschreibung: Rechnung, Angebot, Auftrag, Gutschrift – auf Wunsch direkt als E-Rechnung (XRechnung oder ZUGFeRD). Beispiel: „Erstell eine Rechnung für die Muster GmbH – 8 Stunden Beratung à 150 € netto."
  • Vom Angebot zur Zahlung: Angebot in eine Rechnung umwandeln, festschreiben, versenden (E-Mail oder Briefpost), Zahlungserinnerung oder Mahnung auslösen.
  • Zahlungen erfassen: „RE-1042 ist bezahlt."
  • Auskunft ohne Klickpfad (rein lesend): offene Posten, „Wer hat noch nicht bezahlt?", Umsatz je Kunde.
  • Stammdaten und Zeiten: Kunden, Artikel und Projekte anlegen oder pflegen, Dubletten finden, erfasste Zeiten zu einem Rechnungsentwurf zusammenfassen.

Cheat Sheet: Prompts, die funktionieren (PDF)

Im Cheat Sheet findest du Prompts zum Kopieren für die häufigsten Aufgaben – von der Rechnung aus einem Satz über E-Rechnung, Zahlungen und offene Posten bis zu Projekten, Mahnungen und wiederkehrenden Rechnungen. Zu jedem Abschnitt steht dabei, was passiert und worauf du achten solltest.

Cheat Sheet herunterladen (PDF, 10 Seiten)

Drei Regeln machen jeden Prompt besser:

  1. Nenn den Kunden exakt – am sichersten mit Kundennummer („Kunde 10042"). Die Suche findet nur genaue Treffer.
  2. Gib alle Zahlen an: Menge, Einzelpreis, netto oder brutto, Steuersatz.
  3. Sag, wie weit es gehen soll: Ohne Ansage bleibt ein Dokument ein Entwurf. Willst du mehr, sag z. B. „stell die Rechnung fertig und schick sie per E-Mail".

Sicherheit: Entwurf zuerst, Freigabe durch dich

Der Assistent arbeitet über die offizielle easybill-API in deinem eigenen Konto: gleiche Daten, gleiche Rechte, gleicher Login. Ein Datenexport an Dritte ist nicht nötig.

  • Dokumente entstehen immer zuerst als Entwurf. Festgeschrieben wird erst, wenn du ausdrücklich zustimmst – erst dann vergibt easybill die Nummer aus deinem Nummernkreis und das Dokument ist unveränderbar. Die GoBD-Logik liegt in easybill, nicht in der KI.
  • Rechnungsnummern, Steuerberechnung und E-Rechnungsformate kommen von easybill, nicht von der KI.
  • Auch der Versand und das Buchen von Zahlungen passieren nur nach deiner Bestätigung. Stell diese Aktionen in deinem KI-Assistenten deshalb nicht auf Immer erlauben.
  • Löschen läuft immer in zwei Schritten: erst Vorschau, dann Bestätigung.
  • Der Zugriff ist jederzeit widerrufbar: Lösche den Konnektor in den Einstellungen deines KI-Assistenten, dann endet der Zugriff.

Was der Connector nicht abdeckt

  • Tarife FREE und STARTER: Der Connector nutzt die REST API und funktioniert daher nur in den Tarifen PROFESSIONAL und PREMIUM.
  • Der Connector ist bislang nur für Claude, ChatGPT und Raycast freigegeben. Weitere MCP-fähige Clients sind aktuell nicht unterstützt.
  • Der Connector deckt die Ausgangsseite ab. Eingangsrechnungen einlesen, Bankabgleich und DATEV-Export laufen nicht über den MCP-Connector.
  • E-Rechnungen verschickst du über den Connector nur per E-Mail.
  • PDF oder Vorschaubild im Chat gibt es aktuell nicht. Der Assistent nennt dir Nummer und Summen, das PDF öffnest du in easybill.
  • Dateien anhängen: Über den Connector kannst du keine Dateien hochladen oder an Dokumente hängen.
  • Steuerberater-Zugänge werden nicht unterstützt.
  • Unscharfe Suche: easybill filtert exakt. Nenn Kunden deshalb mit vollständigem Namen oder Kundennummer.
  • Wie sauber deine Anweisungen umgesetzt werden, hängt auch vom eingesetzten KI-Assistenten ab. Prüfe Entwürfe daher vor dem Festschreiben.

Verbindung prüfen oder trennen

Die Verbindung verwaltest du in deinem KI-Assistenten:

Einstellungen > Konnektoren

Dort kannst du den easybill-Konnektor deaktivieren oder löschen. Funktioniert die Anmeldung nicht, melde dich zunächst unter app.easybill.de in easybill an und starte die Verbindung anschließend erneut.

Wenn die Verbindung nicht klappt

  • Fehlermeldung HTTP 426 „Upgrade to a premium package required.“ Dein easybill-Konto ist im Tarif FREE oder STARTER. Diese Tarife enthalten keinen Zugriff auf die REST API, über die der Connector arbeitet. Nach einem Wechsel auf PROFESSIONAL oder PREMIUM funktioniert der Connector.
  • Meldung „Der Server konnte nicht überprüft werden." Die Adresse wurde ohne den Zusatz /mcp eingetragen. Die Domain allein ist kein MCP-Endpunkt, die Anmeldung kann dann nicht automatisch gefunden werden.
  • Adresse lässt sich nicht korrigieren. Die Adresse eines bestehenden Konnektors ist nachträglich nicht bearbeitbar. Entferne den Konnektor und lege ihn neu mit https://mcp.easybill.com/mcp an.
  • Verbindung klappt in einem anderen Programm nicht. Freigegeben sind derzeit nur Claude, ChatGPT und Raycast. In anderen MCP-Clients ist der Connector noch nicht nutzbar.
  • Keine Schaltfläche zum Hinzufügen. Du nutzt Claude in einem Team- oder Enterprise-Tarif ohne Owner-Rechte – dann legt der Owner eures Accounts den Konnektor an. Bei ChatGPT prüfe, ob du einen bezahlten Tarif nutzt und der Developer Mode aktiv ist.
  • Anmeldung schlägt fehl. Mit einem Steuerberater-Zugang funktioniert der Connector nicht. Melde dich mit einem regulären easybill-Zugang an.

Weiterführende Artikel

Mehr über die Funktion: easybill.de/funktionen/mcp-connector