Was ist der LumaBill MCP-Server?
MCP (Model Context Protocol) ist ein offener Standard, der es KI-Assistenten ermöglicht, mit externen Diensten zu kommunizieren. Stell dir vor, du sprichst mit Claude, Cursor oder einem anderen KI-Tool — und es kann direkt auf deine LumaBill-Daten zugreifen: Rechnungen erstellen, Kunden nachschlagen, Ausgaben prüfen oder Finanzberichte abrufen.
Der LumaBill MCP-Server läuft unter mcp.lumabill.ch und stellt 52 Tools bereit, die alle Bereiche abdecken:
- Rechnungen, Offerten und wiederkehrende Rechnungen
- Kunden und Lieferanten
- Ausgaben und Journalbuchungen
- Bankkonten und CAMT-Importe (inkl. automatischem Zahlungsabgleich)
- Umsatzberichte und Finanzauswertungen
- Katalogpositionen und Zahlungen
Einrichtung in 3 Minuten
1. API-Schlüssel erstellen
Gehe in LumaBill zu Einstellungen > API-Schlüssel und erstelle einen neuen Schlüssel. Wähle zwischen:
- Nur Lesen — perfekt für Abfragen und Berichte
- Lesen & Schreiben — auch für das Erstellen und Bearbeiten von Daten
2. MCP-Server verbinden
Füge diese Konfiguration in die MCP-Einstellungen deines KI-Tools ein:
{
"mcpServers": {
"lumabill": {
"url": "https://mcp.lumabill.ch/mcp?key=YOUR_API_KEY"
}
}
}
Bei Claude Desktop geht das unter Einstellungen > MCP Server. Bei Claude Code in der Datei .mcp.json. Bei Cursor in den MCP-Einstellungen.
3. Loslegen
Sobald verbunden, kannst du in natürlicher Sprache mit deinen LumaBill-Daten arbeiten.
Praxisbeispiele: Was du mit KI + LumaBill machen kannst
Kunden nachschlagen
Du sagst: "Zeig mir alle meine Kunden in Zürich"
Claude antwortet:
Ich habe deine Kunden abgerufen. Hier sind die Kunden mit Standort Zürich:
Kunde Adresse Kundennr. Müller IT Solutions GmbH Bahnhofstrasse 42, 8001 Zürich C-006 MCP Test AG 8005 Zürich C-009 Möchtest du eine Rechnung für einen dieser Kunden erstellen?
Rechnung erstellen mit einem Satz
Du sagst: "Erstelle eine Rechnung für Müller IT Solutions über 16 Stunden Webdesign zu CHF 180 pro Stunde"
Claude antwortet:
Rechnung erstellt:
- Nummer: IV-023
- Kunde: Müller IT Solutions GmbH
- Position: Webdesign — 16h × CHF 180.00
- Total: CHF 2'880.00
- Fällig: 10.05.2026 (30 Tage)
Deine Firmendaten, Währung und Zahlungskonditionen wurden automatisch aus deinem Profil übernommen. Soll ich die Rechnung versenden?
Das Besondere: Du musst nur den Kunden und die Positionen angeben. LumaBill füllt automatisch deine Absenderdaten, Währung, MwSt-Einstellungen, Zahlungsfrist und sogar die nächste Rechnungsnummer aus — inklusive korrekter Swiss QR-Rechnung, falls aktiviert.
Ausgaben überprüfen
Du sagst: "Was habe ich diesen Monat an Ausgaben?"
Claude antwortet:
Hier sind deine Ausgaben für April 2026:
Datum Lieferant Beschreibung Betrag 10.04.2026 Test Vendor GmbH Büromaterial CHF 89.50 Total April: CHF 89.50
Soll ich das mit dem Vormonat vergleichen?
Offene Rechnungen abfragen
Du sagst: "Welche Rechnungen sind noch offen?"
Claude antwortet:
Du hast aktuell 8 unbezahlte Rechnungen:
Rechnung Kunde Betrag Fällig IV-022 Update Test AG CHF 50.00 10.05.2026 IV-019 MCP Test AG CHF 0.00 10.05.2026 IV-018 Müller IT Solutions GmbH CHF 300.00 10.05.2026 ... ... ... ... Möchtest du eine Zahlungserinnerung versenden?
Finanzberichte abrufen
Du sagst: "Erstelle mir eine Gewinn- und Verlustrechnung für Q1 2026"
Claude antwortet:
Verfügbare Berichtstypen:
- Profit & Loss — Gewinn- und Verlustrechnung
- Balance Sheet — Bilanz
- VAT Report — MwSt-Abrechnung
Ich erstelle den P&L-Bericht für Q1 2026 (01.01. – 31.03.2026)...
Fortgeschrittene Anwendungen
Automatisierte Monatsabschlüsse
Du kannst Claude bitten, am Ende jedes Monats eine Zusammenfassung zu erstellen — besonders nützlich, wenn du eine Milchbüechlirechnung führst:
"Fasse meinen April zusammen: Wie viele Rechnungen habe ich gestellt, wie viel Umsatz gemacht, was waren meine grössten Ausgaben?"
Bulk-Operationen
"Erstelle Rechnungen für alle meine monatlichen Kunden mit den gleichen Positionen wie letzten Monat."
Buchhaltungspflichten automatisieren
Als Freelancer in der Schweiz musst du Einnahmen und Ausgaben lückenlos dokumentieren. Mit KI wird das zum Einzeiler:
"Kategorisiere alle Ausgaben dieses Monats und erstelle eine Zusammenfassung nach Konto."
Datenqualität prüfen
"Prüfe, ob alle meine Kunden eine E-Mail-Adresse haben. Liste die ohne auf."
Sicherheit
- Dein API-Schlüssel bleibt privat — er wird nur zwischen deinem KI-Tool und dem LumaBill-Server übertragen
- Rate Limiting schützt vor versehentlichen Massenabfragen (60 Lese- / 20 Schreibvorgänge pro Minute)
- Zugriffskontrollen — du bestimmst, ob der Schlüssel nur lesen oder auch schreiben darf
- Nur für Pro/Lifetime — API-Zugang ist ein Premium-Feature
- Schlüssel jederzeit widerrufbar über die Einstellungen
REST API für Entwickler
Neben dem MCP-Server bietet LumaBill auch eine REST API unter api.lumabill.ch/v1 — mit derselben Authentifizierung. Ideal für eigene Integrationen, Skripte oder Webhooks.
Volle Dokumentation mit interaktivem Swagger UI findest du in den Entwickler-Docs.
Fazit
Mit dem MCP-Server wird LumaBill zum sprachgesteuerten Buchhaltungstool. Statt Formulare auszufüllen, sagst du einfach, was du brauchst — und die KI erledigt den Rest. Erstelle jetzt dein kostenloses Konto und verbinde Claude mit deinem LumaBill-Konto.