Développer avec des Agents de Codage IA - Dodo Payments Documentation

Le Plugin Agent Dodo connecte deux serveurs MCP et huit compétences d’intégration à votre agent de codage IA en une seule installation. Il fonctionne avec Claude Code, Codex CLI, Cursor, et OpenCode — et les serveurs et compétences MCP CLI fonctionnent avec tout client compatible MCP.

Trois primitives, un plugin. Le Plugin Agent regroupe tout ce dont vous avez besoin :

Serveur API MCP — accès en direct aux paiements, abonnements, clients, produits, remboursements, licences, et utilisation. Authentification via OAuth du navigateur (pas de clés locales requises).
Serveur de Connaissances MCP — recherche sémantique à travers toute la documentation Dodo Payments. Aucune référence requise.
Huit compétences d’agent — fiches pratiques que votre agent charge à la demande pour checkout, abonnements, webhooks, facturation basée sur l’utilisation, facturation basée sur le crédit, clés de licence, BillingSDK, et meilleures pratiques.

Installer le plugin

Choisissez votre agent de codage ci-dessous. L’installation ajoute automatiquement les deux serveurs MCP et toutes les huit compétences.

Claude Code

Installez depuis le marché :

claude plugins marketplace add dodopayments/dodo-agent-plugin
claude plugins install dodopayments@dodopayments

Le serveur API MCP utilise OAuth du navigateur par défaut — pas de clés requises lors de l’installation. La première fois que votre agent appelle un outil Dodo, vous serez invité à vous connecter.

Dodo Agent Plugin on GitHub

Code source, options de configuration, et instructions de développement local

Codex CLI

Codex installe des plugins en deux étapes : enregistrez le marketplace depuis votre terminal, puis installez le plugin depuis l’intérieur de l’interface Codex TUI.

codex plugin marketplace add dodopayments/dodo-agent-plugin

Install from the Codex TUI

Ouvrez Codex et exécutez la commande slash /plugins :

codex

Ensuite, tapez /plugins, passez au marketplace Dodo Payments, sélectionnez le plugin dodopayments et choisissez Installer le plugin.

Les serveurs MCP et les huit compétences sont enregistrés automatiquement une fois le plugin installé.

Codex CLI n’a pas de sous-commande codex plugin install — l’installation de plugins se fait toujours via le flux in-TUI /plugins. Voir la documentation officielle des plugins Codex.

Si vous avez déjà ajouté le marketplace et que le plugin n’apparaît pas sous /plugins, actualisez-le :

codex plugin marketplace upgrade dodopayments

Cursor

Installation manuelle — clonez le dépôt dans le répertoire local des plugins de Cursor :

git clone https://github.com/dodopayments/dodo-agent-plugin.git ~/.cursor/plugins/local/dodo-agent-plugin

Redémarrez Cursor. Le plugin charge les compétences de .claude/skills/ (via la couche de compatibilité Claude Code de Cursor) et les serveurs MCP de .mcp.json.

Le support du marketplace Cursor arrive bientôt. Pour l’instant, utilisez l’installation manuelle ci-dessus.

OpenCode

OpenCode distribue via npm. Ajoutez le plugin à votre opencode.json :

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@dodopayments/opencode-plugin"]
}

Redémarrez OpenCode. Les deux serveurs MCP (dodopayments-api, dodo-knowledge) sont enregistrés automatiquement via le hook de configuration du plugin, et les huit compétences sont découvertes automatiquement à partir du package installé. Aucun bloc mcp manuel requis.

Vous utilisez un autre agent ? Les guides Serveur MCP et Compétences d’agent couvrent Cursor, Claude Desktop, VS Code, Windsurf, Cline, Zed et tout client compatible MCP.

Ce que vous obtenez

Une fois le plugin installé, votre agent a accès à deux serveurs MCP et huit compétences.

Serveurs MCP

Serveur	Objectif	Auth
`dodopayments-api`	Accès API en direct — paiements, abonnements, clients, produits, remboursements, licences, utilisation	OAuth (navigateur)
`dodo-knowledge`	Recherche sémantique dans toute la documentation Dodo Payments	Aucun

Les deux serveurs sont connectés via mcp-remote afin qu’ils fonctionnent dans tout client compatible MCP.

Compétences d’agent

Compétence	Description
`best-practices`	Guide complet pour intégrer Dodo Payments avec les meilleures pratiques
`checkout-integration`	Création de sessions de paiement et flux de paiement
`subscription-integration`	Mise en œuvre de flux de facturation d’abonnement
`webhook-integration`	Configuration et gestion des webhooks pour les événements de paiement
`usage-based-billing`	Mise en œuvre de la facturation mesurée avec événements et compteurs
`credit-based-billing`	Droits de crédit, soldes et déduction de crédit mesurée
`license-keys`	Gestion des clés de licence pour produits numériques
`billing-sdk`	Utilisation des composants React BillingSDK

Les compétences se chargent automatiquement — votre agent choisit la bonne lorsqu’il détecte une tâche pertinente. Voir la documentation des compétences d’agent pour la liste complète et l’installation individuelle.

Essayez ce prompt en premier

Une fois le plugin actif, essayez :

Set up Dodo Payments webhook handlers in my Next.js app for payment.succeeded and subscription.active events.

Votre agent chargera la compétence webhook-integration, utilisera le MCP dodo-knowledge pour récupérer les dernières formes de charge utile, et écrira un gestionnaire avec vérification de signature suivant la spécification des Standard Webhooks.

Autres agents pris en charge

Le plugin d’agent couvre Claude Code, Codex CLI, Cursor et OpenCode. Si vous utilisez un autre agent, connectez-vous à Dodo Payments via les serveurs MCP et le CLI des compétences :

Agent	Chemin le plus rapide	Prend également en charge
Claude Code	Plugin d’agent (une commande)	Serveur MCP, compétences individuelles
Codex CLI	Plugin d’agent (une commande)	Serveur MCP
Cursor	Plugin d’agent (git clone)	Configuration du serveur MCP, CLI des compétences
OpenCode	Plugin d’agent (npm)	Configuration du serveur MCP, CLI des compétences
GitHub Copilot (VS Code)	Guide du serveur MCP	CLI des compétences
Claude Desktop	Guide du serveur MCP	—
Windsurf	Guide du serveur MCP	CLI des compétences
Cline / Zed / autres	Guide du serveur MCP	CLI des compétences

Documentation conçue pour les agents

Chaque page de documentation Dodo Payments est disponible dans un format optimisé pour la consommation par IA :

Index complet des documents : docs.dodopayments.com/llms.txt — fournit l’index complet de la documentation pour l’ingestion contextuelle.
Markdown brut : Ajoutez .md à n’importe quelle URL de documentation pour obtenir la version markdown brute (par exemple, /api-reference/introduction.md).
Dépôt source : github.com/dodopayments/dodo-docs — clonez pour indexation hors ligne.

Ce que votre agent peut faire

Avec le plugin installé, votre agent de codage peut :

Créer des sessions de paiement et des liens de paiement — Paiements ponctuels et abonnements
Mettre en place un système de facturation par abonnement et basé sur l’utilisation de bout en bout — Abonnements, Facturation basée sur l’utilisation, Facturation à base de crédits
Générer des gestionnaires conformes aux webhooks standards avec vérification de la signature — Webhooks
Utiliser les composants React de BillingSDK pour les grilles tarifaires et la gestion des abonnements — BillingSDK
Créer des flux de clés de licence pour les produits numériques — Clés de licence
Implémenter la facturation à base de crédits avec droits, soldes, report et dépassement — Crédits

Sécurité et meilleures pratiques

Ne vous engagez jamais avec des clés API de production. Utilisez le mode test pendant le développement. Le plugin d’agent utilise par défaut OAuth du navigateur — ne passez à des clés API locales que si votre flux de travail l’exige.

Utilisez d’abord le mode test. Testez votre intégration avec les clés dodo_test_... avant de passer en production. Voir Mode test vs Mode live.
OAuth est par défaut. Le plugin d’agent s’authentifie via OAuth du navigateur (aucun secret local). Utilisez le mode clé API uniquement si nécessaire — voir la section Configuration ci-dessous.
Relisez le code généré par l’agent. Vérifiez toujours que les gestionnaires de webhooks incluent la vérification de signature suivant la spécification des Standard Webhooks.

Configurer avec une clé API

Par défaut, le plugin d’agent utilise le serveur MCP distant avec OAuth du navigateur — pas besoin d’identifiants locaux. Si votre flux de travail nécessite une clé API locale (par exemple, environnements CI, serveurs sans interface), vous pouvez passer au mode stdio.

Local API key mode — Claude Code

Ouvrez /plugins dans Claude Code, sélectionnez Dodo Payments et choisissez Configurer les options. Remplissez :

dodo_api_key — votre clé dodo_test_... ou dodo_live_...
dodo_webhook_key — votre secret de signature de webhook
dodo_environment — test_mode ou live_mode

Puis éditez .mcp.json pour pointer dodopayments-api vers le serveur stdio local :

{
  "mcpServers": {
    "dodopayments-api": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "dodopayments-mcp@latest"],
      "env": {
        "DODO_PAYMENTS_API_KEY": "${user_config.dodo_api_key}",
        "DODO_PAYMENTS_WEBHOOK_KEY": "${user_config.dodo_webhook_key}",
        "DODO_PAYMENTS_ENVIRONMENT": "${user_config.dodo_environment}"
      }
    }
  }
}

Exécutez /reload-plugins pour appliquer les changements à votre session actuelle.

Local API key mode — OpenCode

Déclarez dodopayments-api vous-même dans opencode.json — votre entrée prévaut sur le serveur distant par défaut du plugin :

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@dodopayments/opencode-plugin"],
  "mcp": {
    "dodopayments-api": {
      "type": "local",
      "command": ["npx", "-y", "dodopayments-mcp@latest"],
      "environment": {
        "DODO_PAYMENTS_API_KEY": "dodo_test_...",
        "DODO_PAYMENTS_WEBHOOK_KEY": "whsec_...",
        "DODO_PAYMENTS_ENVIRONMENT": "test_mode"
      },
      "enabled": true
    }
  }
}

Redémarrez OpenCode pour appliquer.

Prochaines étapes

MCP Server

Référence complète pour les serveurs MCP — tous les clients pris en charge, configuration et outils disponibles

Agent Skills

Installation individuelle des compétences, référence des compétences et instructions de configuration par agent

Sentra IDE Assistant

Assistant de facturation alimenté par l’IA pour VS Code, Cursor, et Windsurf — demander, construire et planifier dans votre éditeur

API Reference

Référence OpenAPI complète pour tous les endpoints Dodo Payments

Documentation Index

​Installer le plugin

Dodo Agent Plugin on GitHub

​Ce que vous obtenez

​Serveurs MCP

​Compétences d’agent

​Essayez ce prompt en premier

​Autres agents pris en charge

​Documentation conçue pour les agents

​Ce que votre agent peut faire

​Sécurité et meilleures pratiques

​Configurer avec une clé API

​Prochaines étapes

MCP Server

Agent Skills

Sentra IDE Assistant

API Reference

Installer le plugin

Ce que vous obtenez

Serveurs MCP

Compétences d’agent

Essayez ce prompt en premier

Autres agents pris en charge

Documentation conçue pour les agents

Ce que votre agent peut faire

Sécurité et meilleures pratiques

Configurer avec une clé API

Prochaines étapes