MCP-Server (KI-Assistenten)

Verbinden Sie Claude, ChatGPT, Cursor und andere KI-Assistenten mit Ihrem Lumabill-Konto ueber das Model Context Protocol.

MCP-Server (KI-Assistenten-Integration)

Verbinden Sie Ihr Lumabill-Konto mit KI-Assistenten wie Claude, ChatGPT und Cursor ueber das Model Context Protocol (MCP). Nach der Verbindung kann Ihr KI-Assistent Rechnungen erstellen, Kunden nachschlagen, Berichte generieren und vieles mehr — alles in natuerlicher Sprache.

Der MCP-Server erfordert einen Pro- oder Lifetime-Plan und einen API-Schluessel. Erstellen Sie einen unter Einstellungen > API im Dashboard.

Voraussetzungen

  1. Pro- oder Lifetime-Abonnement — der MCP-Server nutzt die oeffentliche API, eine Pro-Funktion
  2. Ein API-Schluessel — erstellen Sie einen unter Einstellungen > API (Nur-Lesen reicht fuer Abfragen; Lesen & Schreiben fuer vollen Zugriff)
  3. Ein kompatibler KI-Client — Claude Desktop, Claude Code, Cursor oder ein anderes MCP-kompatibles Tool

Einrichtung

Claude Desktop

Fuegen Sie Folgendes zu Ihrer claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "lumabill": {
      "type": "streamable-http",
      "url": "https://mcp.lumabill.ch/mcp?key=lmb_ihr_schluessel_hier"
    }
  }
}

Dateispeicherort:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Claude Code

Fuegen Sie in .mcp.json im Projektstammverzeichnis hinzu:

{
  "mcpServers": {
    "lumabill": {
      "type": "streamable-http",
      "url": "https://mcp.lumabill.ch/mcp?key=lmb_ihr_schluessel_hier"
    }
  }
}

Cursor

  1. Oeffnen Sie Einstellungen > MCP
  2. Klicken Sie auf MCP-Server hinzufuegen
  3. Geben Sie ein:
    • Name: lumabill
    • Typ: streamable-http
    • URL: https://mcp.lumabill.ch/mcp?key=lmb_ihr_schluessel_hier

Ersetzen Sie lmb_ihr_schluessel_hier in allen Beispielen durch Ihren tatsaechlichen API-Schluessel.

Verfuegbare Tools

Nach der Verbindung hat Ihr KI-Assistent Zugriff auf alle Lumabill-API-Endpunkte als Tools:

Rechnungsstellung

  • Rechnungen auflisten, erstellen, aendern und loeschen
  • Offerten erstellen und verwalten
  • Wiederkehrende Rechnungen verwalten

Kunden & Lieferanten

  • Kunden suchen und nachschlagen
  • Kundendaten erstellen und aktualisieren
  • Lieferantenkontakte verwalten

Ausgaben & Einnahmen

  • Ausgaben erfassen und kategorisieren
  • Nicht-Rechnungs-Einnahmen verfolgen
  • Einnahmedaten abfragen

Buchhaltung

  • Buchungen erstellen
  • Kontenplan anzeigen
  • Geschaeftsjahre verwalten

Banking

  • Banktransaktionen importieren (CAMT)
  • Transaktionen abstimmen

Berichte

  • Erfolgsrechnung generieren
  • Bilanz generieren
  • MWST-Abrechnung erstellen

Einstellungen

  • Profile und Firmeninformationen anzeigen
  • Produktkatalog durchsuchen

Beispiel-Prompts

Sobald Ihr KI-Assistent verbunden ist, probieren Sie Prompts wie:

  • "Erstelle eine Rechnung fuer Muster AG fuer 3 Stunden Beratung zu CHF 180/Stunde"
  • "Zeige mir alle unbezahlten Rechnungen"
  • "Wie war mein Umsatz letzten Monat?"
  • "Erstelle einen Erfolgsrechnungs-Bericht fuer Q1 2026"
  • "Suche den Kunden Meier GmbH"
  • "Erfasse eine Ausgabe von CHF 49.90 fuer Bueromaterial"
  • "Liste alle wiederkehrenden Rechnungen auf"

Berechtigungen & Rate Limits

  • Nur-Lesen-Schluessel zeigen nur Lese-Tools (Auflisten, Abrufen, Berichte). Schreiboperationen sind ausgeblendet.
  • Lesen-&-Schreiben-Schluessel zeigen alle Tools.
  • Rate Limits sind identisch mit der REST-API: 60 Lesezugriffe/Minute und 20 Schreibzugriffe/Minute pro Schluessel.
  • Der MCP-Server respektiert den Profil-Scope Ihres Schluessels — ist der Schluessel auf ein Profil beschraenkt, sieht der Assistent nur die Daten dieses Profils.

Fehlerbehebung

"Connection refused" oder Timeout

  • Pruefen Sie, ob Ihr API-Schluessel korrekt ist und mit lmb_ beginnt
  • Stellen Sie sicher, dass die URL exakt https://mcp.lumabill.ch/mcp?key=lmb_ihr_schluessel_hier lautet (kein abschliessender Schraegstrich)
  • Vergewissern Sie sich, dass Ihr Abonnement aktiv ist (Pro oder Lifetime)

"Unauthorized" oder "Ungueltiger API-Schluessel"

  • Der Schluessel wurde moeglicherweise widerrufen — pruefen Sie Einstellungen > API im Dashboard
  • Stellen Sie sicher, dass Sie den vollstaendigen Schluessel inklusive lmb_-Praefix kopiert haben

Tools werden nicht angezeigt

  • Starten Sie Ihren KI-Client nach der Konfigurationsaenderung neu
  • Bei Claude Desktop: Anwendung vollstaendig beenden und neu oeffnen
  • Bei Cursor: Fenster nach dem Hinzufuegen des MCP-Servers neu laden

"Nur-Lesen-Schluessel"-Fehler bei Schreiboperationen

  • Ihr API-Schluessel ist auf Nur-Lesen gesetzt. Erstellen Sie einen neuen Lesen-&-Schreiben-Schluessel, wenn Sie Daten erstellen oder aendern moechten.

Rate-Limit-Fehler (429)

  • Sie senden zu viele Anfragen. Warten Sie einen Moment und versuchen Sie es erneut.
  • Erwaegen Sie, Operationen zu buendeln oder zeitlich zu verteilen.
API-Schluessel & Public API