Aperçu
Le Protocole de Contexte de Modèle (MCP) est une norme ouverte qui permet aux applications IA de se connecter de manière sécurisée à des sources de données et des API externes. Le Serveur MCP Dodo Payments fournit aux assistants IA comme Claude, Cursor et d’autres clients compatibles MCP un accès structuré à votre infrastructure de paiement.Capacités clés
- 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 mises à niveau et les annulations
- Administration des clients : Gérer les données des clients et l’accès au portail
- Catalogue de produits : Créer et mettre à jour des produits, des prix et des remises
- Gestion des licences : Activer, valider et gérer les licences logicielles
- Facturation basée sur l’utilisation : Suivre et facturer l’utilisation mesurée
Installation
Choisissez la méthode d’installation qui convient le mieux à votre flux de travail.Serveur MCP distant (recommandé)
Accédez au serveur MCP hébergé sans aucune configuration ou installation locale. C’est le moyen le plus rapide de commencer.1
Accéder au serveur distant
Naviguez vers https://mcp.dodopayments.com dans votre navigateur.
2
Configurer votre client MCP
Copiez la configuration JSON fournie pour votre client spécifique. Pour Cursor ou Claude Desktop, ajoutez ceci à vos paramètres MCP :
3
Authentifier et configurer
Le flux OAuth vous demandera de :
- Entrer votre clé API Dodo Payments
- Sélectionner votre environnement (test ou production)
- Choisir votre type de client MCP
4
Compléter la configuration
Cliquez sur Se connecter et approuver 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 en utilisant NPM.- NPX (Pas d'installation)
- Configuration du client MCP
Docker
Exécutez le serveur MCP dans un environnement conteneurisé pour un déploiement cohérent.Les images Docker sont disponibles sur GitHub Container Registry.
Configuration du client
Configurez le serveur MCP Dodo Payments dans votre client IA préféré.- Cursor
- Claude Desktop
- Cline (VS Code)
- Zed
- Autres clients
Configurez le serveur MCP Dodo Payments dans Cursor pour permettre un accès conversationnel à vos données de paiement.
1
Ouvrir les paramètres de Cursor
Naviguez vers Paramètres de Cursor > Fonctionnalités > Protocole de Contexte de Modèle ou appuyez sur
Cmd/Ctrl + Shift + P et recherchez “Paramètres MCP”.2
Modifier la configuration
Cliquez sur Modifier la configuration pour ouvrir le fichier
mcp_config.json.3
Ajouter la configuration Dodo Payments
Choisissez l’une des configurations suivantes :Serveur distant (recommandé)Local NPX
4
Enregistrer et redémarrer
Enregistrez le fichier de configuration et redémarrez Cursor.
Vérifiez la connexion en demandant à l’assistant IA vos données Dodo Payments.
Filtrage des outils
Contrôlez quelles opérations API sont exposées à votre assistant IA pour optimiser les performances et maintenir la sécurité.Filtrer par type d’opération
Restreindre l’accès aux opérations en lecture seule ou en écriture.Filtrer par ressource
Limiter les outils à des ressources API spécifiques.Inclure ou exclure des outils spécifiques
Affinez quels outils individuels sont disponibles.Combiner des filtres
Appliquez plusieurs filtres simultanément pour un contrôle précis.Utilisation avancée
Intégration programmatique
Construisez des serveurs MCP personnalisés ou étendez l’existant de manière programmatique.Développement d’outils personnalisés
Étendez le serveur MCP avec vos propres outils et logique métier.Meilleures pratiques de sécurité
Protégez vos identifiants API et maintenez des intégrations sécurisées.Gestion des clés API
Gestion des clés API
Ne jamais commettre d’identifiants dans le contrôle de versionStockez les clés API dans des variables d’environnement ou des systèmes de gestion de secrets sécurisés.Faire tourner les clés régulièrementGénérez de nouvelles clés API périodiquement et révoquez les anciennes via votre tableau de bord Dodo Payments.Utiliser des clés de test pour le développementUtilisez toujours des clés API en mode test pendant le développement pour éviter d’affecter les données de production.
Contrôle d'accès
Contrôle d'accès
Appliquer le filtrage des outils en productionLimitez les opérations exposées à seulement ce dont votre assistant IA a besoin.Implémenter l’authentification pour les points de terminaison personnalisésValidez les requêtes et appliquez l’autorisation dans vos gestionnaires d’outils personnalisés.Surveiller l’utilisation de l’APISuivez l’activité du serveur MCP via votre tableau de bord Dodo Payments et configurez des alertes pour des modèles inhabituels.
Sécurité réseau
Sécurité réseau
Utiliser HTTPS pour les serveurs distantsDéployez toujours des serveurs MCP distants derrière des points de terminaison HTTPS.Implémenter la limitation de tauxProtégez-vous contre les abus en mettant en œuvre des limites de taux à la fois au niveau du serveur MCP et de l’API.Restreindre l’accès réseauConfigurez des règles de pare-feu pour limiter quels clients peuvent se connecter à votre serveur MCP.
Dépannage
Problèmes de connexion
Problèmes de connexion
Vérifiez votre clé APIAssurez-vous que votre clé API est correctement définie et dispose des autorisations nécessaires.Vérifiez votre connexion réseauVérifiez que vous pouvez atteindre les points de terminaison de l’API Dodo Payments.Examinez les journaux du clientActivez la journalisation détaillée dans votre client MCP pour diagnostiquer les problèmes de connexion.
Erreurs d'authentification
Erreurs d'authentification
Confirmez l’environnement de la clé APIAssurez-vous d’utiliser des clés de test avec des points de terminaison de test et des clés de production avec des points de terminaison de production.Vérifiez les autorisations de la cléVérifiez que votre clé API a les autorisations pour les opérations que vous essayez d’effectuer.Régénérez les identifiantsSi les problèmes persistent, générez une nouvelle clé API via votre tableau de bord.
Échecs d'exécution des outils
Échecs d'exécution des outils
Validez les paramètres d’entréeAssurez-vous que l’assistant IA fournit des paramètres correctement formatés pour chaque outil.Examinez les messages d’erreurVérifiez la réponse d’erreur de l’API pour des conseils spécifiques sur ce qui a mal tourné.Testez directement avec l’APIVérifiez que l’opération fonctionne lors de l’appel direct de l’API Dodo Payments via curl ou Postman.