# Modèle de protocole contextuel (MCP) Laissez vos agents d'IA interagir avec l'API Stripe en utilisant notre serveur MCP. Le serveur MCP (Model Context Protocol) de Stripe fournit un ensemble d’outils que les agents d’IA peuvent utiliser pour interagir avec l’API Stripe et effectuer des recherches dans notre base de connaissances (y compris la documentation et les articles de prise en charge). Cette page explique comment connecter votre agent ou IDE au serveur MCP de Stripe. Si vous créez votre propre application MCP ou interface de chat et souhaitez accepter des paiements de ses utilisateurs, consultez plutôt [Monétiser votre application MCP](https://docs.stripe.com/agentic-commerce/apps.md). ## Connect to Stripe’s MCP server #### Cursor [Install in Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=stripe&config=eyJ1cmwiOiJodHRwczovL21jcC5zdHJpcGUuY29tIn0%3D) To open Cursor and automatically add the Stripe MCP server, click **Install**. Alternatively, add the following to your `~/.cursor/mcp.json` file. To learn more, see the Cursor [documentation](https://docs.cursor.com/context/model-context-protocol). ```json { "mcpServers": { "stripe": { "url": "https://mcp.stripe.com" } } } ``` #### Claude Code To add MCP to Claude code, run the following command. To learn more, see the Claude Code [documentation](https://docs.anthropic.com/en/docs/claude-code/mcp#configure-mcp-servers). ```bash claude mcp add --transport http stripe https://mcp.stripe.com/ ``` After adding the server to Claude, you must authenticate with Stripe. ```bash claude /mcp ``` #### ChatGPT You can enable MCP servers on ChatGPT if you have a Pro, Plus, Business, Enterprise or Education account. Follow the [OpenAI documentation](https://platform.openai.com/docs/guides/developer-mode) for instructions. Use the following parameters when setting up your custom connector: - The server url is `https://mcp.stripe.com`. - Use “OAuth” as the connection mechanism. Stripe’s MCP server also works with OpenAI’s response API, when building [autonomous agents](https://docs.stripe.com/mcp.md#agents). #### Other ### VS Code [Install in VS Code](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) To open VS Code and automatically add the Stripe MCP server, click **Install**. Alternatively, add the following to your workspace `.vscode/mcp.json` file. To learn more, see the VS Code [documentation](https://code.visualstudio.com/docs/copilot/chat/mcp-servers). ```json { "servers": { "stripe": { "type": "http", "url": "https://mcp.stripe.com" } } } ``` ### Custom MCP is an open protocol that many clients support. Your client documentation can explain how to connect. If possible, use the server URL `https://mcp.stripe.com` and OAuth as the connection mechanism. If your MCP client doesn’t support OAuth, you can pass a [restricted API key](https://docs.stripe.com/keys.md#create-restricted-api-key) in the `Authorization` header as a bearer token. For example, a client might accept the following header property: ```json { "stripe": { "url": "https://mcp.stripe.com", "headers": { "Authorization": "Bearer <>" } } } ``` After installing, you can manage MCP client sessions in your Dashboard settings. ### Manage MCP client sessions The Stripe MCP server uses OAuth to connect MCP clients according to the [MCP spec](https://modelcontextprotocol.io/specification/2025-03-26/basic/authorization#2-1-1-oauth-grant-types). OAuth is more secure than using your secret key because it allows more granular permissions and user based authorization. When you add the Stripe MCP to a client, the MCP client opens an OAuth consent form which allows you to authorize the client to access your Stripe data. #### Manage your own sessions To view authorized OAuth client sessions, go to your [user settings](https://dashboard.stripe.com/settings/user) in the Stripe Dashboard. If you’ve authorized an MCP client, it appears under **OAuth sessions**. To revoke OAuth access for a specific MCP client session: 1. Scroll to the OAuth sessions section in your [user settings](https://dashboard.stripe.com/settings/user). 2. Find the client sessions in the list, and click the overflow menu (⋯). 3. Select **Revoke access**. #### Manage sessions as an admin If you’re an administrator, you can view and revoke the MCP OAuth sessions of other users in your organization or account. This requires a role with permission to manage team members and OAuth sessions (for example, the **Administrator** role). To manage another user’s sessions: 1. Go to the [Team and security](https://dashboard.stripe.com/settings/team) settings page and select the team member you want to manage. 2. On the team member details page, find the **OAuth sessions** table. 3. To revoke a single session, click the overflow menu on its row and select **Revoke access**. To revoke every session in the table, select **Revoke all**. Session management is scoped to the account or organization you’re currently viewing and to the current environment, live mode or a sandbox. Revoking a session only removes access for the accounts in your current scope. If the same session also has access to accounts outside your scope, it stays active for those accounts. When you view an organization, the table includes an **Accounts** column because a session can be tied to more than one account in the organization. ### Manage MCP access Administrators can [enable MCP access](https://dashboard.stripe.com/settings/mcp) in the Dashboard. Access is managed separately between sandbox and live mode environments. ### Building autonomous agents If you’re building agentic software, you can pass a Stripe API key as a bearer token to the MCP remote server. We strongly recommend using [restricted API keys](https://docs.stripe.com/keys/restricted-api-keys.md) to limit your agent’s access to exactly the functionality it requires. For example, you can use this authorization method with [OpenAI’s Responses API](https://platform.openai.com/docs/guides/tools-remote-mcp#authentication). Don’t embed restricted or secret API keys in code. Instead, provide API keys to your agent through a secrets vault or environment variable. To learn how to manage keys safely, see [best practices for managing secret API keys](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 }' ``` ## Outils Le serveur expose les [outils MCP](https://modelcontextprotocol.io/docs/concepts/tools) suivants. Nous vous recommandons d’activer la confirmation humaine des outils et de faire preuve de prudence lorsque vous utilisez le MCP Stripe avec d’autres serveurs afin d’éviter les attaques par injection rapide. Si vous avez des commentaires ou souhaitez voir plus d’outils, envoyez-nous un e-mail à [mcp@stripe.com](mailto:mcp@stripe.com). | Ressource | Outil | Description | | --- | --- | --- | | **Outils API** | `stripe_api_search` | Rechercher des méthodes de l’API Stripe par mot-clé | | `stripe_api_details` | Obtenir des informations détaillées sur les paramètres d’une méthode spécifique de l’API Stripe. | | `stripe_api_read` | Lire des données avec n’importe quelle méthode `GET` de l’API Stripe | | `stripe_api_write` | Écrire des données avec n’importe quelle méthode `POST`, `PATCH`, `PUT` et `DELETE` de l’API Stripe | | **Compte** | `get_stripe_account_info` | [Récupérer le compte](https://docs.stripe.com/api/accounts/retrieve.md) | | **Remboursement** | `create_refund` | [Créer un remboursement](https://docs.stripe.com/api/refunds/create.md) | | **Treasury** (Public preview) | `get_balance_summary` | Affiche un récapitulatif interactif du solde Stripe et des comptes Treasury | | **Autres** | `search_stripe_documentation` | Rechercher dans la documentation Stripe pour la question et la langue données | | `stripe_implementation_planner` | Guider l’utilisateur à travers les produits Stripe pour l’aider à accepter des paiements, vendre des produits en ligne, configurer la facturation ou créer une intégration Stripe | | `send_stripe_mcp_feedback` | Envoyer les commentaires de l’utilisateur ou de l’agent sur les outils du serveur MCP de Stripe | | `stripe_report` | Rechercher, récupérer et créer des rapports et des exécutions de rapports | Le serveur MCP de Stripe expose plusieurs API que vous pouvez appeler avec les outils `stripe_api_read` et `stripe_api_write`. Cet accès rend une grande partie de l’API disponible via MCP sans augmenter inutilement la fenêtre de contexte. ### Méthodes d’API prises en charge - [Lister tous les clients](https://docs.stripe.com/api/customers/list.md) - [Récupérer un client](https://docs.stripe.com/api/customers/retrieve.md) - [Créer un client](https://docs.stripe.com/api/customers/create.md) - [Modifier un client](https://docs.stripe.com/api/customers/update.md) - [Lister tous les paiements](https://docs.stripe.com/api/charges/list.md) - [Récupérer un paiement](https://docs.stripe.com/api/charges/retrieve.md) - [Lister tous les remboursements d’un paiement (`GET /v1/charges/:charge/refunds`)](https://docs.stripe.com/api/refunds/list.md) - [Lister tous les remboursements](https://docs.stripe.com/api/refunds/list.md) - [Récupérer un remboursement](https://docs.stripe.com/api/refunds/retrieve.md) - [Créer un remboursement](https://docs.stripe.com/api/refunds/create.md) - [Lister tous les PaymentIntents](https://docs.stripe.com/api/payment_intents/list.md) - [Récupérer un PaymentIntent](https://docs.stripe.com/api/payment_intents/retrieve.md) - [Lister toutes les Checkout Sessions](https://docs.stripe.com/api/checkout/sessions/list.md) - [Récupérer une Checkout Session](https://docs.stripe.com/api/checkout/sessions/retrieve.md) - [Récupérer les postes de facture d’une session Checkout](https://docs.stripe.com/api/checkout/sessions/line_items.md) - [Lister toutes les factures](https://docs.stripe.com/api/invoices/list.md) - [Récupérer une facture](https://docs.stripe.com/api/invoices/retrieve.md) - [Récupérer les postes d’une facture](https://docs.stripe.com/api/invoice-line-item/retrieve.md) - [Créer une facture](https://docs.stripe.com/api/invoices/create.md) - [Modifier une facture](https://docs.stripe.com/api/invoices/update.md) - [Finaliser une facture](https://docs.stripe.com/api/invoices/finalize.md) - [Marquer une facture comme non recouvrable](https://docs.stripe.com/api/invoices/mark_uncollectible.md) - [Annuler une facture](https://docs.stripe.com/api/invoices/void.md) - [Lister tous les postes de facture](https://docs.stripe.com/api/invoiceitems/list.md) - [Récupérer un poste de facture](https://docs.stripe.com/api/invoiceitems/retrieve.md) - [Créer un poste de facture](https://docs.stripe.com/api/invoiceitems/create.md) - [Mettre à jour un poste de facture](https://docs.stripe.com/api/invoiceitems/update.md) - [Lister tous les paiements d’une facture](https://docs.stripe.com/api/invoice-payment/list.md) - [Lister les abonnements](https://docs.stripe.com/api/Subscriptions/list.md) - [Récupérer un abonnement](https://docs.stripe.com/api/subscriptions/retrieve.md) - [Créer un abonnement](https://docs.stripe.com/api/subscriptions/create.md) - [Modifier un abonnement](https://docs.stripe.com/api/subscriptions/update.md) - [Annuler un abonnement](https://docs.stripe.com/api/subscriptions/cancel.md) - [Lister tous les calendriers](https://docs.stripe.com/api/subscription_schedules/list.md) - [Récupérer un calendrier](https://docs.stripe.com/api/subscription_schedules/retrieve.md) - [Lister tous les éléments d’abonnement](https://docs.stripe.com/api/subscription_items/list.md) - [Lister tous les bons de réduction](https://docs.stripe.com/api/coupons/list.md) - [Récupérer un bon de réduction](https://docs.stripe.com/api/coupons/retrieve.md) - [Créer un bon de réduction](https://docs.stripe.com/api/coupons/create.md) - [Mettre à jour un bon de réduction](https://docs.stripe.com/api/coupons/update.md) - [Supprimer un bon de réduction](https://docs.stripe.com/api/coupons/delete.md) - [Lister tous les codes promotionnels](https://docs.stripe.com/api/promotion_codes/list.md) - [Récupérer un code promotionnel](https://docs.stripe.com/api/promotion_codes/retrieve.md) - [Créer un code promotionnel](https://docs.stripe.com/api/promotion_codes/create.md) - [Lister tous les produits](https://docs.stripe.com/api/products/list.md) - [Récupérer un produit](https://docs.stripe.com/api/products/retrieve.md) - [Créer un produit](https://docs.stripe.com/api/products/create.md) - [Modifier un produit](https://docs.stripe.com/api/products/update.md) - [Lister tous les prix](https://docs.stripe.com/api/prices/list.md) - [Récupérer un prix](https://docs.stripe.com/api/prices/retrieve.md) - [Créer un prix](https://docs.stripe.com/api/prices/create.md) - [Modifier un prix](https://docs.stripe.com/api/prices/update.md) - [Lister tous les liens de paiement](https://docs.stripe.com/api/payment_links/list.md) - [Récupérer un lien de paiement](https://docs.stripe.com/api/payment_links/retrieve.md) - [Récupérer les éléments d’un lien de paiement](https://docs.stripe.com/api/payment_links/line_items.md) - [Créer un lien de paiement](https://docs.stripe.com/api/payment_links/create.md) - [Mettre à jour un lien de paiement](https://docs.stripe.com/api/payment_links/update.md) - [Lister tous les litiges](https://docs.stripe.com/api/disputes/list.md) - [Récupérer un litige](https://docs.stripe.com/api/disputes/retrieve.md) - [Mettre à jour un litige](https://docs.stripe.com/api/disputes/update.md) - [Lister tous les endpoints webhook](https://docs.stripe.com/api/webhook_endpoints/list.md) - [Récupérer un endpoint webhook](https://docs.stripe.com/api/webhook_endpoints/retrieve.md) - [Créer un endpoint webhook](https://docs.stripe.com/api/webhook_endpoints/create.md) - [Lister les configurations de portail](https://docs.stripe.com/api/customer_portal/configurations/list.md) - [Récupérer une configuration de portail](https://docs.stripe.com/api/customer_portal/configurations/retrieve.md) - [Récupérer le solde](https://docs.stripe.com/api/balance/retrieve.md) - [Récupérer les paramètres de taxe](https://docs.stripe.com/api/tax/settings/retrieve.md) - [Mettre à jour les paramètres de taxe](https://docs.stripe.com/api/tax/settings/update.md) - [Lister tous les codes de taxe](https://docs.stripe.com/api/tax_codes/list.md) - [Récupérer un code de taxe](https://docs.stripe.com/api/tax_codes/retrieve.md) - [Lister toutes les immatriculations fiscales](https://docs.stripe.com/api/tax/registrations/list.md) - [Récupérer une immatriculation fiscale](https://docs.stripe.com/api/tax/registrations/retrieve.md) - [Créer une immatriculation fiscale](https://docs.stripe.com/api/tax/registrations/create.md) - [Lister toutes les opérations sur solde](https://docs.stripe.com/api/balance_transactions/list.md) - [Récupérer une opération sur solde](https://docs.stripe.com/api/balance_transactions/retrieve.md) - [Lister tous les virements](https://docs.stripe.com/api/payouts/list.md) - [Récupérer un virement](https://docs.stripe.com/api/payouts/retrieve.md) - [Lister toutes les autorisations](https://docs.stripe.com/api/issuing/authorizations/list.md) - [Récupérer une autorisation](https://docs.stripe.com/api/issuing/authorizations/retrieve.md) - [Lister tous les titulaires de la carte](https://docs.stripe.com/api/issuing/cardholders/list.md) - [Récupérer un titulaire de la carte](https://docs.stripe.com/api/issuing/cardholders/retrieve.md) - [Lister toutes les cartes bancaires](https://docs.stripe.com/api/issuing/cards/list.md) - [Récupérer une carte bancaire](https://docs.stripe.com/api/issuing/cards/retrieve.md) - [Lister tous les litiges](https://docs.stripe.com/api/issuing/disputes/list.md) - [Récupérer un litige](https://docs.stripe.com/api/issuing/disputes/retrieve.md) - [Lister toutes les transactions](https://docs.stripe.com/api/issuing/transactions/list.md) - [Récupérer une transaction](https://docs.stripe.com/api/issuing/transactions/retrieve.md) - [Lister les comptes](https://docs.stripe.com/api/v2/core/accounts/list.md) - [Récupérer un compte](https://docs.stripe.com/api/v2/core/accounts/retrieve.md) - [Lister les réajustements](https://docs.stripe.com/api/v2/money-management/adjustments/list.md?api-version=2026-05-27.preview) - [Récupérer un réajustement](https://docs.stripe.com/api/v2/money-management/adjustments/retrieve.md?api-version=2026-05-27.preview) - [Lister les comptes financiers](https://docs.stripe.com/api/v2/money-management/financial-accounts/list.md?api-version=2026-05-27.preview) - [Récupérer un compte financier](https://docs.stripe.com/api/v2/money-management/financial-accounts/retrieve.md?api-version=2026-05-27.preview) - [Lister les adresses financières](https://docs.stripe.com/api/v2/money-management/financial-addresses/list.md?api-version=2026-05-27.preview) - [Récupérer une adresse financière](https://docs.stripe.com/api/v2/money-management/financial-addresses/retrieve.md?api-version=2026-05-27.preview) - [Lister les transferts entrants](https://docs.stripe.com/api/v2/money-management/inbound-transfers/list.md?api-version=2026-05-27.preview) - [Récupérer un transfert entrant](https://docs.stripe.com/api/v2/money-management/inbound-transfers/retrieve.md?api-version=2026-05-27.preview) - [Récupérer un devis de paiement sortant](https://docs.stripe.com/api/v2/money-management/outbound-payment-quotes/retrieve.md?api-version=2026-05-27.preview) - [Lister les paiements sortants](https://docs.stripe.com/api/v2/money-management/outbound-payments/list.md?api-version=2026-05-27.preview) - [Récupérer un paiement sortant](https://docs.stripe.com/api/v2/money-management/outbound-payments/retrieve.md?api-version=2026-05-27.preview) - [Lister les intentions de configuration sortantes](https://docs.stripe.com/api/v2/money-management/outbound-setup-intents/list.md?api-version=2026-05-27.preview) - [Récupérer une intention de configuration sortante](https://docs.stripe.com/api/v2/money-management/outbound-setup-intents/retrieve.md?api-version=2026-05-27.preview) - [Lister les transferts sortants](https://docs.stripe.com/api/v2/money-management/outbound-transfers/list.md?api-version=2026-05-27.preview) - [Récupérer un transfert sortant](https://docs.stripe.com/api/v2/money-management/outbound-transfers/retrieve.md?api-version=2026-05-27.preview) - [Lister les méthodes de virement](https://docs.stripe.com/api/v2/money-management/payout-methods/list.md?api-version=2026-05-27.preview) - [Récupérer une méthode de virement](https://docs.stripe.com/api/v2/money-management/payout-methods/retrieve.md?api-version=2026-05-27.preview) - [Récupérer la spécification de compte bancaire](https://docs.stripe.com/api/v2/money-management/payout-methods-bank-account-specs/retrieve.md?api-version=2026-05-27.preview) - [Lister les crédits reçus](https://docs.stripe.com/api/v2/money-management/received-credits/list.md?api-version=2026-05-27.preview) - [Récupérer un crédit reçu](https://docs.stripe.com/api/v2/money-management/received-credits/retrieve.md?api-version=2026-05-27.preview) - [Lister les débits reçus](https://docs.stripe.com/api/v2/money-management/received-debits/list.md?api-version=2026-05-27.preview) - [Récupérer un débit reçu](https://docs.stripe.com/api/v2/money-management/received-debits/retrieve.md?api-version=2026-05-27.preview) - [Lister les écritures de transaction](https://docs.stripe.com/api/v2/money-management/transaction-entries/list.md?api-version=2026-05-27.preview) - [Récupérer une écriture de transaction](https://docs.stripe.com/api/v2/money-management/transaction-entries/retrieve.md?api-version=2026-05-27.preview) - [Lister les transactions](https://docs.stripe.com/api/v2/money-management/transactions/list.md?api-version=2026-05-27.preview) - [Récupérer une transaction](https://docs.stripe.com/api/v2/money-management/transactions/retrieve.md?api-version=2026-05-27.preview) ## Prise en charge des comptes connectés Les plateformes Connect peuvent effectuer des appels MCP en tant que comptes connectés. Cependant, vous ne pouvez pas utiliser OAuth. Utilisez plutôt des [clés d’accès limité](https://docs.stripe.com/keys/restricted-api-keys.md#create-a-restricted-api-key) avec les autorisations Connect appropriées. Pour effectuer un appel MCP en tant que compte connecté, transmettez l’en-tête `Stripe-Account`. Cela est utile lorsque vous fournissez un agent qui permet à vos comptes connectés d’effectuer des appels MCP via votre plateforme. ```json { "mcpServers": { "stripe": { "url": "https://mcp.stripe.com", "headers": { "Authorization": "Bearer rk_.....", "Stripe-Account": "acct_xxxxxxxxx" } } } } ``` ## See also - [Construisez sur Stripe avec l’IA](https://docs.stripe.com/agents.md) - [Compétences Stripe](https://docs.stripe.com/skills.md)