Développer avec des Agents de Codage IA

Le Dodo Agent Plugin intègre deux serveurs MCP et dix-sept skills d’intégration à votre agent de programmation IA en une seule installation. Il fonctionne avec Claude Code, Codex CLI, Cursor, VS Code / GitHub Copilot, Kiro et OpenCode. Gemini CLI ne bénéficie que des deux serveurs MCP. Les serveurs MCP et la CLI des skills fonctionnent avec tout client compatible avec MCP.

Installer le plugin

Choisissez votre agent de programmation ci-dessous. Chaque installation ajoute les deux serveurs MCP. Tous les agents, à l’exception de Gemini CLI, ajoutent également les dix-sept skills. OpenCode nécessite un paramètre supplémentaire pour les charger, décrit dans sa section.

Claude Code

Installer depuis la marketplace :

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

Le serveur MCP de l’API utilise OAuth dans le navigateur par défaut — aucune clé n’est requise au moment 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

Enregistrez la marketplace, puis installez le plugin depuis la TUI de Codex.

codex plugin marketplace add dodopayments/dodo-agent-plugin

Install from the Codex TUI

Ouvrez Codex et exécutez /plugins :

codex

Saisissez /plugins, sélectionnez la marketplace Dodo Payments, choisissez le plugin dodopayments, puis sélectionnez Install plugin.

Les deux serveurs MCP et les dix-sept skills sont enregistrés automatiquement.Si le plugin n’apparaît pas sous /plugins, actualisez-le :

codex plugin marketplace upgrade dodopayments

Pour installer depuis votre shell plutôt que depuis la TUI, exécutez codex plugin add dodopayments@dodopayments après avoir enregistré la marketplace. Codex CLI ne possède pas de sous-commande codex plugin install. Consultez la documentation officielle des plugins Codex.

Cursor

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 skills depuis skills/ et les serveurs MCP depuis .mcp.json.Les versions récentes de Cursor reconnaissent directement Agent Plugins 1.0.0 et acceptent .claude-plugin/marketplace.json comme source de marketplace. Le fichier .cursor-plugin/plugin.json généré est conservé pour les versions plus anciennes.Si vous avez installé une version antérieure à 0.5.0, supprimez le répertoire et clonez à nouveau le dépôt — les skills sont désormais fournis sous forme de vrais fichiers et non plus de liens symboliques.

OpenCode

Installez le package du plugin dans votre projet, puis ajoutez-le ainsi que son chemin de skills à votre opencode.json :

npm install --save-dev @dodopayments/opencode-plugin

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

Redémarrez OpenCode. Les deux serveurs MCP sont enregistrés automatiquement. Les skills nécessitent l’entrée supplémentaire skills.paths, car OpenCode n’analyse pas les packages installés à la recherche de skills.Les chemins relatifs sont résolus par rapport au répertoire du projet ; le package doit donc exister dans le node_modules de ce projet. Un chemin absolu fonctionne également et évite l’obligation d’une installation locale.Vérifiez que les skills sont chargés :

opencode run "List every skill available to you by name."

Vous devriez tous les voir apparaître. Un chemin de skills qui n’existe pas est ignoré silencieusement ; vérifiez donc plutôt que de le supposer.

VS Code / GitHub Copilot

Clonez le dépôt et enregistrez-le :

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

Ouvrez la vue Chat, accédez à Plugins, puis ajoutez le dossier cloné. Vous pouvez également l’enregistrer dans settings.json :

{
  "chat.pluginLocations": { "~/dodo-agent-plugin": true }
}

La clé correspond à un chemin et la valeur l’active. Les chemins absolus et ~/ fonctionnent tous deux ; les chemins relatifs sont résolus par rapport à chaque dossier de workspace. Le paramètre est lu en temps réel : une fenêtre ouverte le prend en compte sans redémarrage.chat.pluginLocations est marqué comme expérimental et constitue un paramètre restreint ; le workspace doit donc être approuvé. La prise en charge des plugins d’agent est une fonctionnalité en préversion régie par chat.plugins.enabled, activé par défaut.

Kiro

Kiro lit nativement le manifeste Agent Plugins.

Clone the repository

git clone https://github.com/dodopayments/dodo-agent-plugin.git

Open the Powers panel

Dans Kiro, ouvrez le panneau Powers (l’icône Ghosty avec l’éclair).

Import the folder

Choisissez Add Custom Power → Import power from a folder, sélectionnez le répertoire cloné (celui qui contient plugin.json), puis cliquez sur Install.

Les skills sont chargés depuis skills/ et les serveurs MCP depuis mcp.json. Kiro gère les serveurs MCP en interne : ils ne sont pas écrits dans ~/.kiro/settings/mcp.json. Kiro peut également installer directement un Power depuis une URL GitHub ; consultez la documentation d’installation de Kiro.

Gemini CLI (MCP only)

Gemini CLI ne possède pas de primitive agent-skill ; seuls les deux serveurs MCP sont donc disponibles. dodo-knowledge couvre une bonne partie de ce que fournissent les skills et reste automatiquement à jour.

git clone https://github.com/dodopayments/dodo-agent-plugin.git \
  ~/.gemini/extensions/dodopayments

Redémarrez Gemini CLI. gemini-extension.json à la racine du dépôt est le manifeste.

Vous utilisez un autre agent ? Les guides MCP Server et Agent Skills couvrent Claude Desktop, Windsurf, Cline, Zed et tout client compatible avec MCP.

Ce que vous obtenez

Une fois installé, votre agent a accès à deux serveurs MCP et dix-sept skills.

Serveurs MCP

Serveur	Fonction	Auth
`dodopayments-api`	Accès à l’API en temps réel — paiements, abonnements, clients, produits, remboursements, licences, utilisation	OAuth (navigateur)
`dodo-knowledge`	Recherche sémantique dans toute la documentation Dodo Payments	Aucune

Les deux serveurs utilisent Streamable HTTP. Le mcp.json canonique les déclare nativement, ce qu’utilisent les clients compatibles avec la spécification, comme Codex CLI et Kiro. Le manifeste de compatibilité généré .mcp.json les connecte via mcp-remote pour les clients qui ne peuvent pas communiquer directement avec Streamable HTTP.

Agent Skills

Skill	Description
`dodo-best-practices`	Configuration du SDK, environnements, clés API et architecture canonique du checkout au webhook
`framework-adapters`	Gestionnaires de routes `@dodopayments/*` officiels pour Next.js, Express, Hono, Astro, Remix, SvelteKit, Nuxt, Fastify, TanStack, Bun et Convex
`testing-and-go-live`	Mode test, moyens de paiement de test, tests de webhooks et checklist de lancement en production
`checkout-integration`	Checkout Sessions, liens de paiement et checkout en superposition ou intégré
`subscription-integration`	Cycle de vie des abonnements, essais, changements de plan, proratisation et frais à la demande
`mobile-checkout`	Checkout intégré à l’application pour React Native, Flutter, iOS et Android
`webhook-integration`	Réception et vérification des webhooks avec la spécification Standard Webhooks
`credit-based-billing`	Droits de crédit, soldes, registre, report, dépassement et déduction basée sur les compteurs
`usage-based-billing`	Compteurs, ingestion d’événements, agrégation et tarification à l’unité
`license-keys`	Activation et validation des clés de licence, et gestion des instances
`product-catalog-management`	Produits, tarification, modules complémentaires, collections, images et livraison de produits numériques
`discounts-and-promotions`	Codes de réduction, règles d’éligibilité, cumul et limites par cycle d’abonnement
`localized-pricing`	Tarification localisée, Adaptive Currency et parité de pouvoir d’achat
`customer-management`	Clients, portail en libre-service, moyens de paiement enregistrés et wallets
`refunds-and-disputes`	Émission de remboursements, gestion des litiges et des rétrofacturations, et rapprochement des accès
`billing-sdk`	Composants React BillingSDK pour les tableaux de prix et l’interface de facturation
`better-auth-integration`	Le plugin `@dodopayments/better-auth` pour la synchronisation des clients, le checkout et l’accès au portail

Les skills sont chargés automatiquement : votre agent sélectionne le bon lorsqu’il détecte une tâche pertinente. Consultez Agent Skills pour obtenir la liste complète et les instructions d’installation individuelles.

Essayez d’abord cette invite

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 le skill webhook-integration, utilisera le MCP dodo-knowledge pour récupérer les dernières structures de payload et écrira un gestionnaire avec vérification de signature, conformément à la spécification Standard Webhooks.

Prise en charge des clients

Le plugin suit la spécification Agent Plugins 1.0.0. Les clients qui la prennent en charge nativement le chargent directement ; les autres utilisent des manifestes de compatibilité générés.

Agents avec installation de plugin

Une seule installation configure les deux serveurs MCP, ainsi que les skills sur chaque client qui dispose d’une primitive de skills.

Agent	Installation	Skills	Serveurs MCP
Claude Code	commande marketplace	17	2
Codex CLI	commande marketplace	17	2
Cursor	git clone	17	2
VS Code / GitHub Copilot	git clone	17	2
Kiro	git clone	17	2
OpenCode	npm	17	2
Gemini CLI	git clone	0	2

OpenCode nécessite une entrée skills.paths supplémentaire avant le chargement de ses dix-sept skills. Gemini CLI ne possède pas de primitive agent-skill ; les skills ne sont donc pas disponibles par conception.

Autres clients compatibles avec MCP

Ces clients ne proposent pas d’installation d’Agent Plugin. Configurez manuellement les deux serveurs MCP et ajoutez les skills via la Skills CLI lorsqu’elle est prise en charge.

Agent	Serveurs MCP	Skills
Claude Desktop	Guide MCP Server	non pris en charge
Windsurf	Guide MCP Server	Skills CLI
Cline / Zed / autres	Guide MCP Server	Skills CLI

Documentation conçue pour les agents

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

Index complet de la documentation : docs.dodopayments.com/llms.txt — index complet de la documentation pour l’ingestion du contexte
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-le pour l’indexation hors ligne

Ce que votre agent peut faire

Une fois le plugin installé, votre agent de programmation peut :

Créer des sessions de checkout et des liens de paiement — Paiements ponctuels et abonnements
Mettre en place une facturation d’abonnement et basée sur l’utilisation de bout en bout — Abonnements, Facturation basée sur l’utilisation, Facturation basée sur les crédits
Générer des gestionnaires conformes à Standard Webhooks avec vérification de signature — Webhooks
Monter des gestionnaires de routes dans votre framework à l’aide des adaptateurs officiels — Adaptateurs de framework
Intégrer les composants React BillingSDK pour les tableaux de prix et la gestion des abonnements — BillingSDK
Créer des parcours avec clés de licence pour les produits numériques — Clés de licence
Mettre en œuvre une facturation basée sur les crédits avec droits, soldes, report et dépassement — Crédits
Créer et gérer votre catalogue de produits avec des modules complémentaires et des collections — Produits, Modules complémentaires, Collections de produits
Ajouter des réductions et une tarification localisée — Codes de réduction, Tarification localisée, Adaptive Currency
Déployer un checkout intégré à l’application mobile pour React Native, Flutter, iOS et Android — Intégration mobile
Gérer les remboursements, les litiges et le libre-service client — Remboursements, Litiges, Portail client
Tester l’intégration et passer en production en toute sécurité — Mode test et mode live

Sécurité et bonnes pratiques

Ne commitez jamais de clés API live. Utilisez le mode test pendant le développement.

Utilisez d’abord le mode test. Développez et testez votre intégration avec une clé API de mode test avant le passage en production. Consultez Mode test et mode live.
OAuth est le mode par défaut. L’Agent Plugin s’authentifie via OAuth dans le navigateur (aucun secret local). N’utilisez le mode avec clé API que si nécessaire.
Vérifiez le code généré par l’agent. Vérifiez toujours que les gestionnaires de webhooks incluent la vérification de signature conformément à la spécification Standard Webhooks.

Configurer avec une clé API

Par défaut, l’Agent Plugin utilise le serveur MCP distant avec OAuth dans le navigateur. Pour utiliser une clé API locale à la place, par exemple dans CI ou sur un serveur sans interface graphique, passez en mode stdio.

Local API key mode — Claude Code

Ouvrez /plugins dans Claude Code, sélectionnez Dodo Payments, puis choisissez Configure options. Renseignez :

dodo_api_key — votre clé API de mode test ou de mode live
dodo_webhook_key — votre secret de signature des webhooks
dodo_environment — test_mode ou live_mode

Modifiez ensuite .mcp.json afin de diriger 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 modifications.

Local API key mode — OpenCode

Déclarez vous-même dodopayments-api dans opencode.json — votre entrée est prioritaire 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": "YOUR_TEST_MODE_API_KEY",
        "DODO_PAYMENTS_WEBHOOK_KEY": "whsec_...",
        "DODO_PAYMENTS_ENVIRONMENT": "test_mode"
      },
      "enabled": true
    }
  }
}

Redémarrez OpenCode pour appliquer les modifications.

Étapes suivantes

MCP Server

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

Agent Skills

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

API Reference

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

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Installer le plugin

Dodo Agent Plugin on GitHub

Ce que vous obtenez

Serveurs MCP

Agent Skills

Essayez d’abord cette invite

Prise en charge des clients

Agents avec installation de plugin

Autres clients compatibles avec MCP

Documentation conçue pour les agents

Ce que votre agent peut faire

Sécurité et bonnes pratiques

Configurer avec une clé API

Étapes suivantes

MCP Server

Agent Skills

API Reference

​Installer le plugin

Dodo Agent Plugin on GitHub

​Ce que vous obtenez

​Serveurs MCP

​Agent Skills

​Essayez d’abord cette invite

​Prise en charge des clients

​Agents avec installation de plugin

​Autres clients compatibles avec MCP

​Documentation conçue pour les agents

​Ce que votre agent peut faire

​Sécurité et bonnes pratiques

​Configurer avec une clé API

​Étapes suivantes

MCP Server

Agent Skills

API Reference

Installer le plugin

Ce que vous obtenez

Serveurs MCP

Agent Skills

Essayez d’abord cette invite

Prise en charge des clients

Agents avec installation de plugin

Autres clients compatibles avec MCP

Documentation conçue pour les agents

Ce que votre agent peut faire

Sécurité et bonnes pratiques

Configurer avec une clé API

Étapes suivantes