Skip to main content
Instala el Dodo Agent Plugin para proporcionar a tu agente de programación dos servidores MCP y diecisiete habilidades para crear integraciones con Dodo Payments. Después de instalarlo, describe lo que quieres crear y tu agente planificará y escribirá la integración. El plugin funciona con Claude Code, Codex CLI, Cursor, VS Code / GitHub Copilot, Kiro y OpenCode. Gemini CLI solo obtiene los dos servidores MCP. El plugin sigue la especificación Agent Plugins 1.0.0. Los clientes con soporte nativo lo cargan directamente; los demás utilizan manifiestos de compatibilidad generados. Lo que obtienes:
  • 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

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
Registra el marketplace y, después, instala desde la TUI de Codex.
1

Register the marketplace

2

Install from the Codex TUI

Abre Codex y ejecuta /plugins:
Escribe /plugins, cambia al marketplace de Dodo Payments, selecciona el plugin dodopayments y elige Install plugin.
Ambos servidores MCP y las diecisiete habilidades se registran automáticamente.Si el plugin no aparece en /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.
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.
Instala el paquete del plugin en tu proyecto y, después, añádelo junto con la ruta de sus habilidades a opencode.json:
Reinicia OpenCode. Ambos servidores MCP se registran automáticamente. Las habilidades necesitan la entrada adicional 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:
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.
Clona el repositorio y regístralo:
Abre la vista Chat, ve a Plugins y añade la carpeta clonada. También puedes registrarla en settings.json:
La clave es una ruta y el valor la habilita. Funcionan tanto las rutas absolutas como ~/; 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 lee el manifiesto de Agent Plugins de forma nativa.
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.
Las habilidades se cargan desde 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 no tiene una primitiva de habilidades de agente, por lo que solo están disponibles los dos servidores MCP. dodo-knowledge cubre una parte importante de lo que proporcionan las habilidades y se mantiene actualizado automáticamente.
Reinicia Gemini CLI. gemini-extension.json en la raíz del repositorio es el manifiesto.
¿Usas otro agente? Las guías MCP Server y Agent Skills abarcan Claude Desktop, Windsurf, Cline, Zed y cualquier cliente compatible con MCP.

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:
Tu agente cargará la habilidad 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 .md a 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:

Seguridad y prácticas recomendadas

Nunca confirmes claves de API activas en el repositorio. Utiliza el modo de prueba durante el desarrollo.
  • 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.
Abre /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 activo
  • dodo_webhook_key — tu secreto de firma de webhook
  • dodo_environment — test_mode o live_mode
Después, edita .mcp.json para dirigir dodopayments-api al servidor stdio local:
Ejecuta /reload-plugins para aplicar los cambios.
Declara dodopayments-api tú mismo en opencode.json; tu entrada prevalece sobre el servidor remoto predeterminado del plugin:
Reinicia OpenCode para aplicar los cambios.

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
Última modificación el 26 de septiembre de 2026