Stripe MCP — Anwendungsfälle, Installieren & Live-Demo

Name: Stripe MCP Server
Author: stripe

Warum nutzen

Hauptfunktionen

Lesen und schreiben Sie über die Kernressourcen von Stripe
Testmodus- und Live-Modus-Umschaltung über API-Schlüssel
Leistungsstarke Suche (Abfragen im „stripe.search“-Stil)
Werkzeugauswahl über „--tools=“ CLI arg – aus Sicherheitsgründen auf schreibgeschützt beschränken
Wird direkt von Stripe verwaltet

Live-Demo

In der Praxis

stripe.replay ▶ bereit

0/0

Installieren

Wählen Sie Ihren Client

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

{
  "mcpServers": {
    "stripe": {
      "command": "npx",
      "args": [
        "-y",
        "@stripe/mcp",
        "--tools=all"
      ]
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "stripe": {
      "command": "npx",
      "args": [
        "-y",
        "@stripe/mcp",
        "--tools=all"
      ]
    }
  }
}

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "stripe": {
      "command": "npx",
      "args": [
        "-y",
        "@stripe/mcp",
        "--tools=all"
      ]
    }
  }
}

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "stripe": {
      "command": "npx",
      "args": [
        "-y",
        "@stripe/mcp",
        "--tools=all"
      ]
    }
  }
}

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "stripe",
      "command": "npx",
      "args": [
        "-y",
        "@stripe/mcp",
        "--tools=all"
      ]
    }
  ]
}

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json

{
  "context_servers": {
    "stripe": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@stripe/mcp",
          "--tools=all"
        ]
      }
    }
  }
}

In context_servers hinzufügen. Zed lädt beim Speichern neu.

claude mcp add stripe -- npx -y @stripe/mcp --tools=all

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: Stripe

Untersuchen Sie, warum die Gebühren eines Kunden fehlschlagen

👤 Support-Ingenieure und Gründer in erster Linie ⏱ ~10 min beginner

Wann einsetzen: Der Kunde sagt: „Meine Karte wurde dreimal abgelehnt.“ Sie möchten sehen, was tatsächlich auf Stripes Seite passiert ist.

Voraussetzungen

Stripe-eingeschränkter API-Schlüssel mit Lesegebühren/Kunden — Dashboard.stripe.com/apikeys → Eingeschränkte Schlüssel → gewähren Lesen Sie mehr über Kunden, Gebühren, Zahlungsabsichten

Ablauf

Finden Sie den Kunden

Suchen Sie den Stripe-Kunden mit der E-Mail-Adresse „[email protected]“. Zeigen Sie die Standardzahlungsmethode und die Gesamtausgaben an.✓ Kopiert

→ Kundendatensatz mit Angaben zur Zahlungsart
Ziehen Sie kürzlich fehlgeschlagene Anklagen zurück

Listen Sie die Gebühren dieses Kunden in den letzten 30 Tagen mit dem Status != „erfolgreich“ auf. Zeigen Sie jeweils den Fehlercode und die Meldung an.✓ Kopiert

→ Fehlerliste mit „card_declined“/„expired_card“/etc. Codes
Erklären Sie und empfehlen Sie Maßnahmen

Was ist das eigentliche Problem? Empfehlen Sie, was Sie dem Kunden mitteilen sollen (z. B. „Karte abgelaufen – bitte aktualisieren“ oder „Betrugssperre – versuchen Sie es mit einer anderen Karte“).✓ Kopiert

→ Klare, kundenorientierte Erklärung

Ergebnis: Support-Ticket mit der eigentlichen Ursache gelöst, nicht „Später erneut versuchen“.

Fallstricke

Wenn man sich nur die Gebühren ansieht, werden Zahlungsabsichten übersehen, die nie zu einer Gebühr geführt haben — Überprüfen Sie auch Zahlungsabsichten mit dem Status „erfordert_zahlungsmethode“ oder „storniert“.
Der Kunde sagt „abgelehnt“, aber es handelte sich um eine Aufgabe des 3DS — 3DS-Herausforderungen, die der Benutzer schließt, werden als „requires_action“ angezeigt und laufen dann ab; Überprüfen Sie die Zeitleiste

Erstellen Sie eine Testrechnung und einen Zahlungslink für einen Deal

👤 Vertriebs- und Betriebsmitarbeiter schließen individuelle Geschäfte ab ⏱ ~5 min beginner

Wann einsetzen: Sie haben mit einem Kunden einen einmaligen individuellen Preis vereinbart und benötigen schnell eine Rechnung oder einen Zahlungslink.

Voraussetzungen

TEST-Modustaste (sk_test_...) — Starten Sie immer im Testmodus. Wechseln Sie erst zum Live-Schlüssel, nachdem der Fluss validiert wurde.

Ablauf

Suchen oder erstellen Sie den Kunden

Suchen Sie nach einem Stripe-Kunden mit der E-Mail-Adresse „[email protected]“. Wenn keine vorhanden ist, erstellen Sie eine mit dem Namen „BigCo Inc“.✓ Kopiert

→ Kundennummer zurückgegeben
Erstellen Sie eine einmalige Preis- und Rechnungsposition

Erstellen Sie einen einmaligen Rechnungsposten: 4.500 $, Beschreibung „Q2-Onboarding-Services“. An diesen Kunden anhängen. Anschließend erstellen und finalisieren Sie eine Rechnung.✓ Kopiert

→ Rechnung mit „hosted_invoice_url“.
Bestätigen Sie die Lieferung

Geben Sie mir die gehostete Rechnungs-URL und eine Zusammenfassung dessen, was erstellt wurde. Schicken Sie es nicht per E-Mail – ich leite es manuell weiter.✓ Kopiert

→ URL + Zusammenfassung; Keine Überraschungs-E-Mails verschickt

Ergebnis: Eine Rechnung, die Sie in 90 Sekunden an den Kunden senden können.

Fallstricke

Das automatische Versenden von E-Mails an Kunden aus dem Chat ist ein Trick — Verwenden Sie „auto_advance: false“ und überspringen Sie „send_invoice“, bis Sie die Rechnung überprüft haben. Der MCP sollte keine E-Mails an Produktionskunden ohne ausdrückliche Bestätigung senden
Verwechslung zwischen Test- und Live-Modus bedeutet, dass echtes Geld für einen „Test“ fließt — Überprüfen Sie vor jeder Mutation immer das API-Schlüsselpräfix („sk_test_“ vs. „sk_live_“). Lassen Sie es vom MCP zurückgeben

Kombinieren mit: supabase

Berechnen Sie den aktuellen MRR und die Abwanderung von Stripe-Abonnements

👤 Gründer, die Finanzoperationen durchführen ⏱ ~15 min intermediate

Wann einsetzen: Monatlicher Rückblick; Sie möchten eine schnelle MRR/Abwanderung direkt aus der Quelle lesen.

Ablauf

Aktive Abonnements abrufen

Listen Sie alle aktiven Stripe-Abonnements auf (Status='aktiv' oder 'Testversion'). Gruppieren Sie nach Preis-ID und summieren Sie das MRR-Äquivalent.✓ Kopiert

→ Gesamtsummen pro Preis + Gesamtsumme
Pull diesen Monat abgesagt

Listenabonnements, die in den letzten 30 Tagen gekündigt wurden. Geben Sie jeweils das Startdatum, den MRR-Beitrag und den Kunden an.✓ Kopiert

→ Abwanderungsliste mit Auswirkungen auf den Umsatz
Berechnen Sie die neue Netto-MRR

Netto-Neu-MRR = neu in diesem Monat – Abwanderung in diesem Monat. Berechnen und schreiben Sie eine dreizeilige Zusammenfassung.✓ Kopiert

→ Einzelne Zahl mit Berechnungsaufschlüsselung

Ergebnis: Eine genaue MRR-Momentaufnahme, die Sie in Ihre monatliche Überprüfung einfügen können.

Fallstricke

Jahrespläne erfordern eine monatliche Normalisierung — Bei der Summierung der MRR den Jahrespreis durch 12 dividieren; Das MCP erledigt das nicht für Sie
Rabatte und Gutschriften unterscheiden sich brutto gegenüber netto — Entscheiden Sie sich für die MRR-Konvention (Brutto vs. Abzug von Rabatten) und wenden Sie diese konsequent an

Kombinieren mit: filesystem

Bearbeiten Sie eine Rückerstattung mit entsprechenden Leitplanken

👤 Support-Leads mit Rückerstattungsbefugnis ⏱ ~5 min beginner

Wann einsetzen: Der Kunde fordert eine Rückerstattung; Sie möchten den Ladevorgang überprüfen und sauber verarbeiten.

Voraussetzungen

API-Schlüssel mit „refunds:write“. — Eingeschränkter Schlüssel, nur die Mindestbereiche gewähren

Ablauf

Suchen und validieren Sie die Gebühr

Finden Sie Stripe Charge ch_xxx. Zeigen Sie Betrag, Kunde, Status und ob bereits eine Rückerstattung erfolgt ist (teilweise oder vollständig) an.✓ Kopiert

→ Gebührendetails + Rückerstattungsverlauf
Vorschau der Rückerstattung

Ich möchte 50 $ von 200 $ (teilweise) zurückerstatten. Zeigen Sie mir, wie der Rückerstattungsaufruf aussehen würde. Noch nicht ausführen.✓ Kopiert

→ Probelaufvorschau des API-Aufrufs
Bei Bestätigung ausführen

Fahren Sie mit der teilweisen Rückerstattung fort. Geben Sie die Rückerstattungs-ID und den aktualisierten Gebührenstatus zurück.✓ Kopiert

→ Rückerstattung erstellt, Belastung als teilweise_erstattet markiert

Ergebnis: Die Rückerstattung wurde sauber und mit Prüfprotokoll abgewickelt.

Fallstricke

Die Rückerstattung von mehr als der ursprünglichen Gebühr schlägt verwirrenderweise fehl — Überprüfen Sie immer den verbleibenden Rückerstattungsbetrag, bevor Sie eine Anfrage stellen. Der MCP spiegelt den Grenzwert wider
Die Rückerstattung löst einen Webhook zu Ihrer App aus – kann den internen Status doppelt aktualisieren — Koordinieren Sie den Rückerstattungsfluss mit demjenigen, der den Webhook-Handler verwaltet

Prüfen Sie den Kontostand und die letzten Auszahlungen vor Quartalsende

👤 Finanzen, Gründer ⏱ ~10 min intermediate

Wann einsetzen: Am Ende des Quartals möchten Sie genau wissen, was sich in Stripe befindet und was bald auf der Bank landen wird.

Ablauf

Erhalten Sie eine Aufschlüsselung des aktuellen Kontostands

Aktuelles Stripe-Guthaben anzeigen: verfügbar, ausstehend, im Transport. Aufschlüsselung nach Währung.✓ Kopiert

→ Dreifacher Saldo pro Währung
Listen Sie die letzten Auszahlungen auf

Listen Sie die Auszahlungen der letzten 90 Tage mit Datum, Betrag, Status und Eingangsdatum auf. Sortieren nach Datum absteigend.✓ Kopiert

→ Auszahlungsplan mit Gesamtbeträgen
Versöhnen Sie sich mit Ihren Büchern

Wie hoch ist der Gesamtauszahlungsbetrag in der Periode? Sagen Sie mir, was Sie in den nächsten 7 Tagen auf der Bank erwarten können.✓ Kopiert

→ Aggregierter Gesamtzeitraum + kurzfristige Prognose

Ergebnis: Eine versöhnungsbereite Zusammenfassung.

Fallstricke

Reserven und umstrittene Mittel sind nicht „verfügbar“ — Setzen Sie „balance.available“ + „balance.pending“ = Gesamtbargeld nicht gleich. Überprüfen Sie die gehaltenen Salden separat

Kombinieren mit: filesystem

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

stripe + supabase

Stripe-Webhook → Supabase-Edge-Funktion → Stripe-MCP-Abfragen zur Bereicherung der Ereignisverarbeitung

Wenn der Stripe-Webhook „invoice. payment_failed“ ausgelöst wird, ruft die Edge-Funktion Stripe MCP auf, um die letzten Gebühren des Kunden abzurufen, und fügt eine Zusammenfassung in unseren Slack-Ops-Kanal ein.✓ Kopiert

stripe + postgres

Stimmen Sie Stripe-Gebühren mit Ihrer internen Auftragsdatenbank ab

Für jede erfolgreiche Stripe-Belastung gestern finden Sie die entsprechende Zeile in unserer Tabelle „Bestellungen“ anhand der Stripe_Payment_Intent_ID. Flaggenkonflikte.✓ Kopiert

stripe + filesystem

Exportieren Sie Stripe-Daten für das Finanzteam in CSV

Exportieren Sie alle Rechnungen des letzten Quartals nach /reports/invoices-Q1-2026.csv mit Kunden-E-Mail, Betrag, Status und Datum.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

Werkzeug	Eingaben	Wann aufrufen	Kosten
list_customers / retrieve_customer / create_customer / update_customer	Stripe customer params	Kunden-CRUD	free Stripe API
list_products / create_product / update_product	product params	Produktkatalog ops	free
list_prices / create_price	price params	Preisänderungen (einmalig oder wiederkehrend)	free
list_invoices / create_invoice / finalize_invoice / pay_invoice	invoice params	Rechnungslebenszyklus	free
create_invoice_item	customer, amount, currency, description	Fügen Sie einem Rechnungsentwurf eine Zeile hinzu	free
list_payment_intents / retrieve_payment_intent	PI params	Überprüfen Sie den Zahlungsflussstatus	free
list_charges / retrieve_charge	charge params	Ladungsinspektion	free
create_refund	charge: str, amount?: int	Eine vollständige oder teilweise Rückerstattung veranlassen – im Live-Modus destruktiv	free Stripe API; refund itself moves money
create_payment_link	line_items, after_completion?	Generieren Sie eine gehostete Zahlungs-URL, die Sie an einen Kunden senden können	free
list_subscriptions / cancel_subscription / update_subscription	subscription params	Abonnementlebenszyklus	free
retrieve_balance	none	Aktueller verfügbarer/ausstehender Saldo	free
list_payouts	limit, created?	Sehen Sie sich aktuelle und bevorstehende Auszahlungen an	free
search_*	query: str (Stripe Search syntax)	Leistungsstarke Filterung über Ressourcen hinweg über die Such-API	free

Kosten & Limits

Was der Betrieb kostet

API-Kontingent: Die Stripe-API verfügt über großzügige Ratenlimits (100 Anforderungen/s live eingelesen, standardmäßig 25 Anforderungen/s im Test).
Tokens pro Aufruf: Stripe-Objekte sind tokenlastig (reichhaltig verschachtelte Daten). Verwenden Sie „erweitern“ nur bei Bedarf; Größen der Kappenliste
Kosten in €: MCP free; Stripe charges per processed payment, not per API call
Tipp: In test mode, costs are zero. In live mode, the only 'cost' that matters is accidentally-issued refunds or invoices — gate writes with --tools= filtering.

Sicherheit

Rechte, Secrets, Reichweite

Minimale Scopes: restricted key with the minimum scopes per workflow (e.g. Customers:read + Charges:read for support)

Credential-Speicherung: API key in env var STRIPE_SECRET_KEY. Never commit. Use restricted keys, not the root secret key.

Datenabfluss: All calls to api.stripe.com (TLS, PCI-handled by Stripe)

Niemals gewähren: root secret key to long-running agents API key with Refunds:write or Subscriptions:write to autonomous workflows without HITL

Live mode means real money. Always confirm key prefix (sk_live_ vs sk_test_) before any write call.
Use --tools= CLI flag (e.g. --tools=customers.read,charges.read) to restrict the MCP to a safe subset.
Webhooks update internal state — coordinate refunds and cancellations with engineering.

Fehlerbehebung

Häufige Fehler und Lösungen

401 Invalid API Key

Key wrong, revoked, or test/live mismatch. Verify in dashboard. Confirm env var is exported into the MCP client process.

Prüfen: curl https://api.stripe.com/v1/balance -u $STRIPE_SECRET_KEY:

Permission denied: this key has no access to ...

Restricted key missing the relevant scope. Edit the key in dashboard to grant the needed permission.

Refund: amount exceeds remaining refundable

Charge already partially refunded. Retrieve the charge first, check amount_refunded, refund only the remainder.

Search returns 0 results despite the object existing

Stripe Search has a propagation delay (~1 minute for newly-created objects). Use list/retrieve for very recent items.

Alternativen

Stripe vs. andere

Alternative	Wann stattdessen	Kompromiss
Stripe CLI via shell	You want webhook forwarding, fixture generation, or local testing flows	No agent ergonomics; meant for dev workflows
Direct REST API via fetch MCP	You need a feature the official MCP doesn't expose	Auth, pagination, and types are all manual; way more error-prone

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen