MCP-Server (KI-Assistenten)

Verbinde Claude, ChatGPT, Cursor und andere KI-Assistenten mit deinem Lumabill-Konto ueber das Model Context Protocol.

MCP-Server (KI-Assistenten-Integration)

Verbinde dein Lumabill-Konto mit KI-Assistenten wie Claude, ChatGPT und Cursor ueber das Model Context Protocol (MCP). Nach der Verbindung kann dein 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. Erstelle 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 - erstelle 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

Fuege Folgendes zu deiner claude_desktop_config.json hinzu:

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

Dateispeicherort:

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

Claude Code

Fuege in .mcp.json im Projektstammverzeichnis hinzu:

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

Cursor

  1. Oeffne Einstellungen > MCP
  2. Klicke auf MCP-Server hinzufuegen
  3. Gib ein:
    • Name: lumabill
    • Typ: streamable-http
    • URL: https://mcp.lumabill.ch/mcp?key=lmb_dein_schluessel_hier

Ersetze lmb_dein_schluessel_hier in allen Beispielen durch deinen tatsaechlichen API-Schluessel.

Verfuegbare Tools

Nach der Verbindung hat dein 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 dein KI-Assistent verbunden ist, probiere 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 deines Schluessels - ist der Schluessel auf ein Profil beschraenkt, sieht der Assistent nur die Daten dieses Profils.

Fehlerbehebung

"Connection refused" oder Timeout

  • Pruefe, ob dein API-Schluessel korrekt ist und mit lmb_ beginnt
  • Stelle sicher, dass die URL exakt https://mcp.lumabill.ch/mcp?key=lmb_dein_schluessel_hier lautet (kein abschliessender Schraegstrich)
  • Vergewissere dich, dass dein Abonnement aktiv ist (Pro oder Lifetime)

"Unauthorized" oder "Ungueltiger API-Schluessel"

  • Der Schluessel wurde moeglicherweise widerrufen - pruefe Einstellungen > API im Dashboard
  • Stelle sicher, dass du den vollstaendigen Schluessel inklusive lmb_-Praefix kopiert hast

Tools werden nicht angezeigt

  • Starte deinen 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

  • Dein API-Schluessel ist auf Nur-Lesen gesetzt. Erstelle einen neuen Lesen-&-Schreiben-Schluessel, wenn du Daten erstellen oder aendern moechtest.

Rate-Limit-Fehler (429)

  • Du sendest zu viele Anfragen. Warte einen Moment und versuche es erneut.
  • Erwaege, Operationen zu buendeln oder zeitlich zu verteilen.
API-Schluessel & Public API