# Model Context Protocol (MCP) Nutzen Sie unseren MCP-Server, damit Ihre KI-Agenten mit der Stripe-API interagieren können. Der Server Stripe Model Context Protocol (MCP) bietet eine Reihe von Tools, die KI-Agenten verwenden können, um mit der Stripe API zu interagieren und unsere Wissensdatenbank (einschließlich Dokumentation und Support-Artikel) zu durchsuchen. ## Mit dem MCP-Server von Stripe verbinden #### Cursor [In Cursor installieren](cursor://anysphere.cursor-deeplink/mcp/install?name=stripe&config=eyJ1cmwiOiJodHRwczovL21jcC5zdHJpcGUuY29tIn0%3D) Um den Cursor zu öffnen und den Stripe-MCP automatisch hinzuzufügen, klicken Sie auf Installieren. Alternativ können Sie Ihrer `~/.cursor/mcp.json` Datei Folgendes hinzufügen. Weitere Informationen finden Sie in der Cursor-[Dokumentation](https://docs.cursor.com/context/model-context-protocol). ```json { "mcpServers": {"stripe": { "url": "https://mcp.stripe.com" } } } ``` #### VS-Code [In VS-Code installieren](https://vscode.dev/redirect/mcp/install?name=stripe&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.stripe.com%22%7D) Um VS-Code zu öffnen und den Stripe-MCP automatisch hinzuzufügen, klicken Sie auf Installieren. Alternativ können Sie Ihrer `.vscode/mcp.json`-Datei in Ihrem Arbeitsbereich Folgendes hinzufügen. Weitere Informationen finden Sie in der [Dokumentation](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) zum VS-Code. ```json { "servers": {"stripe": { "type": "http", "url": "https://mcp.stripe.com" } } } ``` #### Claude-Code Führen Sie den folgenden Befehl aus, um MCP zum Claude-Code hinzuzufügen. Weitere Informationen finden Sie in der [Dokumentation](https://docs.anthropic.com/en/docs/claude-code/mcp#configure-mcp-servers) zum Claude-Code. ```bash claude mcp add --transport http stripe https://mcp.stripe.com/ ``` Nachdem Sie den Server zu Claude hinzugefügt haben, müssen Sie sich bei Stripe authentifizieren. ```bash claude /mcp ``` #### ChatGPT Sie können MCP-Server in ChatGPT aktivieren, wenn Sie ein Pro-, Plus-, Business-, Enterprise- oder Education-Konto haben. Anweisungen finden Sie in der [OpenAI-Dokumentation](https://platform.openai.com/docs/guides/developer-mode). Verwenden Sie die folgenden Parameter, wenn Sie Ihren benutzerdefinierten Connector einrichten: - Die Server-URL ist `https://mcp.stripe.com`. - Verwenden Sie „OAuth“ als Verbindungsmechanismus. Der MCP-Server von Stripe arbeitet auch mit der Response API von Open AI zusammen, wenn [autonome Agenten](https://docs.stripe.com/mcp.md#agents) erstellt werden. #### Sonstiges MCP ist ein offenes Protokoll, das von vielen Clients unterstützt wird. Ihre spezifische Client-Dokumentation kann Ihnen Hinweise dazu geben, wie Sie die Verbindung erstellen. Verwenden Sie nach Möglichkeit die Server-URL `https://mcp.stripe.com` und „OAuth“ als Verbindungsmechanismus. Wenn Ihr MCP-Client OAuth nicht unterstützt, können Sie einen [eingeschränkten API Schlüssel](https://docs.stripe.com/keys.md#create-restricted-api-key) im Header `Authorization` als Bearer-Token übergeben. Ein Client könnte beispielsweise die folgende Header-Eigenschaft akzeptieren: ```json { "stripe": { "url": "https://mcp.stripe.com", "headers": { "Authorization": "Bearer <>" } } } ``` Nach der Installation können Sie Ihre MCP-Client-Sitzungen in den Dashboard-Einstellungen verwalten. ### Verwaltung von MCP-Client-Sitzungen Der MCP-Server von Stripe verwendet OAuth zum Verbinden von MCP-Clients gemäß der [MCP-Spezifikation](https://modelcontextprotocol.io/specification/2025-03-26/basic/authorization#2-1-1-oauth-grant-types). OAuth ist sicherer als die Verwendung Ihres Geheimschlüssels, da es detailliertere Berechtigungen und Nutzer-basierte Autorisierung ermöglicht. Wenn Sie den Stripe-MCP zu einem Client hinzufügen, öffnet der MCP-Client ein OAuth Zustimmungsformular, mit dem Sie den Client für den Zugriff auf Ihre Stripe-Daten autorisieren können. Um autorisierte OAuth-Client-Sessions anzuzeigen, navigieren Sie zu Ihren [Benutzereinstellungen](https://dashboard.stripe.com/settings/user) im Stripe-Dashboard. Wenn Sie einen MCP-Client autorisiert haben, wird er unter **OAuth-Sessions** angezeigt. Um den OAuth-Zugriff für eine bestimmte MCP-Client-Session zu widerrufen: 1. Scrollen Sie zum Abschnitt OAuth-Sessions in Ihrem [Benutzereinstellungen](https://dashboard.stripe.com/settings/user). 2. Suchen Sie die Client-Sessions in der Liste und klicken Sie auf das Überlaufmenü. 3. Wählen Sie **Zugriff widerrufen**. ### MCP-Zugriff verwalten Administratoren können den [MCP-Zugriff](https://dashboard.stripe.com/settings/mcp) im Dashboard aktivieren. Der Zugriff wird getrennt zwischen Sandbox und Live-Modus verwaltet. ### Aufbau autonomer Agenten Wenn Sie Agentensoftware entwickeln, können Sie einen Stripe-API-Schlüssel als Inhaber-Token an den MCP-Remote-Server übergeben. Wir empfehlen dringend, [eingeschränkte API-Schlüssel](https://docs.stripe.com/keys/restricted-api-keys.md) zu verwenden, um den Zugriff Ihres Agenten auf genau die Funktionalität zu beschränken, die er benötigt. Sie können diese Autorisierungsmethode beispielsweise mit der [OpenAI Responses API](https://platform.openai.com/docs/guides/tools-remote-mcp#authentication) verwenden. Betten Sie keine eingeschränkten oder geheimen API-Schlüssel in Code ein. Stellen Sie Ihrem Agenten stattdessen API-Schlüssel über einen Geheimschlüsseltresor oder eine Umgebungsvariable zur Verfügung. Informationen zur sicheren Verwaltung von Schlüsseln finden Sie unter [Best Practices für die Verwaltung von API-Geheimschlüsseln](https://docs.stripe.com/keys-best-practices.md). ```bash curl https://mcp.stripe.com/ \ -H "Content-Type: application/json" \ -H "Authorization: Bearer <>" \ -d '{ "jsonrpc": "2.0", "method": "tools/call", "params": { "name": "create_customer", "arguments": {"name": "Jenny Rosen", "email": "jenny.rosen@example.com" } }, "id": 1 }' ``` ### Einen lokalen MCP-Server betreiben Wenn Sie eine lokale Einrichtung bevorzugen oder benötigen, führen Sie den [lokalen Stripe MCP-Server](https://github.com/stripe/ai/tree/main/tools/modelcontextprotocol) aus. #### Cursor [In Cursor installieren](cursor://anysphere.cursor-deeplink/mcp/install?name=stripe&config=eyJlbnYiOnsiU1RSSVBFX1NFQ1JFVF9LRVkiOiIifSwiY29tbWFuZCI6Im5weCAteSBAc3RyaXBlL21jcCJ9) Um Cursor zu öffnen und das Stripe-MCP automatisch hinzuzufügen, klicken Sie auf „Installieren“. Alternativ können Sie Ihrer Datei `~/.cursor/mcp.json` Folgendes hinzufügen. Weitere Informationen finden Sie in der Cursor-[Dokumentation](https://cursor.com/docs/context/mcp/directory). ```json { "mcpServers": {"stripe": { "command": "npx", "args": ["-y", "@stripe/mcp@latest"], "env": { "STRIPE_SECRET_KEY": "<>" } } } } ``` Der Code-Editor-Agent erkennt automatisch alle verfügbaren Tools und ruft das entsprechende Tool auf, wenn Sie eine entsprechende Frage im Chat stellen. #### VS-Code [In VS-Code installieren](https://vscode.dev/redirect/mcp/install?name=stripe&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22stripe_secret_key%22%2C%22description%22%3A%22Stripe%20secret%20API%20key%22%2C%22password%22%3Atrue%7D%5D&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40stripe%2Fmcp%22%5D%2C%22env%22%3A%7B%22STRIPE_SECRET_KEY%22%3A%22%24%7Binput%3Astripe_secret_key%7D%22%7D%7D) Um VS-Code zu öffnen und den Stripe-MCP automatisch hinzuzufügen, klicken Sie auf Installieren. Alternativ können Sie Ihrer `.vscode/mcp.json`-Datei in Ihrem Arbeitsbereich Folgendes hinzufügen. Weitere Informationen finden Sie in der [Dokumentation](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) zum VS-Code. ```json { "servers": {"stripe": { "command": "npx", "args": ["-y", "@stripe/mcp@latest"], "env": { "STRIPE_SECRET_KEY": "<>" } } } } ``` #### Windsurf Fügen Sie Folgendes zu Ihrer Datei `~/.codeium/windsurf/mcp_config.json` hinzu. Weitere Informationen finden Sie in der Windsurf [Dokumentation](https://docs.windsurf.com/windsurf/cascade/mcp). ```json { "mcpServers": {"stripe": { "command": "npx", "args": ["-y", "@stripe/mcp@latest"], "env": { "STRIPE_SECRET_KEY": "<>" } } } } ``` #### Claude Fügen Sie Folgendes zu Ihrer Datei `claude_desktop_config.json` hinzu. Weitere Informationen finden Sie in der Claude Desktop [Dokumentation](https://modelcontextprotocol.io/quickstart/user). ```json { "mcpServers": {"stripe": { "command": "npx", "args": ["-y", "@stripe/mcp@latest"], "env": { "STRIPE_SECRET_KEY": "<>" } } } } ``` #### CLI Starten Sie den MCP-Server lokal mit dem folgenden Befehl: ```bash npx -y @stripe/mcp@latest --api-key=<> ``` Der MCP-Server verwendet entweder die übergebene Umgebungsvariable `--api-key` oder die Umgebungsvariable `STRIPE_SECRET_KEY`. ## Tools Der Server stellt die folgenden [MCP-Tools](https://modelcontextprotocol.io/docs/concepts/tools) zur Verfügung. Wir empfehlen, die Bestätigung der Tools durch den Menschen zu aktivieren und bei der Verwendung des Stripe-MCP mit anderen Servern Vorsicht walten zu lassen, um Prompt-Injection-Angriffe zu vermeiden. Wenn Sie Feedback geben oder weitere Tools sehen möchten, senden Sie uns eine E-Mail an [mcp@stripe.com](mailto:mcp@stripe.com). | Ressource | Werkzeug | Beschreibung | | ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- | | **API-Tools** | `stripe_api_search` | Nach Stripe-API-Methoden nach Stichwort suchen | | `stripe_api_details` | Detaillierte Parameterinformationen für eine bestimmte Stripe-API-Methode abrufen. | | `stripe_api_read` | Daten mit einer beliebigen Stripe-API-Methode für `GET` lesen | | `stripe_api_write` | Daten mit einer beliebigen Stripe-API-Methode für `POST`, `PATCH`, `PUT` und `DELETE` schreiben | | **Konto** | `get_stripe_account_info` | [Konto aufrufen](https://docs.stripe.com/api/accounts/retrieve.md) | | **Rückerstattung** | `create_refund` | [Rückerstattung erstellen](https://docs.stripe.com/api/refunds/create.md) | | **Sonstiges** | `search_stripe_resources` | [Stripe-Ressourcen durchsuchen](https://docs.stripe.com/search.md) | | `fetch_stripe_resources` | Stripe Objekt abrufen | | `search_stripe_documentation` | Die Stripe-Dokumentation nach der angegebenen Frage und Sprache durchsuchen | | `stripe_implementation_planner` | Führt Nutzer/innen durch Stripe-Produkte, um ihnen zu helfen, Zahlungen zu akzeptieren, Produkte online zu verkaufen, die Abrechnung einzurichten oder eine beliebige Stripe-Integration zu erstellen | | `send_stripe_mcp_feedback` | Feedback von Nutzer/innen oder Agenten zu den MCP-Server-Tools von Stripe einreichen | | `stripe_report` | Berichte und Berichtsläufe suchen, abrufen und erstellen | Der Stripe-MCP-Server stellt mehrere APIs bereit, die Sie mit den Tools `stripe_api_read` und `stripe_api_write` aufrufen können. Durch diesen Zugriff ist ein Großteil der API über MCP verfügbar, ohne das Kontextfenster unnötig zu vergrößern. ### Unterstützte API-Methoden - [Alle Kundinnen und Kunden auflisten](https://docs.stripe.com/api/customers/list.md) - [Eine Kundin/einen Kunden abrufen](https://docs.stripe.com/api/customers/retrieve.md) - [Kunden/Kundin erstellen](https://docs.stripe.com/api/customers/create.md) - [Alle Abbuchungen auflisten](https://docs.stripe.com/api/charges/list.md) - [Eine Abbuchung abrufen](https://docs.stripe.com/api/charges/retrieve.md) - [Alle Rückerstattungen auflisten](https://docs.stripe.com/api/refunds/list.md) - [Rückerstattung erstellen](https://docs.stripe.com/api/refunds/create.md) - [Alle PaymentIntents auflisten](https://docs.stripe.com/api/payment_intents/list.md) - [Einen PaymentIntent abrufen](https://docs.stripe.com/api/payment_intents/retrieve.md) - [Alle Checkout Sessions auflisten](https://docs.stripe.com/api/checkout/sessions/list.md) - [Eine Checkout Session abrufen](https://docs.stripe.com/api/checkout/sessions/retrieve.md) - [Alle Rechnungen auflisten](https://docs.stripe.com/api/invoices/list.md) - [Eine Rechnung abrufen](https://docs.stripe.com/api/invoices/retrieve.md) - [Rechnung erstellen](https://docs.stripe.com/api/invoices/create.md) - [Eine Rechnung abschließen](https://docs.stripe.com/api/invoices/finalize.md) - [Einen Rechnungsposten erstellen](https://docs.stripe.com/api/invoiceitems/create.md) - [Abonnements auflisten](https://docs.stripe.com/api/subscriptions/list.md) - [Ein Abonnement abrufen](https://docs.stripe.com/api/subscriptions/retrieve.md) - [Abonnement aktualisieren](https://docs.stripe.com/api/subscriptions/update.md) - [Abonnement kündigen](https://docs.stripe.com/api/subscriptions/cancel.md) - [Alle Gutscheine auflisten](https://docs.stripe.com/api/coupons/list.md) - [Einen Gutschein abrufen](https://docs.stripe.com/api/coupons/retrieve.md) - [Gutschein erstellen](https://docs.stripe.com/api/coupons/create.md) - [Gutschein aktualisieren](https://docs.stripe.com/api/coupons/update.md) - [Gutschein löschen](https://docs.stripe.com/api/coupons/delete.md) - [Alle Aktionscodes auflisten](https://docs.stripe.com/api/promotion_codes/list.md) - [Aktionscode erstellen](https://docs.stripe.com/api/promotion_codes/create.md) - [Alle Produkte auflisten](https://docs.stripe.com/api/products/list.md) - [Produkt erstellen](https://docs.stripe.com/api/products/create.md) - [Produkt aktualisieren](https://docs.stripe.com/api/products/update.md) - [Alle Preise auflisten](https://docs.stripe.com/api/prices/list.md) - [Einen Preis abrufen](https://docs.stripe.com/api/prices/retrieve.md) - [Einen Preis erstellen](https://docs.stripe.com/api/prices/create.md) - [Preis aktualisieren](https://docs.stripe.com/api/prices/update.md) - [Alle Zahlungslinks auflisten](https://docs.stripe.com/api/payment_links/list.md) - [Einen Zahlungslink abrufen](https://docs.stripe.com/api/payment_links/retrieve.md) - [Die Posten eines Zahlungslinks abrufen](https://docs.stripe.com/api/payment_links/line_items.md) - [Einen Zahlungslink erstellen](https://docs.stripe.com/api/payment_links/create.md) - [Einen Zahlungslink aktualisieren](https://docs.stripe.com/api/payment_links/update.md) - [Alle Streitfälle auflisten](https://docs.stripe.com/api/disputes/list.md) - [Einen Streitfall aktualisieren](https://docs.stripe.com/api/disputes/update.md) - [Portal-Konfigurationen auflisten](https://docs.stripe.com/api/billing_portal/configurations/list.md) - [Guthaben abrufen](https://docs.stripe.com/api/balance/retrieve.md) ## Support für verbundene Konten Connect-Plattformen können MCP-Aufrufe als ihre verbundenen Konten tätigen. Sie können jedoch nicht OAuth verwenden. Nutzen Sie stattdessen [eingeschränkte Zugriffsschlüssel](https://docs.stripe.com/keys/restricted-api-keys.md#create-a-restricted-api-key) mit den entsprechenden Connect-Berechtigungen. Übergeben Sie den Header `Stripe-Account`, um einen MCP-Aufruf als verbundenes Konto zu tätigen. Dies ist nützlich, wenn Sie einen Agenten bereitstellen, mit dem Ihre verbundenen Konten über Ihre Plattform MCP-Aufrufe tätigen können. ```json { "mcpServers": { "stripe": { "url": "https://mcp.stripe.com", "headers": { "Authorization": "Bearer rk_.....", "Stripe-Account": "acct_xxxxxxxxx" } } } } ``` ## Agentenbasierte Finanzen mit Treasury Sie können den Stripe-MCP-Server mit Treasury-Tools erweitern, die es Ihrem KI-Agenten ermöglichen, Geld zu bewegen, Rechnungen zu bezahlen sowie Karten zu erstellen und zu verwalten. ### Haben Sie Interesse am agentenbasierten Finanzwesen mit Treasury? Enter your email to request access. ```bash curl https://docs.stripe.com/preview/register \ -X POST \ -H "Content-Type: application/json" \ -H "Referer: https://docs.stripe.com/mcp" \ -d '{"email": "EMAIL", "preview": "agentic_treasury_preview"}' ``` ## See also - [Mit KI auf Stripe aufbauen](https://docs.stripe.com/agents.md)