Overview
Le Model Context Protocol (MCP) est un standard ouvert qui permet aux applications d’IA de se connecter à des sources de données et à des API externes. Le serveur MCP Dodo Payments permet aux assistants IA tels que Claude, Cursor et d’autres clients compatibles avec MCP d’accéder à votre infrastructure de paiement. Le serveur MCP Dodo Payments utilise une architecture Code Mode. Au lieu d’exposer des centaines d’outils individuels pour chaque endpoint d’API, Code Mode permet aux agents IA d’écrire et d’exécuter du code TypeScript avec le SDK Dodo Payments dans un sandbox isolé.Fonctionnalités principales
- Opérations de paiement — Créer, récupérer et gérer les paiements et les remboursements
- Gestion des abonnements — Gérer la facturation récurrente, les changements d’offre et les annulations
- Administration des clients — Gérer les données client et l’accès au portail
- Catalogue de produits — Créer et mettre à jour les produits, les tarifs et les remises
- Gestion des licences — Activer, valider et gérer les licences logicielles
- Facturation à l’usage — Suivre et facturer l’utilisation mesurée
How Code Mode Works
Le serveur MCP Dodo Payments fournit à votre agent IA deux outils :- Outil de recherche dans la documentation — Interroge la documentation de l’API et du SDK Dodo Payments afin de comprendre les opérations et paramètres disponibles.
- Outil d’exécution de code — Écrit du code TypeScript avec le SDK, exécuté dans un sandbox sécurisé.
Quick Setup
Connect to the Dodo Payments MCP Server in your AI client:- Agent Plugin (recommended)
- Cursor
- Claude Desktop
- Windsurf
- Claude Code
Le Dodo Agent Plugin installe les serveurs MCP ainsi que les dix-sept skills en une seule étape pour Claude Code, Codex CLI, Cursor, VS Code / GitHub Copilot, Kiro et OpenCode (OpenCode nécessite un paramètre
skills.paths supplémentaire). Gemini CLI ne reçoit que les deux serveurs MCP, car il ne dispose pas de primitive d’agent-skill. Consultez le guide des agents de programmation IA pour connaître les commandes d’installation propres à chaque agent.If your agent isn’t in that list, use the tabs below to configure the MCP server directly.Nécessite Node.js 18 ou version ultérieure. Le serveur distant utilise OAuth pour l’authentification. Lors de la première connexion, vous serez invité à saisir votre clé API et à sélectionner votre environnement.
Dodo Knowledge MCP
En plus du serveur MCP Dodo Payments (pour exécuter les opérations d’API), nous fournissons Dodo Knowledge MCP — un serveur de recherche sémantique qui donne aux assistants IA un accès instantané à la documentation Dodo Payments.Built with ContextMCP.ai: Dodo Knowledge MCP is powered by ContextMCP, enabling fast semantic search across our documentation using vector embeddings.
What is Dodo Knowledge MCP?
Dodo Knowledge MCP est un serveur MCP distant qui fournit une recherche sémantique dans la documentation. Trouvez la documentation pertinente à l’aide de requêtes en langage naturel, obtenez des informations précises et à jour sur Dodo Payments et connectez-vous sans clé API ni installation locale.Configuration rapide
Connectez-vous à Dodo Knowledge MCP depuis votre client IA :- Cursor
- Claude Desktop
- Windsurf
- Claude Code
Ajoutez à
~/.cursor/mcp.json :Nécessite Node.js 18 ou version ultérieure. Le package
mcp-remote gère la connexion au serveur MCP distant.Utiliser les deux serveurs MCP ensemble
Pour une expérience de développement assistée par IA optimale, utilisez les deux serveurs MCP :Dépannage de Knowledge MCP
Si vous rencontrez des problèmes de connexion, videz le cache d’authentification MCP avecrm -rf ~/.mcp-auth, redémarrez votre application cliente, consultez les journaux du client pour trouver les messages d’erreur et vérifiez la version de Node.js (18 ou version ultérieure requise).
Knowledge MCP Server
Accéder à la page de configuration de Dodo Knowledge MCP
Installation
Choisissez la méthode d’installation qui correspond à votre workflow.Serveur MCP distant (recommandé)
Accédez au serveur MCP hébergé sans configuration ni installation locale.1
Access the remote server
Ouvrez https://mcp.dodopayments.com dans votre navigateur.
2
Configure your MCP client
Copiez la configuration JSON fournie pour votre client spécifique. Pour Cursor ou Claude Desktop, ajoutez-la à vos paramètres MCP :
3
Authenticate and configure
Le flux OAuth vous invitera à :
- Saisir votre clé API Dodo Payments
- Sélectionner votre environnement (test ou live)
- Choisir le type de votre client MCP
4
Complete setup
Cliquez sur Login and Approve pour autoriser la connexion.
Une fois connecté, votre assistant IA peut interagir avec l’API Dodo Payments en votre nom.
Package NPM
Installez et exécutez le serveur MCP localement.- NPX (No Installation)
- MCP Client Configuration
Docker
Exécutez le serveur MCP dans un conteneur.Les images Docker sont disponibles sur GitHub Container Registry.
Configuration du client
Configurez le serveur MCP Dodo Payments dans votre client d’IA préféré.- Cursor
- Claude Desktop
- Claude Code
- VS Code
- Cline (VS Code)
- Zed
- Other Clients
Configurez le serveur MCP Dodo Payments dans Cursor pour accéder à vos données de paiement par conversation.Installation en un clicUtilisez le bouton ci-dessous pour installer directement le serveur MCP dans Cursor :[
](https://cursor.com/en-US/install-mcp?name=dodopayments-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImRvZG9wYXltZW50cy1tY3AiXSwiZW52Ijp7IkRPRE9fUEFZTUVOVFNfQVBJX0tFWSI6IlNldCB5b3VyIERPRE9fUEFZTUVOVFNfQVBJX0tFWSBoZXJlLiIsIkRPRE9fUEFZTUVOVFNfV0VCSE9PS19LRVkiOiJTZXQgeW91ciBET0RPX1BBWU1FTlRTX1dFQkhPT0tfS0VZIGhlcmUuIn19)Après avoir cliqué, définissez vos variables d’environnement dans le fichier
mcp.json de Cursor via Cursor Settings > Tools & MCP > New MCP Server.Configuration manuelle1
Open Cursor settings
Accédez à Cursor Settings > Tools & MCP ou appuyez sur
Cmd/Ctrl + Shift + P, puis recherchez « MCP Settings ».2
Edit configuration
Cliquez sur New MCP Server pour ouvrir le fichier
mcp.json.3
Add Dodo Payments configuration
Choisissez l’une des configurations suivantes :Remote Server (Recommended)Local NPX
4
Save and restart
Enregistrez le fichier de configuration et redémarrez Cursor.
Vérifiez la connexion en demandant à l’assistant d’IA des informations sur vos données Dodo Payments.
Variables d’environnement
Configurez le comportement du serveur MCP à l’aide de variables d’environnement.Exécution à distance
Déployez le serveur MCP en tant que serveur HTTP distant pour les clients web ou les workflows agentiques.Configuration du serveur distant
Une fois le serveur déployé, les clients peuvent se connecter à l’aide de l’URL du serveur :En-têtes d’autorisation
Le serveur distant accepte l’authentification via les en-têtes suivants :Bonnes pratiques de sécurité
Code Mode offre une sécurité intrinsèque en exécutant le code dans un environnement sandboxé et en injectant les clés API côté serveur. Suivez ces bonnes pratiques pour protéger vos identifiants.API Key Management
API Key Management
Ne validez jamais d’identifiants dans le contrôle de version. Stockez les clés API dans des variables d’environnement ou des systèmes sécurisés de gestion des secrets :Faites régulièrement tourner les clés en générant périodiquement de nouvelles clés API et en révoquant les anciennes depuis votre tableau de bord Dodo Payments. Utilisez toujours des clés API en mode test pendant le développement afin d’éviter d’affecter les données de production.
Access Control
Access Control
Lors d’un déploiement distant, exigez toujours une authentification via l’en-tête
Authorization ou l’en-tête x-dodo-payments-api-key.Network Security
Network Security
Déployez toujours les serveurs MCP distants derrière des points de terminaison HTTPS. Protégez-vous contre les abus en implémentant des limites de débit au niveau du serveur MCP et de l’API. Configurez des règles de pare-feu pour limiter les clients pouvant se connecter à votre serveur MCP.
Résolution des problèmes
Connection issues
Connection issues
Vérifiez que votre clé API est correctement définie et dispose des autorisations nécessaires :Vérifiez que vous pouvez atteindre les points de terminaison de l’API Dodo Payments. Activez la journalisation détaillée dans votre client MCP pour diagnostiquer les problèmes de connexion.
Authentication errors
Authentication errors
Vérifiez que vous utilisez des clés de test avec les points de terminaison de test et des clés live avec les points de terminaison de production. Vérifiez que
DODO_PAYMENTS_ENVIRONMENT est correctement défini (live_mode pour la production). Si le problème persiste, générez une nouvelle clé API depuis votre tableau de bord.Tool execution failures
Tool execution failures
Vérifiez que l’assistant d’IA fournit des paramètres correctement formatés pour chaque outil. Consultez la réponse d’erreur de l’API pour obtenir des indications précises sur l’origine du problème. Vérifiez que l’opération fonctionne lorsque vous appelez directement l’API Dodo Payments via curl ou Postman.
Pourquoi utiliser Code Mode
Les implémentations MCP traditionnelles souffrent de la « prolifération des outils », où chaque point de terminaison d’API est exposé comme un outil distinct. Code Mode est préférable pour plusieurs raisons :Les LLM écrivent mieux du code qu’ils n’appellent des outils
Les LLM sont entraînés sur des millions de lignes de code réel et écrivent donc naturellement de bons scripts. L’appel d’outils repose souvent sur des exemples synthétiques.« Faire exécuter des tâches à un LLM avec l’appel d’outils, c’est comme inscrire Shakespeare à un cours de mandarin d’un mois, puis lui demander d’y écrire une pièce. » — Cloudflare
Élimine la surcharge de la fenêtre de contexte
Dans les approches traditionnelles, chaque définition d’outil consomme des tokens avant le début de la conversation. Exposer plus de 50 outils peut consommer de 55K à plus de 100K tokens. Anthropic a constaté que les définitions d’outils pouvaient consommer jusqu’à 134K tokens avant optimisation. Code Mode ne charge que 2 définitions d’outils (environ 1K tokens). L’agent recherche la documentation à la demande. Le Tool Search Tool d’Anthropic a préservé 95 % de la fenêtre de contexte, réduisant la surcharge de 77K à 8,7K tokens.Réduit la latence grâce à l’orchestration programmatique
L’appel d’outils traditionnel nécessite un aller-retour complet d’inférence du modèle pour chaque opération. Si une tâche nécessite 20 appels d’API, cela représente 20 aller-retours. Avec Code Mode, l’agent écrit un seul script qui exécute tous les appels et ne renvoie que le résultat final. Anthropic a observé une réduction de 37 % du nombre de tokens et une amélioration de la précision (la récupération des connaissances est passée de 25,6 % à 28,5 %) avec cette approche.Plus sécurisé par conception
Code Mode offre des avantages de sécurité intrinsèques :- Aucune clé API dans les paramètres — Les clés API sont injectées côté serveur et ne sont jamais exposées dans les paramètres des outils envoyés au LLM.
- Sandbox isolé — Le code s’exécute dans un environnement sécurisé sans accès au réseau ni au système de fichiers hôte.
- SDK contrôlé — Seules les méthodes SDK autorisées sont disponibles pour l’agent.
S’adapte à toute taille d’API
À mesure qu’une API se développe, les performances du MCP traditionnel se dégradent, car davantage d’outils doivent être chargés. Code Mode reste constant avec 2 outils, quelle que soit l’étendue de l’API. Cloudflare a regroupé plus de 2 500 points de terminaison d’API en 2 outils et environ 1 000 tokens de contexte.Pour plus de détails, consultez les blogs d’ingénierie d’Anthropic et de Cloudflare, ainsi que la documentation Programmatic Tool Calling de Claude.
Ressources
API Reference
Explorez la documentation complète de l’API Dodo Payments
MCP Protocol
En savoir plus sur la norme Model Context Protocol
GitHub Repository
Consultez le code source du serveur MCP et contribuez
NPM Package
Installez le serveur MCP depuis NPM