Zum Inhalt springen

Integration · Zahlungen

Claude & ChatGPT mit BTCPay Server verbinden

Frage deine KI nach Rechnungen, Zahlungen und Auszahlungen auf deinem eigenen BTCPay Server. Sie kann Rechnungen anhand der Bestell-ID finden, eingegangene Beträge je Zahlungsmethode anzeigen und neue Rechnungen und Zahlungsanfragen erstellen. Außerdem kann sie dein On-Chain-Wallet-Guthaben und die Transaktionen abrufen, Umsätze deiner Kassen-Apps einsehen und mit deiner Freigabe Erstattungen erstellen.

BTCPay Server kostenlos verbinden

Kostenloser Tarif, keine Kreditkarte erforderlich. Dauert etwa eine Minute.

Fragen Sie zum Beispiel

  • “Wurde die Rechnung für Bestellung 1087 bezahlt?”

    Die KI sucht Rechnungen anhand der Bestell-ID, liest den Status aus und zeigt die eingegangenen Zahlungen je Zahlungsmethode an.

  • “Erstelle eine Rechnung über 250 EUR für [email protected], Bestellung 1102.”

    Sie erstellt die Rechnung mit Betrag und Währung sowie der Bestell-ID und der E-Mail-Adresse des Käufers in den Metadaten.

  • “Erstelle eine Zahlungsanfrage für die Beratungspauschale im März.”

    Sie erstellt eine Zahlungsanfrageseite mit Titel, Betrag, Währung und optionalem Ablaufdatum.

Was Ihre KI tun kann

Rechnungen und Zahlungsanfragen

Suche, erstelle und lies Rechnungen, sieh Zahlungen je Zahlungsmethode ein, aktualisiere Metadaten und erstelle oder aktualisiere Zahlungsanfragen.

Erstattungen und Auszahlungen

Erstelle Erstattungen für bezahlte Rechnungen und liste Auszahlungen und Pull-Zahlungen mit Betrag, Ziel und Status auf.

Shops, Wallet und Apps

Rufe Shop-Einstellungen, Zahlungsmethoden, Wechselkurse, On-Chain-Wallet-Guthaben und Transaktionen sowie Umsätze deiner Apps ab.

  • “Welche Rechnungen sind letzte Woche abgelaufen?”

    Sie sucht im angegebenen Zeitraum nach Rechnungen mit dem Status Expired und listet sie auf.

  • “Wie hoch ist das On-Chain-Wallet-Guthaben und welche Beträge sind zuletzt eingegangen?”

    Sie ermittelt die Zahlungsmethode, ruft das Wallet-Guthaben ab und listet die letzten Wallet-Transaktionen auf.

  • “Erstatte Rechnung 7Hk2 zu dem Kurs, zu dem der Kunde bezahlt hat.”

    Sie erstellt eine Erstattung mit der Option RateThen. Der Kunde fordert sie über einen Link an, und Geld wird aus deinem Wallet ausgezahlt.

27 Tools für BTCPay Server

Diese Tools werden beim Verbinden aktiviert. Sie können jedes einzelne deaktivieren oder festlegen, dass es vor der Ausführung Ihre Freigabe benötigt.

  • archive_invoiceLöscht DatenArchiviert eine Rechnung anhand von `invoice_id`, sodass sie in der Rechnungsliste ausgeblendet wird.
  • create_invoiceÄndert DatenErstellt eine Rechnung zur Zahlung durch einen Kunden mit `amount` und `currency` (bei leerer Währungsangabe gilt die Standardwährung des Shops). Trage Angaben wie orderId oder buyerEmail in `metadata` ein. Lass `amount` für eine Aufladerechnung leer.
  • create_payment_requestÄndert DatenErstellt eine Zahlungsanfrageseite mit `title`, `amount`, `currency` sowie optional `description`, `email`, `expiry_date` und `reference_id`.
  • get_appRuft eine einzelne App anhand von `app_id` ab.
  • get_app_salesRuft die Umsatzstatistik einer App anhand von `app_id` für die letzten `number_of_days` Tage ab.
  • get_app_top_itemsRuft die meistverkauften Artikel einer App anhand von `app_id` ab.
  • get_current_userRuft den BTCPay-Server-Benutzer ab, mit dem du verbunden bist.
  • get_exchange_ratesRuft die aktuellen Wechselkurse des Shops ab, optional für bestimmte `currency_pair`-Werte wie BTC_USD.
  • get_invoiceRuft eine einzelne Rechnung anhand von `invoice_id` mit Betrag, Währung, Status und Metadaten ab.
  • get_invoice_paymentsRuft die Zahlungsmethoden und eingegangenen Zahlungen einer Rechnung anhand von `invoice_id` ab, einschließlich der gezahlten und fälligen Beträge je Zahlungsmethode.
  • get_payment_requestRuft eine einzelne Zahlungsanfrage anhand von `payment_id` mit Betrag, Status und Beschreibung ab.
  • get_payoutRuft eine einzelne Auszahlung anhand von `payout_id` mit Betrag, Ziel und Status ab.
  • get_storeRuft die Einstellungen eines Shops anhand seiner Shop-ID (`message_id`) ab.
  • get_wallet_overviewRuft das On-Chain-Wallet-Guthaben für eine `payment_method_id` ab (siehe list_payment_methods).
  • list_appsListet die Apps des Shops auf, zum Beispiel Kassen- und Crowdfunding-Seiten.
  • list_notificationsListet deine BTCPay-Benachrichtigungen auf, optional nur ungelesene mit `seen` = false.
  • list_payment_methodsListet die im Shop aktivierten Zahlungsmethoden (zum Beispiel On-Chain-BTC oder Lightning) und ihre IDs auf.
  • list_payment_requestsListet die Zahlungsanfragen des Shops (langfristig nutzbare Zahlungsseiten) auf.
  • list_payoutsListet die Auszahlungen des Shops auf, einschließlich noch ausstehender Erstattungen, optional mit `include_cancelled`.
  • list_pull_paymentsListet die Pull-Zahlungen des Shops (Erstattungs- und Auszahlungslinks) auf, optional mit `include_archived`.
  • list_storesListet die Shops auf, auf die du Zugriff hast, einschließlich ihrer IDs und Standardwährung.
  • list_wallet_transactionsListet On-Chain-Wallet-Transaktionen für eine `payment_method_id` auf, gefiltert nach `status_filter` oder `label_filter`.
  • mark_invoice_statusÄndert DatenMarkiert eine Rechnung anhand von `invoice_id` mithilfe von `status` manuell als settled oder invalid. Nur verwenden, wenn eine Zahlung außerhalb von BTCPay abgewickelt wurde.
  • refund_invoiceBewegt GeldErstellt eine Erstattung für eine bezahlte Rechnung anhand von `invoice_id`. `refund_variant` legt den Betrag fest: RateThen (Kryptowährung zum Kurs der ursprünglichen Zahlung), CurrentRate, Fiat, OverpaidAmount oder Custom (mit `custom_amount` und `custom_currency`). Der Kunde fordert die Erstattung über einen Link an; dabei wird Geld bewegt.
  • search_invoicesDurchsucht die Rechnungen des Shops nach `text_search`, `status` (New, Processing, Settled, Expired, Invalid), `order_id` oder einem Zeitraum (`start_date`/`end_date` als Unix-Zeitstempel). Verwende dieses Tool, um eine Rechnungs-ID zu finden.
  • update_invoice_metadataÄndert DatenErsetzt die `metadata` einer Rechnung anhand von `invoice_id`, zum Beispiel die Bestell-ID oder Käuferangaben.
  • update_payment_requestÄndert DatenAktualisiert eine Zahlungsanfrage anhand von `payment_id`, zum Beispiel `title`, `amount`, `description` oder `expiry_date`.

In drei Schritten einrichten

  1. 1

    App auswählen

    Erstellen Sie ein kostenloses PipMCP-Konto und wählen Sie BTCPay Server aus der App-Liste.

  2. 2

    Schlüssel einfügen

    Füge die Adresse deines BTCPay Server (zum Beispiel https://btcpay.example.com), einen API-Schlüssel und deine Shop-ID ein. Öffne in BTCPay Server Konto > Konto verwalten > API-Schlüssel, klicke auf Schlüssel generieren, wähle nur die benötigten Berechtigungen aus (zum Beispiel Rechnungen anzeigen und erstellen sowie Shops anzeigen) und kopiere den Schlüssel.

  3. 3

    Link zu Ihrer KI hinzufügen

    Sie erhalten einen persönlichen MCP-Link. Fügen Sie ihn in Claude, ChatGPT oder Cursor hinzu:

    1. Klicken Sie auf Ihren Namen und dann auf Einstellungen › Konnektoren › Benutzerdefinierten Konnektor hinzufügen.
    2. Fügen Sie Ihren Link als URL des Remote-MCP-Servers ein.
    3. Aktivieren Sie den Konnektor über das +-Menü in einem Chat.

Fragen

Was kann die KI in BTCPay Server tun?

Sie kann Rechnungen und die zugehörigen Zahlungen, Zahlungsanfragen, Auszahlungen, Pull-Zahlungen, Shops, Zahlungsmethoden, Wechselkurse, Apps und deren Umsätze, Benachrichtigungen sowie On-Chain-Wallet-Transaktionen suchen und abrufen. Sie kann Rechnungen und Zahlungsanfragen erstellen, Rechnungsmetadaten und Zahlungsanfragen aktualisieren, Rechnungen markieren oder archivieren und Erstattungen erstellen.

Sieht die KI meinen BTCPay-Server-API-Schlüssel?

Nein. Du fügst deinen BTCPay-Server-API-Schlüssel einmal in PipMCP ein. Er wird verschlüsselt gespeichert, der KI niemals angezeigt und nach dem Speichern nicht erneut angezeigt, auch dir nicht. Die KI sieht nur die Ergebnisse der Tools, die sie aufruft.

Kann ich festlegen, was die KI tun darf?

Ja. Du wählst aus, welche Tools aktiviert sind, und kannst mit reinem Lesezugriff beginnen. Das Erstellen einer Erstattung bewegt Geld. Wenn eine Rechnung als beglichen oder ungültig markiert wird, wird ihr Status manuell geändert. Für beide Aktionen kannst du festlegen, dass sie vor der Ausführung deine Freigabe benötigen. Jeder Tool-Aufruf wird protokolliert.

Funktioniert das mit ChatGPT?

Ja. Öffne in ChatGPT Einstellungen › Apps & Konnektoren › Erweitert, aktiviere den Entwicklermodus und füge deinen PipMCP-Link hinzu. Der Entwicklermodus erfordert einen kostenpflichtigen ChatGPT-Tarif: Plus, Pro, Business oder Enterprise. Derselbe Link funktioniert auch in Claude (Einstellungen › Konnektoren › Benutzerdefinierten Konnektor hinzufügen), Cursor und anderen MCP-Clients.

Was kostet das?

PipMCP bietet einen kostenlosen Tarif, und du brauchst zum Einstieg keine Kreditkarte. Kostenpflichtige Tarife werden pro abgeschlossener Aufgabe abgerechnet. Du verbindest dein eigenes BTCPay-Server-Konto auf deinem eigenen Server. PipMCP stellt die Verbindung mit dem von dir angegebenen API-Schlüssel her.

Funktioniert das mit meinem eigenen BTCPay Server?

Ja. Du gibst die Adresse deines eigenen Servers zusammen mit dem API-Schlüssel und der Shop-ID ein, und PipMCP greift auf diesen Server zu. Die Berechtigungen, die du beim Erstellen des Schlüssels auswählst, begrenzen zusätzlich zu den in PipMCP aktivierten Tools, was mit dem Schlüssel möglich ist.

Lassen Sie Ihre KI noch heute in BTCPay Server arbeiten.

Starten Sie kostenlos. Ihr Schlüssel bleibt verschlüsselt und Sie entscheiden, was die KI tun darf.

BTCPay Server kostenlos verbinden

PipMCP steht in keiner Verbindung zu BTCPay Server. Produktnamen sind Marken ihrer jeweiligen Inhaber.