# 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-secret-key) im Header `Authorization` als Bearer-Token übergeben. Ein Client könnte beispielsweise die folgende Header-Eigenschaft akzeptieren: ```bash "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). 1. Suchen Sie die Client-Sessions in der Liste und klicken Sie auf das Überlaufmenü. 1. 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 | API | | ----------------------------- | ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- | | **Konto** | `get_stripe_account_info` | [Konto aufrufen](https://docs.stripe.com/api/accounts/retrieve.md) | | **Saldo** | `retrieve_balance` | [Guthaben aufrufen](https://docs.stripe.com/api/balance/balance_retrieve.md) | | **Gutschein** | `create_coupon` | [Gutschein erstellen](https://docs.stripe.com/api/coupons/create.md) | | `list_coupons` | [Gutscheine auflisten](https://docs.stripe.com/api/coupons/list.md) | | **Kundin/Kunde** | `create_customer` | [Kundin/Kunden anlegen](https://docs.stripe.com/api/customers/create.md) | | `list_customers` | [Kundin/Kunden auflisten](https://docs.stripe.com/api/customers/list.md) | | **Zahlungsanfechtung** | `list_disputes` | [Anfechtungen auflisten](https://docs.stripe.com/api/disputes/list.md) | | `update_dispute` | [Anfechtung aktualisieren](https://docs.stripe.com/api/disputes/update.md) | | **Rechnung** | `create_invoice` | [Rechnung erstellen](https://docs.stripe.com/api/invoices/create.md) | | `create_invoice_item` | [Rechnungsposten erstellen](https://docs.stripe.com/api/invoiceitems/create.md) | | `finalize_invoice` | [Rechnung abschließen](https://docs.stripe.com/api/invoices/finalize.md) | | `list_invoices` | [Rechnungen auflisten](https://docs.stripe.com/api/invoices/list.md) | | **Zahlungslink** | `create_payment_link` | [Zahlungslink erstellen](https://docs.stripe.com/api/payment-link/create.md) | | **PaymentIntent** | `list_payment_intents` | [PaymentIntents auflisten](https://docs.stripe.com/api/payment_intents/list.md) | | **Preis** | `create_price` | [Preis erstellen](https://docs.stripe.com/api/prices/create.md) | | `list_prices` | [Listenpreise](https://docs.stripe.com/api/preise/liste.md) | | **Produkt** | `create_product` | [Produkt erstellen](https://docs.stripe.com/api/products/create.md) | | `list_products` | [Produkte auflisten](https://docs.stripe.com/api/products/list.md) | | **Rückerstattung** | `create_refund` | [Rückerstattung erstellen](https://docs.stripe.com/api/refunds/create.md) | | **Abonnement** | `cancel_subscription` | [Abonnement kündigen](https://docs.stripe.com/api/subscriptions/cancel.md) | | `list_subscriptions` | [Abonnements auflisten](https://docs.stripe.com/api/subscriptions/list.md) | | `update_subscription` | [Abonnement aktualisieren](https://docs.stripe.com/api/subscriptions/update.md) | | **Sonstiges** | `search_stripe_resources` | [Stripe-Ressourcen durchsuchen](https://docs.stripe.com/search.md) | | `fetch_stripe_resources` | Stripe Objekt abrufen | | `search_stripe_documentation` | Stripe-Wissensdatenbank durchsuchen | ## Zugang zu Agentic Treasury beantragen Mit Agentic Treasury kann Ihr KI-Agent Geld überweisen, Rechnungen bezahlen oder Karten erstellen und verwalten. Geben Sie unten Ihre E-Mail-Adresse ein, um einen frühen Zugang zu beantragen. ## See also - [Mit KI auf Stripe aufbauen](https://docs.stripe.com/building-with-ai.md) - [Stripe zu Ihren Agent-Workflows hinzufügen](https://docs.stripe.com/agents.md)