# 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). ## Se connecter au serveur MCP de Stripe #### Cursor [Install in Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=stripe&config=eyJ1cmwiOiJodHRwczovL21jcC5zdHJpcGUuY29tIn0%3D) Pour ouvrir Cursor et ajouter automatiquement le Stripe MCP, cliquez sur Installer. Vous pouvez également ajouter le contenu suivant à votre fichier `~/.cursor/mcp.json`. Pour en savoir plus, consultez la [documentation](https://docs.cursor.com/context/model-context-protocol) Cursor. ```json { "mcpServers": {"stripe": { "url": "https://mcp.stripe.com" } } } ``` #### 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) Pour ouvrir VS Code et ajouter automatiquement le Stripe MCP, cliquez sur Installer. Vous pouvez également ajouter le contenu suivant à votre fichier `.vscode/mcp.json` dans votre espace de travail. Pour en savoir plus, consultez la [documentation](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) VS Code. ```json { "servers": {"stripe": { "type": "http", "url": "https://mcp.stripe.com" } } } ``` #### Code Claude Pour ajouter MCP à Claude Code, exécutez la commande suivante. Pour en savoir plus, consultez la [documentation](https://docs.anthropic.com/en/docs/claude-code/mcp#configure-mcp-servers) Claude Code. ```bash claude mcp add --transport http stripe https://mcp.stripe.com/ ``` Après avoir ajouté le serveur à Claude, vous devez vous authentifier auprès de Stripe. ```bash claude /mcp ``` #### ChatGPT Vous pouvez activer les serveurs MCP sur ChatGPT si vous disposez d’un compte Pro, Plus, Business, Enterprise ou Education. Suivez les instructions fournies dans la [Documentation d’OpenAI](https://platform.openai.com/docs/guides/developer-mode). Utilisez les paramètres suivants lors de la configuration de votre connecteur personnalisé : - L’url du serveur est `https://mcp.stripe.com`. - Utilisez « OAuth » comme mécanisme de connexion. Le serveur MCP de Stripe fonctionne également avec l’API de réponse d’Open AI lors de la création [Agents autonomes](https://docs.stripe.com/mcp.md#agents). #### Autre MCP est un protocole ouvert pris en charge par de nombreux clients. La documentation spécifique de votre client peut vous indiquer comment vous connecter. Utiliser l’URL du serveur `https://mcp.stripe.com` et « OAuth » comme mécanisme de connexion si possible. Si votre client MCP ne prend pas en charge OAuth, vous pouvez transmettre une [clé API restreinte](https://docs.stripe.com/keys.md#create-restricted-api-key) dans l’en-tête `Autorisation` en tant que token Bearer. Par exemple, un client peut accepter la propriété d’en-tête suivante : ```json { "stripe": { "url": "https://mcp.stripe.com", "headers": { "Authorization": "Bearer <>" } } } ``` Après l’installation, vous pouvez gérer les sessions client MCP dans les paramètres de votre Dashboard. ### Gérer les sessions client MCP Le serveur Stripe MCP utilise OAuth pour connecter les clients MCP en fonction de la [Spécification MCP](https://modelcontextprotocol.io/specification/2025-03-26/basic/authorization#2-1-1-oauth-grant-types). OAuth est plus sécurisé que l’utilisation de votre clé secrète, car il permet des autorisations plus granulaires et une autorisation basée sur l’utilisateur. Lorsque vous ajoutez le Stripe MCP à un client, celui-ci ouvre un formulaire de consentement OAuth qui vous permet d’autoriser le client à accéder à vos données Stripe. Pour afficher les sessions client OAuth autorisées, accédez à vos [paramètres utilisateur](https://dashboard.stripe.com/settings/user) dans le Dashboard Stripe. Si vous avez autorisé un client MCP, il s’affichera sous **sessions OAuth**. Pour révoquer l’accès OAuth pour une session client MCP spécifique : 1. Faites défiler l’écran vers la section sessions OAuth dans vos [paramètres utilisateur](https://dashboard.stripe.com/settings/user). 2. Trouvez les sessions client dans la liste, puis cliquez sur le menu déroulant. 3. Sélectionner **Révoquer l’accès**. ### Gérer l’accès à MCP Les administrateurs peuvent [activer l’accès à MCP](https://dashboard.stripe.com/settings/mcp) dans le Dashboard. L’accès est géré séparément entre l’environnement de test et l’environnement en mode production. ### Création d'agents autonomes Si vous construisez un logiciel agentique, vous pouvez passer une clé Stripe API comme jeton porteur au serveur distant MCP. Nous vous recommandons fortement d’utiliser des [clefs API restreintes](https://docs.stripe.com/keys/restricted-api-keys.md) pour limiter l’accès de votre agent aux fonctionnalités dont il a besoin. Par exemple, vous pouvez utiliser cette méthode d’autorisation avec l’[API Responses de OpenAI](https://platform.openai.com/docs/guides/tools-remote-mcp#authentication). N’intégrez pas de clés limitées ou secrètes d’API dans du code. Fournissez plutôt des clés d’API à votre agent par le biais d’un coffre-fort secret ou d’une variable d’environnement. Pour apprendre à gérer les clés en toute sécurité, consultez les [bonnes pratiques en matière de gestion des clés secrètes d’API](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 }' ``` ### Exécuter un serveur MCP local Si vous préférez ou avez besoin d’une configuration locale, exécutez le [serveur MCP Stripe local](https://github.com/stripe/ai/tree/main/tools/modelcontextprotocol). #### Cursor [Installer dans Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=stripe&config=eyJlbnYiOnsiU1RSSVBFX1NFQ1JFVF9LRVkiOiIifSwiY29tbWFuZCI6Im5weCAteSBAc3RyaXBlL21jcCJ9) Pour ouvrir Cursor et ajouter automatiquement Stripe MCP, cliquez sur Installer. Vous pouvez également ajouter le contenu suivant à votre fichier `~/.cursor/mcp.json`. Pour en savoir plus, consultez la [documentation](https://cursor.com/docs/context/mcp/directory) de Cursor. ```json { "mcpServers": {"stripe": { "command": "npx", "args": ["-y", "@stripe/mcp@latest"], "env": { "STRIPE_SECRET_KEY": "<>" } } } } ``` L’agent de l’éditeur de code détecte automatiquement tous les outils disponibles, appelant l’outil concerné lorsque vous publiez une question connexe dans le chat. #### VS Code [Install in VS Code](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) Pour ouvrir VS Code et ajouter automatiquement le Stripe MCP, cliquez sur Installer. Vous pouvez également ajouter le contenu suivant à votre fichier `.vscode/mcp.json` dans votre espace de travail. Pour en savoir plus, consultez la [documentation](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) VS Code. ```json { "servers": {"stripe": { "command": "npx", "args": ["-y", "@stripe/mcp@latest"], "env": { "STRIPE_SECRET_KEY": "<>" } } } } ``` #### Windsurf Ajoutez le contenu suivant à votre fichier `~/.codeium/windsurf/mcp_config.json`. Pour en savoir plus, consultez la [documentation](https://docs.windsurf.com/windsurf/cascade/mcp) Windsurf. ```json { "mcpServers": {"stripe": { "command": "npx", "args": ["-y", "@stripe/mcp@latest"], "env": { "STRIPE_SECRET_KEY": "<>" } } } } ``` #### Claude Ajoutez le contenu suivant à votre fichier `claude_desktop_config.json`. Pour en savoir plus, consultez la [documentation](https://modelcontextprotocol.io/quickstart/user) Claude Desktop. ```json { "mcpServers": {"stripe": { "command": "npx", "args": ["-y", "@stripe/mcp@latest"], "env": { "STRIPE_SECRET_KEY": "<>" } } } } ``` #### Interface de ligne de commande Démarrez le serveur MCP localement avec cette commande : ```bash npx -y @stripe/mcp@latest --api-key=<> ``` Le serveur MCP utilise soit la variable d’environnement `--api-key` transmise, soit la variable d’environnement `STRIPE_SECRET_KEY`. ## 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) | | **Autres** | `search_stripe_resources` | [Rechercher ressources Stripe](https://docs.stripe.com/search.md) | | `fetch_stripe_resources` | Récupérer l’objet Stripe | | `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) - [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](https://docs.stripe.com/api/refunds/list.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) - [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) - [Créer une facture](https://docs.stripe.com/api/invoices/create.md) - [Finaliser une facture](https://docs.stripe.com/api/invoices/finalize.md) - [Créer un poste de facture](https://docs.stripe.com/api/invoiceitems/create.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) - [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 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) - [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) - [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) - [Mettre à jour un litige](https://docs.stripe.com/api/disputes/update.md) - [Lister les configurations de portail](https://docs.stripe.com/api/billing_portal/configurations/list.md) - [Récupérer le solde](https://docs.stripe.com/api/balance/retrieve.md) ## 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" } } } } ``` ## Finance agentique avec Treasury Vous pouvez étendre le serveur MCP Stripe avec des outils Treasury qui permettent à votre agent d’IA de transférer des fonds, de payer des factures, et de créer et gérer des cartes. ### La finance agentique avec Treasury vous intéresse ? 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 - [Construisez sur Stripe avec l’IA](https://docs.stripe.com/agents.md)