plugin.json et mcp.json. Les clients antérieurs à la spécification chargent le même contenu via des manifestes de compatibilité générés.
Trois primitives, un seul plugin. Le Agent Plugin regroupe tout ce dont vous avez besoin :
- Serveur MCP API — accès en temps réel aux paiements, abonnements, clients, produits, remboursements, licences et données d’utilisation. Authentification via OAuth dans le navigateur (aucune clé locale requise).
- Serveur MCP Knowledge — recherche sémantique dans toute la documentation Dodo Payments. Aucun identifiant requis.
- Dix-sept skills d’agent — fiches pratiques que votre agent charge à la demande pour le checkout, les abonnements, les webhooks, la facturation basée sur l’utilisation et les crédits, les clés de licence, le catalogue de produits, les remises, la tarification localisée, le checkout mobile, les remboursements et litiges, la gestion des clients, les adaptateurs de framework, BillingSDK, Better Auth, les tests et la mise en production, ainsi que les bonnes pratiques.
Installer le plugin
Choisissez votre agent de programmation ci-dessous. Chaque installation ajoute les deux serveurs MCP ; toutes, à l’exception de Gemini CLI, ajoutent également les dix-sept skills.Claude Code
Claude Code
Installez depuis la marketplace :Le serveur MCP 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, il vous sera demandé de vous connecter.
Dodo Agent Plugin on GitHub
Code source, options de configuration et instructions de développement local
Codex CLI
Codex CLI
Codex installe les plugins en deux étapes : enregistrez la marketplace depuis votre shell, puis installez le plugin depuis l’interface TUI de Codex.Les deux serveurs MCP et les dix-sept skills sont automatiquement enregistrés une fois le plugin installé.Si vous avez déjà ajouté la marketplace et que le plugin n’apparaît pas sous
1
Register the marketplace
2
Install from the Codex TUI
Ouvrez Codex et exécutez la commande slash Saisissez ensuite
/plugins :/plugins, sélectionnez la marketplace Dodo Payments, choisissez le plugin dodopayments, puis sélectionnez Install plugin.Codex CLI ne possède pas de sous-commande
codex plugin install — l’installation du plugin s’effectue toujours via le flux /plugins dans la TUI. Consultez la documentation officielle des plugins Codex./plugins, actualisez-la :Cursor
Cursor
Installation manuelle — clonez le dépôt dans le répertoire de plugins local de Cursor :Redémarrez Cursor. Le plugin charge les skills depuis
skills/ et les serveurs MCP depuis .mcp.json, comme indiqué dans .cursor-plugin/plugin.json.Les versions récentes de Cursor reconnaissent également directement Agent Plugins 1.0.0 et acceptent
.cursor-plugin/marketplace.json ou .claude-plugin/marketplace.json comme source de marketplace. Ce plugin fournit .claude-plugin/marketplace.json — utilisez ce chemin. Le fichier .cursor-plugin/plugin.json généré est conservé pour les versions plus anciennes.OpenCode
OpenCode
OpenCode est distribué via npm. Ajoutez le plugin à votre Redémarrez OpenCode. Les deux serveurs MCP (Les entrées
opencode.json :dodopayments-api, dodo-knowledge) sont automatiquement enregistrés via le hook de configuration du plugin. Aucun bloc mcp manuel n’est requis.Les skills nécessitent une ligne supplémentaire. OpenCode ne recherche pas les skills dans les packages installés ; indiquez-lui donc vous-même le répertoire skills/ du package :skills.paths relatives sont résolues par rapport au répertoire du projet ; le package doit donc exister dans le node_modules de ce projet — le cache de plugins d’OpenCode se trouve à un autre emplacement. Un chemin absolu fonctionne également et évite l’exigence d’une installation locale.VS Code / GitHub Copilot
VS Code / GitHub Copilot
Clonez le dépôt où vous le souhaitez, puis enregistrez-le :Ouvrez la vue Chat, accédez à Plugins, puis ajoutez le dossier cloné. Vous pouvez également l’enregistrer directement dans La clé est un chemin et la valeur l’active. Les chemins absolus et
settings.json :~/ fonctionnent également ; un chemin relatif est résolu par rapport à chaque dossier de workspace. Le paramètre est lu en direct : une fenêtre ouverte le prend en compte sans redémarrage. Les skills sont chargés depuis skills/ et les deux serveurs MCP depuis .mcp.json.chat.pluginLocations est marqué comme expérimental et constitue un paramètre restreint ; le workspace doit donc être approuvé pour qu’il soit appliqué. La prise en charge globale des plugins d’agent est une fonctionnalité en préversion régie par chat.plugins.enabled, qui est activée par défaut — vous ne devez la définir que si votre organisation la désactive par politique.VS Code ne se base pas sur
$schema d’Agent Plugins. Son chargeur examine .plugin/plugin.json, puis .claude-plugin/plugin.json, puis une racine plugin.json, et utilise par défaut .mcp.json pour MCP plutôt que mcp.json. Comme ce dépôt fournit un .claude-plugin/plugin.json généré, VS Code le charge via cette branche de compatibilité et obtient le pont mcp-remote plutôt que les transports natifs de mcp.json. Tout fonctionne — seul le chemin diffère.Kiro
Kiro
Kiro lit nativement le manifeste Agent Plugins et charge celui-ci comme un Power.Les skills sont chargés depuis
1
Clone the repository
2
Open the Powers panel
Dans Kiro, ouvrez le panneau Powers — l’icône Ghosty avec l’éclair.
3
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.skills/, les serveurs MCP depuis mcp.json, et la présentation propre à Kiro provient de l’espace de noms d’extension dev.kiro dans plugin.json.Pour les plugins au format Agent Plugins, Kiro gère les serveurs MCP en interne — ils ne sont pas écrits dans votre
~/.kiro/settings/mcp.json utilisateur ; ne vous attendez donc pas à les y trouver. Kiro peut également installer directement un Power depuis une URL GitHub ; consultez la documentation d’installation de Kiro.Gemini CLI (MCP only)
Gemini CLI (MCP only)
Gemini CLI ne possède pas de primitive agent-skill ; seuls les deux serveurs MCP sont donc disponibles — les dix-sept skills ne le sont pas. Redémarrez Gemini CLI.
dodo-knowledge couvre néanmoins une grande partie de ce que fournissent les skills et reste automatiquement à jour.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 le plugin installé, votre agent a accès à deux serveurs MCP et dix-sept skills.Serveurs MCP
Les deux serveurs utilisent Streamable HTTP. Le
mcp.json canonique les déclare nativement (type: "streamable-http"), ce qu’utilisent les clients compatibles nativement avec la spécification, tels que Codex CLI et Kiro. Le manifeste de compatibilité généré .mcp.json relie à la place les mêmes endpoints via mcp-remote ; ils peuvent ainsi également fonctionner dans les clients qui ne peuvent pas établir directement une connexion Streamable HTTP — Claude Code, VS Code et Cursor via l’installation par git clone décrite ci-dessus, dont .cursor-plugin/plugin.json pointe vers .mcp.json.
Skills d’agent
Les skills sont chargés automatiquement — votre agent sélectionne le bon lorsqu’il détecte une tâche pertinente. Consultez la documentation 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 :webhook-integration, utilisera le MCP dodo-knowledge pour récupérer les dernières structures de payload et écrira un handler avec vérification de signature conformément à la spécification Standard Webhooks.
Prise en charge des clients
Clients avec installation d’un Agent Plugin
Une seule installation configure les deux serveurs MCP, ainsi que les skills sur chaque client qui possède une primitive de skills.- OpenCode nécessite une entrée
skills.pathssupplémentaire avant le chargement de ses dix-sept skills — consultez la section d’installation ci-dessus. - Gemini CLI ne possède pas de primitive agent-skill ; les skills n’y sont donc pas disponibles par conception.
Autres clients compatibles avec MCP
Ces clients ne disposent 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.Documentation conçue pour les agents
Chaque page de 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— fournit l’index complet de la documentation pour l’ingestion du contexte. - Markdown brut : ajoutez
.mdà toute 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 Checkout Sessions et des liens de paiement — Paiements ponctuels et abonnements
- Mettre en place une facturation par 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 handlers 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 tarification et la gestion des abonnements — BillingSDK
- Créer des flux de 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 remises et une tarification localisée — Codes de remise, Tarification localisée, Adaptive Currency
- Déployer un checkout mobile intégré à l’application 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
- Commencez par le mode test. Isolez votre intégration avec les clés
dodo_test_...avant le passage en production. Consultez Mode test et mode live. - OAuth est le mode par défaut. Le Agent Plugin s’authentifie via OAuth dans le navigateur (aucun secret local). N’utilisez le mode avec clé API que si nécessaire — consultez la section Configuration ci-dessous.
- Examinez le code généré par l’agent. Vérifiez toujours que les handlers de webhook incluent une vérification de signature conformément à la spécification Standard Webhooks.
Configurer avec une clé API
Par défaut, le Agent Plugin utilise le serveur MCP distant avec OAuth dans le navigateur — aucun identifiant local n’est nécessaire. Si votre workflow requiert une clé API locale (par exemple, dans des environnements CI ou sur des serveurs sans interface), vous pouvez passer en mode stdio.Local API key mode — Claude Code
Local API key mode — Claude Code
Ouvrez Exécutez
/plugins dans Claude Code, sélectionnez Dodo Payments, puis choisissez Configure options. Renseignez :dodo_api_key— votre clédodo_test_...oudodo_live_...dodo_webhook_key— votre secret de signature des webhooksdodo_environment—test_modeoulive_mode
.mcp.json afin de faire pointer dodopayments-api vers le serveur stdio local :/reload-plugins pour appliquer les modifications à votre session actuelle.Local API key mode — OpenCode
Local API key mode — OpenCode
Déclarez vous-même Redémarrez OpenCode pour appliquer les modifications.
dodopayments-api dans opencode.json — votre entrée prend le dessus sur le serveur distant par défaut du plugin :Étapes suivantes
MCP Server
Référence complète pour les 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 pour chaque agent
Sentra IDE Assistant
Assistant de facturation optimisé par l’IA pour VS Code, Cursor et Windsurf — posez des questions, créez et planifiez dans votre éditeur
API Reference
Référence OpenAPI complète pour tous les endpoints Dodo Payments