plugin.json y mcp.json. Los clientes anteriores a la especificación cargan el mismo contenido mediante manifiestos de compatibilidad generados.
Tres primitivas, un plugin. El Agent Plugin incluye todo lo que necesitas:
- Servidor MCP de API: acceso en tiempo real a pagos, suscripciones, clientes, productos, reembolsos, licencias y uso. Se autentica mediante OAuth del navegador (no se necesitan claves locales).
- Servidor MCP de conocimiento: búsqueda semántica en toda la documentación de Dodo Payments. No se necesitan credenciales.
- Diecisiete skills de agente: hojas de referencia que tu agente carga bajo demanda para checkout, suscripciones, webhooks, facturación basada en uso y en créditos, claves de licencia, catálogo de productos, descuentos, precios localizados, checkout móvil, reembolsos y disputas, gestión de clientes, adaptadores de frameworks, BillingSDK, Better Auth, pruebas y puesta en producción, y buenas prácticas.
Instalar el plugin
Elige tu agente de programación a continuación. Cada instalación añade ambos servidores MCP; todos, excepto Gemini CLI, también añaden las diecisiete skills.Claude Code
Claude Code
Instálalo desde el marketplace:El servidor MCP de API usa OAuth del navegador de forma predeterminada; no se necesitan claves durante la instalación. La primera vez que tu agente llame a una herramienta de Dodo, se te pedirá que inicies sesión.
Dodo Agent Plugin on GitHub
Código fuente, opciones de configuración e instrucciones para el desarrollo local
Codex CLI
Codex CLI
Codex instala plugins en dos pasos: registra el marketplace desde tu shell y, después, instala el plugin desde la TUI de Codex.Ambos servidores MCP y las diecisiete skills se registran automáticamente una vez instalado el plugin.Si ya habías añadido el marketplace y el plugin no aparece en
1
Register the marketplace
2
Install from the Codex TUI
Abre Codex y ejecuta el comando slash Después, escribe
/plugins:/plugins, cambia al marketplace de Dodo Payments, selecciona el plugin dodopayments y elige Install plugin.Codex CLI no tiene un subcomando
codex plugin install; la instalación del plugin siempre se realiza mediante el flujo /plugins dentro de la TUI. Consulta la documentación oficial de plugins de Codex./plugins, actualízalo:Cursor
Cursor
Instalación manual: clona el repositorio en el directorio de plugins local de Cursor:Reinicia Cursor. El plugin carga las skills desde
skills/ y los servidores MCP desde .mcp.json, según lo declarado en .cursor-plugin/plugin.json.Las versiones recientes de Cursor también reconocen directamente Agent Plugins 1.0.0 y aceptan
.cursor-plugin/marketplace.json o .claude-plugin/marketplace.json como fuente del marketplace. Este plugin incluye .claude-plugin/marketplace.json; usa esa ruta. El .cursor-plugin/plugin.json generado se conserva para versiones anteriores.OpenCode
OpenCode
OpenCode se distribuye mediante npm. Añade el plugin a tu Reinicia OpenCode. Ambos servidores MCP (Las entradas relativas de
opencode.json:dodopayments-api, dodo-knowledge) se registran automáticamente mediante el hook de configuración del plugin. No se necesita ningún bloque mcp manual.Las skills necesitan una línea adicional. OpenCode no busca skills en los paquetes instalados, así que debes indicarle el directorio skills/ del paquete:skills.paths se resuelven respecto al directorio del proyecto, por lo que el paquete debe existir en el node_modules de ese proyecto; la caché de plugins propia de OpenCode se encuentra en otra ubicación. También funciona una ruta absoluta y evita el requisito de instalación local.VS Code / GitHub Copilot
VS Code / GitHub Copilot
Clona el repositorio en cualquier ubicación y regístralo:Abre la vista Chat, ve a Plugins y añade la carpeta clonada. También puedes registrarla directamente en La clave es una ruta y el valor la habilita. Funcionan tanto las rutas absolutas como
settings.json:~/; una ruta relativa se resuelve respecto a cada carpeta del workspace. La configuración se lee en tiempo real, por lo que una ventana en ejecución la adopta sin reiniciarse. Las skills se cargan desde skills/ y ambos servidores MCP desde .mcp.json.chat.pluginLocations está marcado como experimental y es una configuración restringida, por lo que el workspace debe ser de confianza para que se aplique. La compatibilidad general con plugins de agentes es una función preliminar controlada por chat.plugins.enabled, que está activada de forma predeterminada; solo tienes que establecerla si tu organización la deshabilita mediante una política.VS Code no utiliza
$schema de Agent Plugins como clave. Su cargador busca primero .plugin/plugin.json, después .claude-plugin/plugin.json y luego una raíz plugin.json; además, establece MCP en .mcp.json en lugar de mcp.json. Como este repositorio incluye un .claude-plugin/plugin.json generado, VS Code lo carga mediante esa rama de compatibilidad y obtiene el puente mcp-remote en lugar de los transportes nativos de mcp.json. Todo funciona; la ruta es diferente.Kiro
Kiro
Kiro lee el manifiesto de Agent Plugins de forma nativa y lo carga como un Power.Las skills se cargan desde
1
Clone the repository
2
Open the Powers panel
En Kiro, abre el panel Powers: el icono de Ghosty con el rayo.
3
Import the folder
Elige Add Custom Power → Import power from a folder, selecciona el directorio clonado (el que contiene
plugin.json) y haz clic en Install.skills/, los servidores MCP desde mcp.json y la presentación específica de Kiro procede del espacio de nombres de extensión dev.kiro en plugin.json.En los plugins con formato Agent Plugins, Kiro gestiona internamente los servidores MCP; no se escriben en tu
~/.kiro/settings/mcp.json de nivel de usuario, así que no esperes encontrarlos allí. Kiro también puede instalar un Power directamente desde una URL de GitHub; consulta la documentación de instalación de Kiro.Gemini CLI (MCP only)
Gemini CLI (MCP only)
Gemini CLI no tiene una primitiva de agent-skill, por lo que solo están disponibles los dos servidores MCP; las diecisiete skills no lo están. Reinicia Gemini CLI.
dodo-knowledge sigue cubriendo buena parte de lo que ofrecen las skills y se mantiene actualizado automáticamente.gemini-extension.json en la raíz del repositorio es el manifiesto.¿Usas otro agente? Las guías de MCP Server y Agent Skills abarcan Claude Desktop, Windsurf, Cline, Zed y cualquier cliente compatible con MCP.
Qué obtienes
Una vez instalado el plugin, tu agente tiene acceso a dos servidores MCP y diecisiete skills.Servidores MCP
Ambos servidores utilizan Streamable HTTP. El
mcp.json canónico los declara de forma nativa (type: "streamable-http"), que es lo que usan clientes nativos de la especificación como Codex CLI y Kiro. El manifiesto de compatibilidad generado .mcp.json conecta los mismos dos endpoints mediante mcp-remote, de modo que también se ejecutan en clientes que no pueden conectarse directamente a Streamable HTTP: Claude Code, VS Code y Cursor mediante la instalación por clonación de git documentada anteriormente, cuyo .cursor-plugin/plugin.json apunta a .mcp.json.
Skills de agente
Las skills se cargan automáticamente: tu agente elige la adecuada cuando detecta una tarea relevante. Consulta la documentación de Agent Skills para ver la lista completa y la instalación individual.
Prueba primero este prompt
Una vez activo el plugin, prueba:webhook-integration, usará el MCP dodo-knowledge para obtener las formas de payload más recientes y escribirá un handler con verificación de firma siguiendo la especificación Standard Webhooks.
Compatibilidad con clientes
Clientes con instalación de Agent Plugin
Una instalación conecta ambos servidores MCP, además de las skills en todos los clientes que cuentan con una primitiva de skills.- OpenCode necesita una entrada
skills.pathsadicional antes de cargar sus diecisiete skills; consulta la sección de instalación anterior. - Gemini CLI no tiene una primitiva de agent-skill, por lo que las skills no están disponibles allí por diseño.
Otros clientes compatibles con MCP
Estos no tienen instalación de Agent Plugin. Configura manualmente los dos servidores MCP y añade skills mediante la Skills CLI cuando sea compatible.Documentación creada para agentes
Cada página de documentación de Dodo Payments está disponible en un formato optimizado para el consumo por parte de la IA:- Índice completo de la documentación:
docs.dodopayments.com/llms.txt: proporciona el índice completo de la documentación para la ingesta de contexto. - Markdown sin formato: añade
.mda cualquier URL de documentación para obtener la versión Markdown sin formato (por ejemplo,/api-reference/introduction.md). - Repositorio de código fuente:
github.com/dodopayments/dodo-docs: clónalo para indexarlo sin conexión.
Qué puede hacer tu agente
Con el plugin instalado, tu agente de programación puede:- Crear sesiones de checkout y enlaces de pago: Pagos únicos y suscripciones
- Configurar la facturación basada en suscripciones y en uso de extremo a extremo: Suscripciones, Facturación basada en uso, Facturación basada en créditos
- Generar handlers compatibles con Standard Webhooks con verificación de firma: Webhooks
- Montar handlers de rutas en tu framework mediante los adaptadores oficiales: Adaptadores de frameworks
- Integrar componentes React de BillingSDK para tablas de precios y gestión de suscripciones: BillingSDK
- Crear flujos de claves de licencia para productos digitales: Claves de licencia
- Implementar facturación basada en créditos con entitlements, saldos, rollover y exceso de uso: Créditos
- Crear y gestionar tu catálogo de productos con add-ons y colecciones: Productos, Add-ons, Colecciones de productos
- Añadir descuentos y precios localizados: Códigos de descuento, Precios localizados, Adaptive Currency
- Ofrecer checkout móvil integrado en la aplicación para React Native, Flutter, iOS y Android: Integración móvil
- Gestionar reembolsos, disputas y autoservicio de clientes: Reembolsos, Disputas, Customer Portal
- Probar la integración y pasar a producción de forma segura: Modo de prueba frente a modo activo
Seguridad y buenas prácticas
- Usa primero el modo de prueba. Pon tu integración en sandbox con claves
dodo_test_...antes de pasar a producción. Consulta Modo de prueba frente a modo activo. - OAuth es el valor predeterminado. El Agent Plugin se autentica mediante OAuth del navegador (sin secretos locales). Usa el modo de clave de API solo si lo necesitas; consulta la sección Configurar más abajo.
- Revisa el código generado por el agente. Verifica siempre que los handlers de webhooks incluyan verificación de firma conforme a la especificación Standard Webhooks.
Configurar con una clave de API
De forma predeterminada, el Agent Plugin usa el servidor MCP remoto con OAuth del navegador; no se necesitan credenciales locales. Si tu flujo de trabajo requiere una clave de API local (por ejemplo, entornos de CI o servidores sin interfaz), puedes cambiar al modo stdio.Local API key mode — Claude Code
Local API key mode — Claude Code
Abre Ejecuta
/plugins en Claude Code, selecciona Dodo Payments y elige Configure options. Completa lo siguiente:dodo_api_key: tu clavedodo_test_...ododo_live_...dodo_webhook_key: tu secreto de firma de webhookdodo_environment:test_modeolive_mode
.mcp.json para apuntar dodopayments-api al servidor stdio local:/reload-plugins para aplicar los cambios a tu sesión actual.Local API key mode — OpenCode
Local API key mode — OpenCode
Declara Reinicia OpenCode para aplicar los cambios.
dodopayments-api tú mismo en opencode.json; tu entrada prevalece sobre el servidor remoto predeterminado del plugin:Próximos pasos
MCP Server
Referencia completa de ambos servidores MCP: todos los clientes compatibles, configuración y herramientas disponibles
Agent Skills
Instalación individual de skills, referencia de skills e instrucciones de configuración para cada agente
Sentra IDE Assistant
Asistente de facturación basado en IA para VS Code, Cursor y Windsurf: pregunta, crea y planifica en tu editor
API Reference
Referencia completa de OpenAPI para todos los endpoints de Dodo Payments