Passer au contenu principal

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 :
{
  "mcpServers": {
    "dodopayments_api": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"]
    }
  }
}
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
Gardez votre clé API sécurisée. Utilisez des clés de mode test pendant le développement.
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.
# Set your API key
export DODO_PAYMENTS_API_KEY="dodo_test_..."

# Run the latest version
npx -y dodopayments-mcp@latest
Utilisez @latest pour toujours tirer la version la plus récente, ou épinglez à une version spécifique comme @1.0.0 pour la stabilité.

Docker

Exécutez le serveur MCP dans un environnement conteneurisé pour un déploiement cohérent.
# Pull the latest image
docker pull ghcr.io/dodopayments/mcp:latest

# Run the container
docker run -e DODO_PAYMENTS_API_KEY="dodo_test_..." \
  -p 3000:3000 \
  ghcr.io/dodopayments/mcp:latest
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é.
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é)
{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"]
    }
  }
}
Local NPX
{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "dodopayments-mcp@latest"],
      "env": {
        "DODO_PAYMENTS_API_KEY": "dodo_test_..."
      }
    }
  }
}
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.
# Only expose read operations (GET requests)
npx dodopayments-mcp --operation=read

# Only expose write operations (POST, PUT, DELETE)
npx dodopayments-mcp --operation=write
Utilisez --operation=read pendant le développement pour éviter les modifications accidentelles de vos données.

Filtrer par ressource

Limiter les outils à des ressources API spécifiques.
# Only expose payment-related tools
npx dodopayments-mcp --resource=payments

# Expose multiple resources
npx dodopayments-mcp --resource=payments --resource=customers

Inclure ou exclure des outils spécifiques

Affinez quels outils individuels sont disponibles.
# Include only specific tools
npx dodopayments-mcp --tool=create_payments --tool=list_payments

# Exclude specific tools
npx dodopayments-mcp --no-tool=delete_products

# List all available tools
npx dodopayments-mcp --list

Combiner des filtres

Appliquez plusieurs filtres simultanément pour un contrôle précis.
# Only payment and subscription read operations
npx dodopayments-mcp --operation=read --resource=payments --resource=subscriptions

Utilisation avancée

Intégration programmatique

Construisez des serveurs MCP personnalisés ou étendez l’existant de manière programmatique.
import { server, endpoints, init } from "dodopayments-mcp/server";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

// Initialize with all default endpoints
init({ server, endpoints });

// Start the server
const transport = new StdioServerTransport();
await server.connect(transport);

Développement d’outils personnalisés

Étendez le serveur MCP avec vos propres outils et logique métier.
import { server, init } from "dodopayments-mcp/server";
import createPayments from "dodopayments-mcp/tools/payments/create-payments";
import { zodToJsonSchema } from "zod-to-json-schema";
import { z } from "zod";

// Define a custom tool
const customTool = {
  tool: {
    name: 'calculate_payment_total',
    description: 'Calculate payment total with tax and fees',
    inputSchema: zodToJsonSchema(
      z.object({
        amount: z.number().describe('Base amount in cents'),
        tax_rate: z.number().describe('Tax rate as decimal'),
      })
    ),
  },
  handler: async (client, args) => {
    const total = args.amount * (1 + args.tax_rate);
    return {
      content: [{
        type: 'text',
        text: JSON.stringify({ total, currency: 'usd' }),
      }],
    };
  },
};

// Initialize with custom tools
init({ 
  server, 
  endpoints: [createPayments, customTool] 
});

Meilleures pratiques de sécurité

Protégez vos identifiants API et maintenez des intégrations sécurisées.
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.
# Use environment variables
export DODO_PAYMENTS_API_KEY="dodo_test_..."

# Use a .env file (add to .gitignore)
echo "DODO_PAYMENTS_API_KEY=dodo_test_..." > .env
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.
Appliquer le filtrage des outils en productionLimitez les opérations exposées à seulement ce dont votre assistant IA a besoin.
# Production: read-only access
npx dodopayments-mcp --operation=read

# Development: full access
npx dodopayments-mcp
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.
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

Vérifiez votre clé APIAssurez-vous que votre clé API est correctement définie et dispose des autorisations nécessaires.
# Test your API key
curl -H "Authorization: Bearer dodo_test_..." \
  https://api.dodopayments.com/payments
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.
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.
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.

Ressources