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
Dodo Knowledge MCP
En plus du serveur Dodo Payments MCP (pour exécuter des opérations API), nous fournissons Dodo Knowledge MCP - un serveur de recherche sémantique qui donne aux assistants IA un accès instantané à la documentation et à la base de connaissances de Dodo Payments.Construit avec ContextMCP.ai : Dodo Knowledge MCP est alimenté par ContextMCP, permettant une recherche sémantique rapide à travers notre documentation en utilisant des embeddings vectoriels.
Qu’est-ce que Dodo Knowledge MCP ?
Dodo Knowledge MCP est un serveur MCP distant qui fournit :- Recherche de Documentation Sémantique : Trouvez la documentation pertinente en utilisant des requêtes en langage naturel
- Réponses Contextuelles : Les assistants IA obtiennent des informations précises et à jour sur Dodo Payments
- Aucune Configuration : Pas de clés API ou d’installation locale requises - il suffit de se connecter et de commencer à interroger
Configuration Rapide
Connectez-vous à Dodo Knowledge MCP dans votre client IA :- Curseur
- Claude Desktop
- Planche à voile
- Claude Code
Ajouter à
~/.cursor/mcp.json:Nécessite Node.js 18 ou supérieur. Le package
mcp-remote gère la connexion au serveur MCP distant.Utiliser les Deux Serveurs MCP Ensemble
Pour la meilleure expérience de développement assistée par IA, nous recommandons d’utiliser les deux serveurs MCP :| Serveur | Objectif | Cas d’utilisation |
|---|---|---|
| Dodo Knowledge MCP | Recherche de documentation | ”Comment gérer les webhooks ?”, “Quels modes de paiement sont pris en charge ?” |
| Dodo Payments MCP | Opérations API | Créer des paiements, gérer des abonnements, traiter des remboursements |
Dépannage de Knowledge MCP
Si vous rencontrez des problèmes de connexion :- Effacer le cache d’authentification MCP :
rm -rf ~/.mcp-auth - Redémarrer votre application cliente
- Vérifier les journaux du client pour les messages d’erreur
- Vérifier la version de Node.js : Nécessite Node.js 18+
Knowledge MCP Server
Accédez à la page de configuration de Dodo Knowledge MCP
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.Accéder au serveur distant
Naviguez vers https://mcp.dodopayments.com dans votre navigateur.
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 :
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
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 Dodo Payments MCP dans votre client IA préféré.- Cursor
- Claude Desktop
- Claude Code
- VS Code
- Cline (VS Code)
- Zed
- Autres Clients
Configurez le serveur Dodo Payments MCP 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 le
mcp.json de Cursor via Paramètres de Cursor > Outils & MCP > Nouveau serveur MCP.Configuration ManuelleOuvrir les paramètres de Cursor
Accédez à Paramètres de Cursor > Fonctionnalités > Protocole de contexte de modèle ou appuyez sur
Cmd/Ctrl + Shift + P et recherchez “Paramètres MCP”.Ajouter la configuration Dodo Payments
Choisissez l’une des configurations suivantes :Serveur Distant (Recommandé)Local NPX
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 Client Disponibles
| Client | Description |
|---|---|
infer | Détection automatique du client (par défaut) |
cursor | Éditeur Cursor |
claude | Claude AI web ou bureau |
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 premier niveauvalid-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 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 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 par
--tools=all pour inclure tous les outils.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 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.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 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.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.
Problèmes de compatibilité du client
Problèmes de compatibilité du client
Essayez un autre préréglage de clientSi les outils ne fonctionnent pas correctement, essayez de spécifier votre client explicitement :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.