- Servidor MCP de Dodo Payments API — acceso en tiempo real a pagos, suscripciones, clientes, productos, reembolsos, licencias y uso. Se autentica mediante OAuth en el navegador (no se requieren claves locales).
- Servidor MCP de conocimiento de Dodo — búsqueda semántica en toda la documentación de Dodo Payments. No se requieren credenciales.
- Diecisiete habilidades de agente — guías rápidas 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 prácticas recomendadas.
Instalar el plugin
Elige tu agente de programación a continuación. Cada instalación añade ambos servidores MCP. Todos los agentes, excepto Gemini CLI, también añaden las diecisiete habilidades. OpenCode necesita una configuración adicional para cargarlas, descrita en su sección.Claude Code
Claude Code
Instálalo desde el marketplace:El servidor MCP de API utiliza OAuth en el 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
Registra el marketplace y, después, instala desde la TUI de Codex.Ambos servidores MCP y las diecisiete habilidades se registran automáticamente.Si el plugin no aparece en
1
Register the marketplace
2
Install from the Codex TUI
Abre Codex y ejecuta Escribe
/plugins:/plugins, cambia al marketplace de Dodo Payments, selecciona el plugin dodopayments y elige Install plugin./plugins, actualízalo:Para instalarlo desde tu shell en lugar de la TUI, ejecuta
codex plugin add dodopayments@dodopayments después de registrar el marketplace. Codex CLI no tiene el subcomando codex plugin install. Consulta la documentación oficial de plugins de Codex.Cursor
Cursor
Clona el repositorio en el directorio local de plugins de Cursor:Reinicia Cursor. El plugin carga las habilidades desde
skills/ y los servidores MCP desde .mcp.json.Las versiones recientes de Cursor reconocen Agent Plugins 1.0.0 directamente y aceptan .claude-plugin/marketplace.json como fuente de marketplace. El .cursor-plugin/plugin.json generado se conserva para las versiones anteriores.Si instalaste una versión anterior a la 0.5.0, elimina el directorio y vuelve a clonar: ahora las habilidades se distribuyen como archivos reales, no como enlaces simbólicos.OpenCode
OpenCode
Instala el paquete del plugin en tu proyecto y, después, añádelo junto con la ruta de sus habilidades a Reinicia OpenCode. Ambos servidores MCP se registran automáticamente. Las habilidades necesitan la entrada adicional Deberías ver las diecisiete. Una ruta de habilidades que no existe se ignora silenciosamente, así que debes comprobarlo en lugar de darlo por hecho.
opencode.json:skills.paths porque OpenCode no busca habilidades en los paquetes instalados.Las rutas relativas se resuelven en relación con el directorio del proyecto, por lo que el paquete debe existir en node_modules de ese proyecto. También funciona una ruta absoluta y evita el requisito de instalación local.Comprueba que las habilidades se hayan cargado:VS Code / GitHub Copilot
VS Code / GitHub Copilot
Clona el repositorio y regístralo:Abre la vista Chat, ve a Plugins y añade la carpeta clonada. También puedes registrarla en La clave es una ruta y el valor la habilita. Funcionan tanto las rutas absolutas como
settings.json:~/; las rutas relativas se resuelven en relación con cada carpeta del workspace. La configuración se lee en tiempo real, por lo que una ventana en ejecución la detecta sin reiniciarse.chat.pluginLocations está marcado como experimental y es una configuración restringida, por lo que el workspace debe ser de confianza. La compatibilidad con Agent Plugin es una función preliminar regida por chat.plugins.enabled, que está activada de forma predeterminada.Kiro
Kiro
Kiro lee el manifiesto de Agent Plugins de forma nativa.Las habilidades 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/ y los servidores MCP desde mcp.json. Kiro gestiona internamente los servidores MCP; no se escriben en ~/.kiro/settings/mcp.json. 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 habilidades de agente, por lo que solo están disponibles los dos servidores MCP. Reinicia Gemini CLI.
dodo-knowledge cubre una parte importante de lo que proporcionan las habilidades y se mantiene actualizado automáticamente.gemini-extension.json en la raíz del repositorio es el manifiesto.Lo que obtienes
Una vez instalado, tu agente tiene acceso a dos servidores MCP y diecisiete habilidades.Servidores MCP
Ambos servidores utilizan Streamable HTTP. El
mcp.json canónico los declara de forma nativa, que es lo que utilizan los clientes compatibles de forma nativa con la especificación, como Codex CLI y Kiro. El manifiesto de compatibilidad generado .mcp.json los conecta mediante mcp-remote para los clientes que no pueden conectarse directamente a Streamable HTTP.
Habilidades de agente
Las habilidades se cargan automáticamente: tu agente elige la adecuada cuando detecta una tarea pertinente. Consulta Agent Skills para ver la lista completa y la instalación individual.
Prueba primero este prompt
Una vez activado el plugin, prueba lo siguiente:webhook-integration, utilizará el MCP dodo-knowledge para obtener las estructuras de payload más recientes y escribirá un handler con verificación de firma siguiendo la especificación Standard Webhooks.
Compatibilidad con clientes
Agentes con instalación de plugins
Una instalación conecta ambos servidores MCP, además de las habilidades en cada cliente que tenga una primitiva de habilidades.
OpenCode necesita una entrada adicional
skills.paths antes de cargar sus diecisiete habilidades. Gemini CLI no tiene una primitiva de habilidades de agente, por lo que las habilidades no están disponibles 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 las habilidades mediante Skills CLI cuando sea compatible.Documentación creada para agentes
Cada página de la 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— índice completo de la documentación para la ingestión de contexto - Markdown sin formato: añade
.mda cualquier URL de documentación para obtener la versión Markdown sin procesar (por ejemplo,/api-reference/introduction.md) - Repositorio de código fuente:
github.com/dodopayments/dodo-docs— clónalo para indexarlo sin conexión
Lo que tu agente puede hacer
Con el plugin instalado, tu agente de programación puede:- Crear Checkout Sessions y enlaces de pago — Pagos únicos y suscripciones
- Implementar la facturación basada en suscripciones y en uso de principio a fin — 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 route handlers en tu framework mediante los adaptadores oficiales — Adaptadores de frameworks
- Conectar 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 complementos y colecciones — Productos, Complementos, Colecciones de productos
- Añadir descuentos y precios localizados — Códigos de descuento, Precios localizados, Adaptive Currency
- Ofrecer checkout móvil dentro de la aplicación para React Native, Flutter, iOS y Android — Integración móvil
- Gestionar reembolsos, disputas y autoservicio del cliente — 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 prácticas recomendadas
- Utiliza primero el modo de prueba. Crea y prueba tu integración con una clave de API del modo de prueba antes de pasar a producción. Consulta Modo de prueba frente a modo activo.
- OAuth es la opción predeterminada. El Agent Plugin se autentica mediante OAuth en el navegador (sin secretos locales). Utiliza el modo de clave de API solo si lo necesitas.
- Revisa el código generado por el agente. Verifica siempre que los handlers de webhook incluyan verificación de firma siguiendo la especificación Standard Webhooks.
Configurar con una clave de API
De forma predeterminada, el Agent Plugin utiliza el servidor MCP remoto con OAuth en el navegador. Para utilizar una clave de API local en su lugar, por ejemplo en CI o en un servidor sin interfaz gráfica, cambia 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 clave de API del modo de prueba o del modo activododo_webhook_key— tu secreto de firma de webhookdodo_environment—test_modeolive_mode
.mcp.json para dirigir dodopayments-api al servidor stdio local:/reload-plugins para aplicar los cambios.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 para ambos servidores MCP: todos los clientes compatibles, la configuración y las herramientas disponibles
Agent Skills
Instalación individual de habilidades, referencia de habilidades e instrucciones de configuración por agente
API Reference
Referencia completa de OpenAPI para todos los endpoints de Dodo Payments