Eindeutige Kundenauswahl
Bei mehreren Treffern fragt das Plugin nach, statt einen Kunden zu erraten.
Öffentlicher Plugin-Preview
Rechnungsentwürfe mit Claribill in Codex und ChatGPT
Verbinden Sie Ihr Claribill-Konto per OAuth, suchen Sie bestehende Kunden und Produkte und lassen Sie einen prüfbaren Rechnungsentwurf berechnen. Claribill speichert den Rechnungsentwurf erst, nachdem Sie die Zusammenfassung ausdrücklich bestätigt haben; authentifizierte Werkzeugaufrufe werden als private API-Nutzungsprotokolle erfasst.
Gespeicherte Leistungen
Produkte und Leistungen werden direkt aus Ihrer verbundenen Firma gelesen.
Summen vorab prüfen
Netto, Steuer und Brutto werden ohne Änderung von Rechnungsdaten vorbereitet; der API-Aufruf wird protokolliert.
Bestätigung vor dem Schreiben
Ein zehn Minuten gültiger Nachweis bindet exakt den unveränderten, angezeigten Entwurf; erst Ihre ausdrückliche Freigabe erlaubt das Speichern.
Mandantensicher
Firma, Benutzer, Rolle und Berechtigungen stammen ausschließlich aus dem OAuth-Grant.
Bleibt ein Entwurf
Das Plugin finalisiert, versendet oder bezahlt keine Rechnung.
Claribill verbinden
Codex und ChatGPT verwenden während der Prüfung unterschiedliche Wege. Der Plugin-Schalter in der Codex-Desktop-App erlaubt installierte Plugins, aktiviert aber nicht den ChatGPT-Entwicklermodus. Nach der Veröffentlichung installieren Sie Claribill direkt aus dem gemeinsamen Plugin-Verzeichnis.
Codex: installiertes Plugin verwenden
- Aktivieren Sie in den Codex-Einstellungen unter „Allgemein“ den Schalter „Plugins“.
- Öffnen Sie „Plugins“, suchen Sie „Claribill“ und aktivieren Sie das installierte Plugin.
- Starten Sie einen neuen Task und bitten Sie Codex, Claribill zu verwenden. Beim ersten Werkzeugaufruf beginnt die OAuth-Anmeldung.
ChatGPT: MCP im Browser verbinden
- Öffnen Sie die ChatGPT-Plugin-Verwaltung im Browser, nicht die Codex-Desktop-Einstellungen.
- Falls für Ihr Konto verfügbar: Aktivieren Sie unter „Sicherheit und Anmeldung“ den Entwicklermodus. Die Option kann je nach Konto und Workspace-Richtlinie fehlen.
- Wählen Sie „Hinzufügen“ und erstellen Sie eine MCP-Verbindung namens „Claribill Preview“ mit der unten angezeigten URL.
- Prüfen Sie, ob zehn Claribill-Werkzeuge erkannt werden, und starten Sie einen neuen Chat.
MCP-URL dieses Deployments
https://www.claribill.com/api/mcpClaribill autorisieren
Anmeldung und Firma bleiben bei Claribill
Beim ersten Werkzeugaufruf melden Sie sich per Magic Link an. Danach wählen Sie genau eine Firma und bestätigen die Berechtigungen für Kunden, Produkte und Rechnungsentwürfe. Ein späterer Firmenwechsel im Dashboard ändert diese Verbindung nicht unbemerkt.
Voraussetzung ist eine zulässige Rolle und ein Claribill-Paket mit API-Zugriff. Externe Mitglieder können das Plugin in dieser Version nicht verbinden.
Beispiel
„Erstelle für Muster GmbH einen Rechnungsentwurf über zehn Beratungsstunden zu je 150 Euro mit 20 Prozent Umsatzsteuer.“
Codex sucht den Kunden, berechnet den Entwurf und zeigt Kunde, Positionen, Fälligkeit, Währung sowie Netto-, Steuer- und Bruttosumme. Erst auf eine Antwort wie „Ja, als Entwurf erstellen“ wird der Entwurf gespeichert und mit einem direkten Claribill-Link zurückgegeben.
Verfügbare Funktionen
Kunden suchen
Bestehende Kunden anhand von Name, E-Mail oder Kundennummer finden.
Kunde anzeigen
Stammdaten eines einzelnen Kunden inklusive Adresse und Zahlungsziel laden.
Produkte suchen
Aktive Produkte und Leistungen mit Preis, Einheit und Steuersatz finden.
Produkt anzeigen
Ein einzelnes aktives Produkt mit Preis, Einheit und Steuersatz laden.
Entwurf berechnen
Positionen sowie Netto-, Steuer- und Bruttosummen prüfen, ohne eine Rechnung zu speichern.
Entwurf erstellen
Nach ausdrücklicher Bestätigung genau einen editierbaren Rechnungsentwurf anlegen.
Rechnung anzeigen
Eine sichtbare Rechnung anhand ihrer Claribill-ID erneut laden.
Rechnungen auflisten
Sichtbare Rechnungen nach Status, Kunde, Dokumentart und Zeitraum filtern, ohne Positionen.
Gutschriften auflisten
Sichtbare Gutschriften nach Status, Kunde und Zeitraum filtern, ohne Positionen.
Gutschrift anzeigen
Eine sichtbare Gutschrift anhand ihrer Claribill-ID erneut laden.
Limits und Nachweise
MCP-Aufrufe sind auf 120 Anfragen pro Minute begrenzt. Die OAuth-Autorisierungs- und Token-Endpunkte erlauben 30 Anfragen pro Minute, die einmalige Dynamic Client Registration 10 Anfragen pro Stunde.
Der von prepare_invoice_draft zurückgegebene confirmationProof ist zehn Minuten gültig und an genau den unveränderten, angezeigten Entwurf gebunden. Ändert sich der Entwurf oder läuft der Nachweis ab, muss prepare_invoice_draft erneut aufgerufen werden.