Fakturia — Feature im Detail

MCP-Server:
Abrechnung per KI. Vibe Coding.

Sagen Sie Ihrem KI-Agenten, was er tun soll – Fakturia erledigt die Abrechnung. 123 Tools für Claude Code und andere KI-Agenten. Open Source.

123 MCP-Tools verfügbar
14 API-Domänen abgedeckt
MIT Open-Source-Lizenz
Claude Code — Fakturia MCP aktiv
fakturia-mcp v1.0.4
Du
Entwickler Leg einen neuen Kunden „Muster GmbH“ an, starte den Business-Pro-Tarif ab dem 1. Juli und schick mir die Rechnungs-ID.
🤖
Claude Code • Fakturia MCP
TOOL customers_create → { firma: "Muster GmbH", land: "DE" }
TOOL contracts_create → { kunden_id: "KD-00042", tarif: "BUSINESS-PRO", start: "2026-07-01" }
TOOL invoices_list → filter: kunden_id = "KD-00042"
Erledigt! Kunde „Muster GmbH“ wurde angelegt (KD-00042), der Business-Pro-Vertrag startet am 01.07.2026 – die erste Rechnung hat die ID RE-2026-0701. Soll ich die Rechnung direkt per E-Mail versenden?
Du
Entwickler Ja, und zeig mir danach den Zahlungsstatus.
🤖
Claude Code • Fakturia MCP
TOOL invoices_send → { invoice_id: "RE-2026-0701" }
TOOL invoices_get → { invoice_id: "RE-2026-0701" }
Rechnung RE-2026-0701 wurde erfolgreich versandt. Aktueller Zahlungsstatus: ● Offen — 149,00 € fällig am 15.07.2026. Soll ich eine Zahlungserinnerung vorplanen?

Moderne Softwareentwicklung verändert sich: Statt manuelle API-Calls zu schreiben, beschreiben Entwickler ihre Absicht in natürlicher Sprache – und der KI-Agent führt sie aus. Dieses Konzept nennt sich Vibe Coding. Was bisher vor allem fürs Schreiben von Code galt, gilt jetzt auch für komplexe Geschäftsprozesse wie Subscription Management.

Der Fakturia MCP-Server bringt diese Fähigkeit direkt in Ihre Abrechnungsplattform. Er stellt KI-Agenten wie Claude Code genau 123 Tools bereit, die alle Endpunkte der Fakturia-REST-API abdecken – von Kunden und Verträgen über Rechnungen bis zu Berichten und Webhooks. Ein Entwickler muss keine API-Dokumentation lesen: Er schreibt, was er will, und Claude erledigt den Rest.

🔗 Open Source MIT-Lizenz, GitHub
🤖 Claude Code ready + alle MCP-Clients
🇩🇪 Entwickelt in Deutschland TÜV-RZ Nürnberg, DSGVO
🆕 npx-Installation Kein Build-Schritt nötig

123 Tools – 14 API-Domänen

Jede Fakturia-Ressource ist per MCP-Tool ansteuerbar – lesen, schreiben, löschen.

Customers 14 Tools Anlegen, suchen, SEPA-Mandate, Zusatzfelder
Contracts 32 Tools Lebenszyklus, Upgrade, Kündigung, Rabatte
Invoices 10 Tools Liste, PDF-Download, bezahlen, stornieren
Subscriptions 9 Tools Positionen, Preise, Preisberechnung
Items 9 Tools Artikel, Preise, Kategorien verwalten
Reports 7 Tools MRR, Kunden-, Vertrags-, Rechnungsreports
Discounts 6 Tools Rabatte, Coupons erstellen & einlösen
+ 6 weitere 36 Tools Orders, Accounts, Credit Notes, Webhooks, User Logins, Activities

Vibe Coding in der Praxis

Was Entwickler dem KI-Agenten sagen – und was Fakturia automatisch ausführt.

📝
„Zeig mir alle Kunden, die seit über 30 Tagen eine offene Rechnung haben.“ 3 Toolsinvoices_list + customers_get + Filterung – Ergebnis sofort als Tabelle
↑
„Wechsle Kunde KD-00099 von Basic auf Pro – proratiert ab heute.“ 2 Toolscontracts_upgrade + invoices_create – Korrekturrechnung sofort versandt
📈
„Erstelle einen MRR-Report für Q2 2026 und speichere ihn als CSV.“ 2 Toolsreports_mrr + Export-Download – direkt als Datei verfügbar
🔋
„Richte einen Webhook ein, der mein System bei jeder neuen Rechnung benachrichtigt.“ 1 Toolwebhooks_create – sofort aktiv, kein Backoffice-Login nötig
👤
„Erstelle 50 Test-Kunden mit Verträgen für unseren Loadtest.“ SandboxMassendaten in der Sandbox – kein Risiko für Produktivumgebung

In 3 Minuten startklar

Der Fakturia MCP-Server braucht keinen Build-Schritt – einfach konfigurieren und loslegen.

1
API-Key in Fakturia-Backoffice generieren Im Fakturia-Backoffice unter Projekteinstellungen → API-Schnittstelle konfigurieren → API aktivieren → Key generieren. Für Tests den Sandbox-Key verwenden.
2
MCP-Konfiguration anlegen In der Datei .mcp.json im Projekt oder global unter ~/.claude/.mcp.json folgende Konfiguration eintragen:
.mcp.json  —  MCP-Server-Konfiguration
JSON
{ "mcpServers": { "fakturia": { "command": "npx", "args": ["-y", "@edjufy/fakturia-mcp"], "env": { "FAKTURIA_API_HOST": "https://api.sandbox.fakturia.de", // Sandbox "FAKTURIA_API_KEY": "<Ihr-API-Key>" } } } }
3
Claude Code starten – fertig Claude Code lädt den MCP-Server automatisch. Ab sofort stehen alle 123 Fakturia-Tools zur Verfügung. Für Produktion FAKTURIA_API_HOST auf https://api.fakturia.de ändern.

Was den Fakturia MCP-Server auszeichnet

Mehr als nur ein API-Wrapper – designed für den produktiven Einsatz.

📄 Vollständige Tool-Beschreibungen Jedes der 123 Tools enthält detaillierte Beschreibungen aller Parameter – der KI-Agent weiß genau, welches Tool er für welchen Zweck nutzen soll, ohne manuelle Konfiguration.
🆕 Null-Installation via npx Kein npm install, kein Build. Der Server startet direkt per npx -y @edjufy/fakturia-mcp. Node.js 24+ ist einzige Voraussetzung.
🔒 Sandbox & Produktion getrennt Ein Umgebungsvariablen-Wechsel trennt Sandbox von Produktion. Entwickler können alle Tools gefahrlos gegen die Sandbox testen, bevor sie auf Live-Daten zugreifen.
🔗 OpenAPI-basiert & aktuell Der MCP-Server generiert seine Tools aus der offiziellen Fakturia-OpenAPI-Spezifikation. Updates der API werden direkt in neue Server-Versionen übernommen.

⚠  Sicherheitshinweis für den Produktiveinsatz

Der Fakturia MCP-Server kann bei entsprechender Konfiguration schreibende Operationen ausführen – Verträge kündigen, Rechnungen bezahlen, Kunden löschen. Im Produktiveinsatz empfehlen wir einen API-Key mit eingeschränkten Rechten (z. B. nur Lesezugriff), sofern keine Schreiboperationen per KI gewünscht sind.

Zusätzlich lässt sich in den Fakturia-Projekteinstellungen ein IP-Whitelist für den API-Key konfigurieren. Für Entwicklung und Tests immer die Sandbox-Umgebung nutzen.

Häufige Fragen zum Fakturia MCP-Server

Technische und konzeptuelle Fragen rund um Vibe Coding und MCP.

Was ist ein MCP-Server und wozu dient er bei Fakturia?

MCP steht für Model Context Protocol – ein offener Standard, der KI-Agenten den strukturierten Zugriff auf externe APIs ermöglicht. Der Fakturia MCP-Server stellt der KI 123 Tools bereit, mit denen sie Kunden anlegen, Verträge starten, Rechnungen abrufen und Zahlungen verwalten kann – gesteuert durch natürlichsprachliche Anweisungen des Entwicklers.

Was bedeutet Vibe Coding im Kontext von Subscription Management?

Vibe Coding bezeichnet einen Entwicklungsansatz, bei dem der Entwickler dem KI-Agenten seine Absicht in natürlicher Sprache mitteilt und die KI den Code schreibt und die API-Calls ausführt. Mit dem Fakturia MCP-Server kann ein Entwickler z. B. sagen: „Leg einen neuen Kunden an, starte den Business-Pro-Tarif und erstelle die erste Rechnung“ – Claude Code übernimmt alle API-Calls automatisch.

Wie installiere ich den Fakturia MCP-Server?

Der Fakturia MCP-Server braucht keine klassische Installation. In der .mcp.json-Datei wird der Server mit dem Befehl npx -y @edjufy/fakturia-mcp und den Umgebungsvariablen FAKTURIA_API_HOST und FAKTURIA_API_KEY konfiguriert. Node.js 24+ ist Voraussetzung.

Welche KI-Clients sind mit dem Fakturia MCP-Server kompatibel?

Der Fakturia MCP-Server ist mit allen MCP-kompatiblen KI-Clients nutzbar, darunter Claude Code und Claude Desktop von Anthropic sowie anderen MCP-Clients. Der Server kommuniziert über das standardisierte stdio-Protokoll.

Ist der Fakturia MCP-Server kostenlos?

Ja. Der MCP-Server ist Open Source unter der MIT-Lizenz und kostenlos auf GitHub verfügbar. Voraussetzung ist ein Fakturia-Account mit aktiviertem API-Zugang. Eine kostenlose Sandbox steht unter fakturia.de/testmandant bereit.

Ist der Fakturia MCP-Server sicher für den produktiven Einsatz?

Mit der richtigen Konfiguration ja. Für die Entwicklung empfiehlt sich immer die Sandbox-Umgebung. In Produktivumgebungen sollte ein API-Key mit eingeschränkten Rechten verwendet werden. IP-Whitelisting ist in den Fakturia-Projekteinstellungen konfigurierbar. Weitere Details finden Sie in der README auf GitHub.

KI trifft Abrechnung.
Jetzt ausprobieren.

Fakturia-Sandbox einrichten, MCP-Server konfigurieren, loslegen – in unter 10 Minuten.

Sandbox startenGitHub → MCP-Server