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. Le serveur MCP de Dodo Payments est construit avec Stainless et utilise l’architecture Code Mode, qui permet aux agents IA d’écrire et d’exécuter du code TypeScript contre le SDK de Dodo Payments dans un environnement sandbox isolé.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
Comment fonctionne le Code Mode
Le serveur MCP de Dodo Payments utilise le Code Mode, fournissant à votre agent IA deux outils puissants :- Outil de recherche de documentation : Interroger la documentation sur l’API et le SDK de Dodo Payments pour comprendre les opérations et les paramètres disponibles
- Outil d’exécution de code : Écrire du code TypeScript contre le SDK qui s’exécute dans un environnement sandbox sécurisé sans accès au web ou au système de fichiers
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 Connexion et approbation pour autoriser la connexion.
Une fois connecté, votre assistant IA peut interagir avec l’API de Dodo Payments en votre nom.
Package NPM
Installez et exécutez le serveur MCP localement en utilisant NPM.- NPX (sans 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 de Dodo Payments dans votre client IA préféré.- Cursor
- Claude Desktop
- Claude Code
- VS Code
- Cline (VS Code)
- Zed
- Autres clients
Configurez le serveur MCP de Dodo Payments dans Cursor pour permettre un accès conversationnel à vos données de paiement.Installation en un clicUtilisez le bouton ci-dessous pour installer le serveur MCP directement 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
mcp.json via Paramètres de Cursor > Outils & MCP > Nouveau serveur MCP.Configuration manuelle1
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 config 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.
Variables d’environnement
Configurez le comportement du serveur MCP à l’aide de variables d’environnement.| Variable | Description | Requis |
|---|---|---|
DODO_PAYMENTS_API_KEY | Votre clé API Dodo Payments | Oui |
DODO_PAYMENTS_WEBHOOK_KEY | Votre clé de signature de webhook | Non |
DODO_PAYMENTS_ENVIRONMENT | Défini sur live_mode pour la production | Non |
Exécution à distance
Déployez le serveur MCP en tant que serveur HTTP distant pour des clients basés sur le web ou des flux de travail agentiques.Configuration du serveur distant
Une fois déployé, les clients peuvent se connecter en utilisant l’URL du serveur :En-têtes d’autorisation
Le serveur distant accepte l’authentification via les en-têtes suivants :| En-tête | Description |
|---|---|
Authorization | Authentification par token Bearer |
x-dodo-payments-api-key | En-tête de clé API directe |
Capacités du client
Différents clients MCP ont des niveaux de support variés pour la spécification MCP. Le serveur peut ajuster automatiquement les schémas d’outils pour contourner ces limitations.Préréglages de clients disponibles
| Client | Description |
|---|---|
infer | Détection automatique du client (par défaut) |
cursor | Éditeur Cursor |
claude | Claude AI web ou desktop |
claude-code | Claude Code CLI |
openai-agents | Plateforme d’agents OpenAI |
Configuration manuelle des capacités
Pour les clients non listés ci-dessus, configurez manuellement les capacités :top-level-unions- Support pour les types d’union de niveau supérieurvalid-json- Analyse correcte des arguments de chaîne JSONrefs- Support pour les pointeurs $ref dans les schémasunions- Support pour les types d’union (anyOf)formats- Support pour les validations de formattool-name-length=N- Longueur maximale du nom de l’outil
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.Filtrage des paramètres de requête URL (serveur distant)
Lors de l’utilisation du serveur distant, appliquez des filtres via des paramètres de requête URL :Mode d’outils dynamiques
Pour les grandes API, charger tous les outils en même temps peut submerger la fenêtre de contexte de l’IA. Le mode d’outils dynamiques offre une alternative plus efficace.list_api_endpoints- Découvre les méthodes disponibles avec un filtrage optionnelget_api_endpoint_schema- Obtient le schéma détaillé pour une méthode spécifiqueinvoke_api_endpoint- Exécute n’importe quelle méthode avec les paramètres appropriés
Les outils dynamiques sont automatiquement activés pour les API avec plus de 50 méthodes. Remplacez avec
--tools=all pour inclure tous les outils.Utilisation avancée
Intégration programmatique
Construisez des serveurs MCP personnalisés ou étendez celui 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 les 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.Mettre en œuvre l’authentification pour les serveurs distantsLors du déploiement à distance, exigez toujours une authentification via l’en-tête
Authorization ou l’en-tête x-dodo-payments-api-key.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.Mettre en œuvre des limites 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.Vérifiez 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 en direct avec des points de terminaison de production.Vérifiez la variable d’environnementVérifiez que
DODO_PAYMENTS_ENVIRONMENT est correctement défini (live_mode pour la production).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.Vérifiez 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 de l’API Dodo Payments directement via curl ou Postman.
Problèmes de compatibilité des clients
Problèmes de compatibilité des clients
Essayez un autre préréglage de clientSi les outils ne fonctionnent pas correctement, essayez de spécifier explicitement votre client :Vérifiez le support des capacitésCertains clients ne prennent pas en charge toutes les fonctionnalités du schéma JSON. Utilisez
--describe-capabilities pour comprendre ce qui est pris en charge.