Zum Hauptinhalt springen
QuickBilling-LogoQuickBilling

Model Context Protocol

MCP-Server-Dokumentation

Verbinden Sie Claude Desktop, Cursor und andere MCP-Clients mit Remote-Server-Unterstützung mit QuickBilling. Tragen Sie eine URL ein und melden Sie sich mit Ihrem QuickBilling-Konto an.

Was ist der QuickBilling-MCP-Server?

Ein gehosteter Remote-MCP-Server, der QuickBilling als typisierte Werkzeuge für KI-Assistenten bereitstellt.

Das Model Context Protocol (MCP) lässt KI-Assistenten strukturierte Werkzeuge aufrufen, statt eine Oberfläche auszulesen.

QuickBilling betreibt einen gehosteten Remote-MCP-Server unter https://mcp.quickbilling.io/mcp (Streamable HTTP). Sie fügen ihn einem MCP-Client mit Remote-Server-Unterstützung hinzu und melden sich mit Ihrem QuickBilling-Konto an.

Was das in der Praxis heißt

  • Ihr Assistent kann im Chat Rechnungen erstellen, Ausgaben erfassen, Kunden verwalten und Berichte abrufen
  • 129 Werkzeuge für Abrechnung und Ausgaben
  • Die Anmeldung nutzt OAuth 2.1 mit PKCE und Ihr QuickBilling-Konto, keinen API-Schlüssel
  • Jeder Aufruf läuft mit den Rechten Ihres Kontos

Ideal für: Freiberufler und Teams, die ohnehin in Claude Desktop, Cursor oder einem anderen MCP-Client arbeiten und Rechnungen stellen wollen, ohne ins Dashboard zu wechseln.

API für Produkte, MCP für Assistenten

Dieselben Daten, zwei Zugänge.

Nutzen Sie die REST-API, wenn Sie Abrechnung in Ihr eigenes Produkt oder Ihre Automatisierung einbauen. API-Schlüssel sind Teil des Unlimited-Tarifs.

Nutzen Sie den MCP-Server, wenn ein Mensch einen KI-Assistenten steuert und in normaler Sprache auf dieselben Daten zugreifen will.

QuickBilling MCP ist gedacht für

  • Claude Desktop, hinzugefügt als benutzerdefinierter Remote-Connector
  • Cursor und andere Clients mit Remote-MCP-Server-Unterstützung
  • Jeden MCP-Client, der Remote-Server mit OAuth-Anmeldung unterstützt

Jedes Werkzeug entspricht einem echten, authentifizierten Aufruf mit den Rechten des angemeldeten Kontos.

Schnellstart

Eine URL eintragen und anmelden.

Voraussetzungen: ein QuickBilling-Konto und ein MCP-Client mit Unterstützung für Remote-Server mit OAuth-Anmeldung.

Schritte

  1. Öffnen Sie die Einstellungen Ihres MCP-Clients und fügen Sie einen Remote-MCP-Server hinzu
  2. Verwenden Sie die URL https://mcp.quickbilling.io/mcp
  3. Melden Sie sich mit Ihrem QuickBilling-Konto an, sobald der Client Sie bittet, die Verbindung zu autorisieren
  4. Fragen Sie Ihren Assistenten: „Liste meine QuickBilling-Workspaces auf“ oder „Welche Rechnungen sind überfällig?“

Sie brauchen keinen API-Schlüssel. Hat Ihr Konto mehr als einen Workspace, lassen Sie den Assistenten sie auflisten und wählen Sie einen aus.

Konfiguration für Clients, die eine JSON-Datei lesen (zum Beispiel Cursor)

mcp.json
{
  "mcpServers": {
    "quickbilling": {
      "url": "https://mcp.quickbilling.io/mcp"
    }
  }
}

In Claude Desktop fügen Sie dieselbe URL als benutzerdefinierten Connector (Remote-MCP-Server) hinzu. Menünamen unterscheiden sich je nach Client. Schauen Sie in die Dokumentation Ihres Clients, wie man einen Remote-Server hinzufügt.

Verbindungsdetails

Was Ihr MCP-Client braucht.

  • Server-URL: https://mcp.quickbilling.io/mcp
  • Transport: Streamable HTTP, ein Remote-Server ohne Installation
  • Authentifizierung: OAuth 2.1 mit PKCE, Anmeldung mit Ihrem QuickBilling-Konto
  • Discovery: Die Metadaten der OAuth-geschützten Ressource liegen unter /.well-known/oauth-protected-resource auf demselben Host

API-Schlüssel akzeptiert der Remote-Server nicht. API-Schlüssel gehören zur REST-API und sind Teil des Unlimited-Tarifs: siehe https://quickbilling.io/docs/api

Workspaces

Wie ein Assistent den Workspace wählt, in dem er arbeitet.

Hat Ihr Konto einen Workspace, nutzt der Assistent ihn ohne weitere Einrichtung.

Haben Sie mehrere, lassen Sie den Assistenten Ihre Workspaces auflisten und einen auswählen.

Workspace-Werkzeuge

  • list_workspaces, gibt Ihre Workspaces zurück
  • get_active_workspace, zeigt den verwendeten Workspace
  • set_active_workspace, wählt einen Workspace für die folgenden Aufrufe

Werkzeuge

Was ein Assistent nach der Verbindung tun kann.

Der Server bietet 129 Werkzeuge

  • Rechnungen und Angebote (18): auflisten, abrufen, erstellen, speichern, löschen, duplizieren, Angebot in Rechnung umwandeln, Status, als bezahlt markieren, E-Mail-Vorschau und Versand, Freigabelinks, PDF-Link, Aktivität, Aufruf-Analysen, Erinnerungen
  • Wiederkehrende Rechnungen (7): auflisten, abrufen, erstellen, ändern, pausieren, fortsetzen, löschen
  • Kunden (8): auflisten, suchen, abrufen, Kundenauszug, erstellen, schnell erstellen, ändern, löschen
  • Abrechnungsprofile und Artikelbibliothek (7)
  • Vorlagen (6): Vorlagen auflisten, eingebaute Vorlagen, Standard, abrufen, Standard festlegen, Voreinstellungen
  • Ausgaben (21): erstellen (einzeln oder mehrere), ändern, löschen, einreichen, genehmigen, ablehnen, als bezahlt markieren, stornieren, Sammelaktionen, abrechenbare Ausgaben, mit Rechnungen verknüpfen, Anhänge, Aktivität
  • Ausgabenberichte (9): Kennzahlen, Übersicht, monatlich, vierteljährlich, jährlich, Trends, Kostenanalyse, Ausgaben, steuerlich absetzbar
  • Kategorien, Lieferanten und Tags (12)
  • Budgets (5), wiederkehrende Ausgaben (7) und Einnahmen (6)
  • Projekte und Meilensteine (10), einschließlich der Abrechnung eines Meilensteins
  • Berichte und Dashboards (7): Übersichtskennzahlen, Workspace-Berichte, Gewinn und Verlust, Cashflow, Gewinn je Kunde, Kundenrentabilität, Nettoposition
  • Workspace und Profil (5): get_profile, list_workspaces, get_active_workspace, set_active_workspace und attach_receipt_to_expense
  • Tarifnutzung (1): get_subscription_usage

Nicht über MCP verfügbar: Teammitglieder und Einladungen, Kontoexport, Tarife, Vorlagendesign, Farbpaletten sowie Avatar- oder Logo-Uploads. Nutzen Sie dafür die Web-App.

Dieselben Daten sind über die REST-API verfügbar: https://quickbilling.io/docs/api

Beispielabläufe

Anfragen, die sich sauber auf die Werkzeuge abbilden.

Rechnung erstellen und senden

„Erstelle eine Rechnung für Bluebird Café über 3 Stunden Design zu 120 $ pro Stunde und sende sie ab.“ Der Assistent findet oder legt den Kunden an, baut die Rechnung auf und sendet sie per E-Mail.

Ausgabe mit Beleg erfassen

„Erfasse diesen Beleg als Ausgabe in der Kategorie Software.“ Der Assistent legt die Ausgabe in dieser Kategorie an und hängt den Beleg an.

Überfälliges prüfen

„Welche Rechnungen sind überfällig?“ Der Assistent listet unbezahlte Rechnungen nach Fälligkeitsdatum auf.

Über Workspaces hinweg arbeiten

„Liste meine Workspaces auf und wechsle zu Northwind Studio.“ Danach weiter mit Rechnungs- oder Ausgabenanfragen.

Anmeldung und Sicherheit

Ihr Konto, Ihre Rechte.

  • Die Anmeldung nutzt OAuth mit Ihrem QuickBilling-Konto, und der Remote-Server akzeptiert keine API-Schlüssel
  • Jeder Aufruf läuft mit den Rechten Ihres Kontos, auch zum Ändern und Löschen von Datensätzen
  • Prüfen Sie, was Ihr Assistent vorschlägt, bevor Sie eine Änderung bestätigen
  • Entfernen Sie die Verbindung in Ihrem MCP-Client, um den Zugriff zu beenden
  • Was ein Assistent mit den empfangenen Daten tut, richtet sich nach den Richtlinien seines Anbieters, siehe den Abschnitt zu KI-Assistenten in der Datenschutzerklärung

Fehlerbehebung

Häufige Einrichtungsprobleme.

Der Client kann sich nicht verbinden

Prüfen Sie, ob Ihr Client Remote-MCP-Server mit OAuth-Anmeldung unterstützt und ob die URL genau https://mcp.quickbilling.io/mcp lautet.

Die Anmeldung wird nicht abgeschlossen

Entfernen Sie den Server aus Ihrem Client, fügen Sie ihn erneut hinzu und folgen Sie der Anmeldeaufforderung mit Ihrem QuickBilling-Konto.

Falsche Workspace-Daten

Fragen Sie den Assistenten, welcher Workspace aktiv ist, lassen Sie dann Ihre Workspaces auflisten und wählen Sie den richtigen.

Mehr Hilfe: https://quickbilling.io/contact, info@quickbilling.io