Construya con Agentes de Codificación AI

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.

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.

​

Instalar el plugin

Elige abajo tu agente de programación. Cada instalación añade ambos servidores MCP. Todos los agentes, excepto Gemini CLI, también añaden las diecisiete skills. OpenCode necesita un ajuste adicional para cargarlas, descrito en su sección.

Claude Code

Instala desde el marketplace:

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

El servidor MCP de la API usa browser OAuth 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

Registra el marketplace y, después, instala desde la TUI de Codex.

1. Register the marketplace

   codex plugin marketplace add dodopayments/dodo-agent-plugin
   
2. Install from the Codex TUI

   Abre Codex y ejecuta /plugins:

   codex
   

   Escribe /plugins, cambia al marketplace de Dodo Payments, selecciona el plugin dodopayments y elige Install plugin.

Ambos servidores MCP y las diecisiete skills se registran automáticamente.

Si el plugin no aparece en /plugins, actualízalo:

codex plugin marketplace upgrade dodopayments

Para instalar 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

Clona el repositorio en el directorio de plugins locales de Cursor:

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

Reinicia Cursor. El plugin carga las skills desde skills/ y los servidores MCP desde .mcp.json.

Las versiones recientes de Cursor reconocen directamente Agent Plugins 1.0.0 y aceptan .claude-plugin/marketplace.json como origen de marketplace. El .cursor-plugin/plugin.json generado se conserva para versiones anteriores.

Si instalaste una versión anterior a la 0.5.0, elimina el directorio y vuelve a clonar; ahora las skills se distribuyen como archivos reales, no como enlaces simbólicos.

OpenCode

Instala el paquete del plugin en tu proyecto y, después, añádelo junto con su ruta de skills a tu 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"]
  }
}

Reinicia OpenCode. Ambos servidores MCP se registran automáticamente. Las skills necesitan la entrada adicional skills.paths porque OpenCode no busca skills en los paquetes instalados.

Las rutas relativas se resuelven respecto al directorio del proyecto, por lo que el paquete debe existir en el node_modules de ese proyecto. También funciona una ruta absoluta y evita el requisito de instalación local.

Verifica que las skills se hayan cargado:

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

Deberías ver las diecisiete. Una ruta de skills que no existe se ignora silenciosamente, así que debes verificarlo en lugar de darlo por hecho.

VS Code / GitHub Copilot

Clona el repositorio y regístralo:

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

Abre la vista Chat, ve a Plugins y añade la carpeta clonada. También puedes registrarla en settings.json:

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

La clave es una ruta y el valor la habilita. Funcionan tanto las rutas absolutas como ~/; las rutas relativas se resuelven respecto a cada carpeta del workspace. El ajuste se lee en tiempo real, por lo que una ventana en ejecución lo detecta sin reiniciarse.

chat.pluginLocations está marcado como experimental y es un ajuste restringido, por lo que el workspace debe ser de confianza. La compatibilidad con plugins de agente es una función de vista previa regida por chat.plugins.enabled, que está habilitada de forma predeterminada.

Kiro

Kiro lee de forma nativa el manifiesto de Agent Plugins.

1. Clone the repository

   git clone https://github.com/dodopayments/dodo-agent-plugin.git
   
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 skills 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 (MCP only)

Gemini CLI no tiene una primitiva de agent-skill, por lo que solo están disponibles los dos servidores MCP. dodo-knowledge cubre buena parte de lo que proporcionan las skills y se mantiene actualizado automáticamente.

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

Reinicia Gemini CLI. 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, tu agente tiene acceso a dos servidores MCP y diecisiete skills.

​

Servidores MCP

Servidor	Propósito	Autenticación
dodopayments-api	Acceso a la API en tiempo real: pagos, suscripciones, clientes, productos, reembolsos, licencias y uso	OAuth (browser)
dodo-knowledge	Búsqueda semántica en toda la documentación de Dodo Payments	Ninguna

Ambos servidores usan Streamable HTTP. El mcp.json canónico los declara de forma nativa, que es lo que utilizan los clientes compatibles con la especificación, como Codex CLI y Kiro. El manifiesto de compatibilidad generado .mcp.json los conecta mediante mcp-remote para clientes que no pueden conectarse directamente a Streamable HTTP.

​

Agent Skills

Skill	Descripción
dodo-best-practices	Configuración del SDK, entornos, claves de API y la arquitectura canónica de checkout a webhook
framework-adapters	Handlers de rutas oficiales @dodopayments/* para Next.js, Express, Hono, Astro, Remix, SvelteKit, Nuxt, Fastify, TanStack, Bun y Convex
testing-and-go-live	Test mode, métodos de pago de prueba, pruebas de webhooks y checklist de lanzamiento a producción
checkout-integration	Checkout Sessions, enlaces de pago y checkout superpuesto o integrado
subscription-integration	Ciclo de vida de las suscripciones, pruebas, cambios de plan, prorrateo y cargos bajo demanda
mobile-checkout	Checkout dentro de la aplicación para React Native, Flutter, iOS y Android
webhook-integration	Recepción y verificación de webhooks mediante la especificación Standard Webhooks
credit-based-billing	Entitlements de crédito, saldos, ledger, rollover, exceso de uso y deducción basada en medidores
usage-based-billing	Medidores, ingesta de eventos, agregación y precios por unidad
license-keys	Activación y validación de claves de licencia y gestión de instancias
product-catalog-management	Productos, precios, complementos, colecciones, imágenes y distribución de productos digitales
discounts-and-promotions	Códigos de descuento, reglas de elegibilidad, combinación y límites por ciclo de suscripción
localized-pricing	Precios localizados, adaptive currency y paridad del poder adquisitivo
customer-management	Clientes, portal de autoservicio, métodos de pago guardados y wallets
refunds-and-disputes	Emisión de reembolsos, gestión de disputas y contracargos, y conciliación del acceso
billing-sdk	Componentes React de BillingSDK para tablas de precios y UI de facturación
better-auth-integration	El plugin @dodopayments/better-auth para sincronización de clientes, checkout y acceso al portal

Las skills se cargan automáticamente: tu agente elige la adecuada cuando detecta una tarea relevante. Consulta Agent Skills para ver la lista completa y la instalación individual.

​

Prueba primero este prompt

Cuando el plugin esté activo, prueba lo siguiente:

Set up Dodo Payments webhook handlers in my Next.js app for payment.succeeded and subscription.active events.

Tu agente cargará la skill 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

El plugin sigue la especificación Agent Plugins 1.0.0. Los clientes con compatibilidad nativa lo cargan directamente; los demás usan manifiestos de compatibilidad generados.

​

Agentes con instalación de plugins

Una instalación conecta ambos servidores MCP, además de las skills en cada cliente que tenga una primitiva de skills.

Agente	Instalación	Skills	Servidores MCP
Claude Code	comando del marketplace	17	2
Codex CLI	comando del 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 necesita una entrada adicional skills.paths antes de cargar sus diecisiete skills. Gemini CLI no tiene una primitiva de agent-skill, por lo que las skills 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 skills mediante Skills CLI cuando sea compatible.

Agente	Servidores MCP	Skills
Claude Desktop	Guía de MCP Server	no compatible
Windsurf	Guía de MCP Server	Skills CLI
Cline / Zed / otros	Guía de MCP Server	Skills CLI

​

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 — índice completo para la ingesta de contexto
• Markdown plano: Añade .md a cualquier URL de documentación para obtener la versión Markdown sin procesar (por ejemplo, /api-reference/introduction.md)
• Repositorio del 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 Checkout Sessions y enlaces de pago — Pagos únicos y suscripciones
• Configurar la facturación de suscripciones y basada en el uso de principio a fin — Suscripciones, Facturación basada en el 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 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 de clientes — Reembolsos, Disputas, Customer portal
• Probar la integración y pasar a producción de forma segura — Test mode frente a live mode

​

Seguridad y buenas prácticas

Nunca confirmes claves de API live en el repositorio. Usa test mode durante el desarrollo.

• Usa primero test mode. Crea y prueba tu integración con una clave de API de test mode antes de pasar a producción. Consulta Test Mode frente a Live Mode.
• OAuth es el valor predeterminado. El Agent Plugin se autentica mediante browser OAuth, sin secretos locales. Usa 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 usa el servidor MCP remoto con browser OAuth. Para usar una clave de API local, por ejemplo en CI o en un servidor sin interfaz gráfica, cambia al modo stdio.

Local API key mode — Claude Code

Abre /plugins en Claude Code, selecciona Dodo Payments y elige Configure options. Completa lo siguiente:

• dodo_api_key — tu clave de API de test mode o live mode
• 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:

{
  "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}"
      }
    }
  }
}

Ejecuta /reload-plugins para aplicar los cambios.

Local API key mode — OpenCode

Declara dodopayments-api tú mismo en opencode.json; tu entrada tiene prioridad sobre el servidor remoto predeterminado del 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
    }
  }
}

Reinicia OpenCode para aplicar los cambios.

​

Próximos pasos

MCP Server

Referencia completa de ambos servidores MCP: clientes compatibles, configuración y herramientas disponibles

Agent Skills

Instalación individual de skills, referencia de skills e instrucciones de configuración por agente

API Reference

Referencia completa de OpenAPI para todos los endpoints de Dodo Payments