# 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-secret-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 : ```bash "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). 1. Trouvez les sessions client dans la liste, puis cliquez sur le menu déroulant. 1. 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 | API | | ----------------------------- | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ | | **Compte** | `get_stripe_account_info` | [Récupérer le compte](https://docs.stripe.com/api/accounts/retrieve.md) | | **Solde** | `retrieve_balance` | [Récupérer le solde](https://docs.stripe.com/api/balance/balance_retrieve.md) | | **Coupon** | `create_coupon` | [Créer un bon de réduction](https://docs.stripe.com/api/coupons/create.md) | | `list_coupons` | [Lister les coupons](https://docs.stripe.com/api/coupons/list.md) | | **Client** | `create_customer` | [Créer un client](https://docs.stripe.com/api/customers/create.md) | | `list_customers` | [Liste des clients](https://docs.stripe.com/api/customers/list.md) | | **Litige** | `list_disputes` | [Lister les litiges](https://docs.stripe.com/api/disputes/list.md) | | `update_dispute` | [Mettre à jour le litige](https://docs.stripe.com/api/disputes/update.md) | | **Facture** | `create_invoice` | [Créer une facture](https://docs.stripe.com/api/invoices/create.md) | | `create_invoice_item` | [Créer un poste de facture](https://docs.stripe.com/api/invoiceitems/create.md) | | `finalize_invoice` | [Finaliser la facture](https://docs.stripe.com/api/invoices/finalize.md) | | `list_invoices` | [Lister les factures](https://docs.stripe.com/api/invoices/list.md) | | **Lien de paiement** | `create_payment_link` | [Créer un lien de paiement](https://docs.stripe.com/api/payment-link/create.md) | | **PaymentIntent** | `list_payment_intents` | [Répertoire des PaymentIntents](https://docs.stripe.com/api/payment_intents/list.md) | | **Tarif** | `create_price` | [Créer un prix](https://docs.stripe.com/api/prices/create.md) | | `list_prices` | [Lister les prix](https://docs.stripe.com/api/prices/list.md) | | **Produit** | `create_product` | [Créer un produit](https://docs.stripe.com/api/products/create.md) | | `list_products` | [Lister les produits](https://docs.stripe.com/api/products/list.md) | | **Remboursement** | `create_refund` | [Créer un remboursement](https://docs.stripe.com/api/refunds/create.md) | | **Abonnement** | `cancel_subscription` | [Annuler l’abonnement](https://docs.stripe.com/api/Subscriptions/cancel.md) | | `list_subscriptions` | [Lister les abonnements](https://docs.stripe.com/api/Subscriptions/list.md) | | `update_subscription` | [Mettre à niveau un abonnement](https://docs.stripe.com/api/Subscriptions/update.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 | ## Demander l’accès à Agentic Treasury Avec Agentic Treasury, votre agent d’IA peut transférer des fonds, payer des factures ou créer et gérer des cartes bancaires. Veuillez saisir votre adresse e-mail ci-dessous pour demander un accès anticipé. ## See also - [Construisez sur Stripe avec l’IA](https://docs.stripe.com/building-with-ai.md) - [Ajouter Stripe à vos workflows agentiques](https://docs.stripe.com/agents.md)