Construya con Agentes de Codificación AI - Dodo Payments Documentation

El Plugin Dodo Agent conecta dos servidores MCP y ocho habilidades de integración en su agente de codificación AI en una sola instalación. Funciona con Claude Code, Codex CLI, Cursor y OpenCode — y los servidores MCP y habilidades CLI funcionan con cualquier cliente compatible con MCP.

Tres elementos básicos, un plugin. El Plugin de Agente agrupa todo lo que necesita:

Servidor API MCP — acceso en vivo a pagos, suscripciones, clientes, productos, reembolsos, licencias y uso. Se autentica a través de OAuth del navegador (no se requieren claves locales).
Servidor de Conocimiento MCP — búsqueda semántica en toda la documentación de Dodo Payments. No se necesitan credenciales.
Ocho habilidades de agente — hojas de referencia que su agente carga a demanda para pagos, suscripciones, webhooks, facturación basada en uso, facturación basada en crédito, claves de licencia, BillingSDK y mejores prácticas.

Instalar el plugin

Elija su agente de codificación a continuación. La instalación agrega ambos servidores MCP y las ocho habilidades automáticamente.

Claude Code

Instalar desde el marketplace:

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

El servidor API MCP utiliza OAuth del navegador por defecto — no se requieren claves al momento de la instalación. La primera vez que su agente llame a una herramienta Dodo, se le pedirá que inicie sesión.

Dodo Agent Plugin on GitHub

Código fuente, opciones de configuración e instrucciones de desarrollo local

Codex CLI

Codex instala plugins en dos pasos: registra el marketplace desde tu terminal y luego instala el plugin desde dentro de la TUI de Codex.

codex plugin marketplace add dodopayments/dodo-agent-plugin

Install from the Codex TUI

Abre Codex y ejecuta el comando /plugins:

codex

Luego escribe /plugins, cambia al marketplace Dodo Payments, selecciona el plugin dodopayments y elige Instalar plugin.

Ambos servidores MCP y las ocho habilidades se registran automáticamente una vez instalado el plugin.

Codex CLI no tiene un subcomando codex plugin install — la instalación de plugins siempre ocurre a través del flujo /plugins dentro de la TUI. Consulta los documentos oficiales de plugins de Codex.

Si previamente agregaste el marketplace y el plugin no aparece bajo /plugins, actualízalo:

codex plugin marketplace upgrade dodopayments

Cursor

Instalación manual — 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 habilidades desde .claude/skills/ (a través de la capa de compatibilidad de Cursor con Claude Code) y servidores MCP desde .mcp.json.

El soporte del marketplace de Cursor está en camino. Por ahora, utiliza la instalación manual anterior.

OpenCode

OpenCode se distribuye a través de npm. Agrega el plugin a tu opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@dodopayments/opencode-plugin"]
}

Reinicia OpenCode. Ambos servidores MCP (dodopayments-api, dodo-knowledge) se registran automáticamente a través del hook de configuración del plugin, y las ocho habilidades se descubren automáticamente desde el paquete instalado. No se requiere bloque manual mcp.

¿Usando un agente diferente? Las guías MCP Server y Agent Skills cubren Cursor, Claude Desktop, VS Code, Windsurf, Cline, Zed, y cualquier cliente compatible con MCP.

Lo que obtienes

Una vez que el plugin está instalado, tu agente tiene acceso a dos servidores MCP y ocho habilidades.

Servidores MCP

Servidor	Propósito	Autenticación
`dodopayments-api`	Acceso API en vivo — pagos, suscripciones, clientes, productos, reembolsos, licencias, uso	OAuth (navegador)
`dodo-knowledge`	Búsqueda semántica en toda la documentación de Dodo Payments	Ninguna

Ambos servidores están conectados a través de mcp-remote para que funcionen en cualquier cliente compatible con MCP.

Habilidades del agente

Habilidad	Descripción
`best-practices`	Guía completa para integrar Dodo Payments con mejores prácticas
`checkout-integration`	Creación de sesiones de pago y flujos de pago
`subscription-integration`	Implementación de flujos de facturación por suscripción
`webhook-integration`	Configuración y manejo de webhooks para eventos de pago
`usage-based-billing`	Implementación de facturación medida con eventos y medidores
`credit-based-billing`	Asignaciones de crédito, saldos y deducción de crédito medida
`license-keys`	Gestión de claves de licencia para productos digitales
`billing-sdk`	Uso de componentes React del BillingSDK

Las habilidades se cargan automáticamente — tu agente elige la correcta cuando detecta una tarea relevante. Consulta la documentación de Habilidades del Agente para ver la lista completa y la instalación individual.

Prueba este prompt primero

Una vez que el plugin esté activo, prueba:

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

Tu agente cargará la habilidad webhook-integration, utilizará el MCP dodo-knowledge para obtener las últimas formas de carga útil y escribirá un controlador con verificación de firma siguiendo la especificación de Webhooks Estándar.

Otros agentes compatibles

El Plugin de Agente cubre Claude Code, Codex CLI, Cursor y OpenCode. Si usas un agente diferente, conéctate a Dodo Payments a través de los servidores MCP y el CLI de habilidades:

Agente	Camino más rápido	También soporta
Claude Code	Plugin de Agente (un comando)	Servidor MCP, habilidades individuales
Codex CLI	Plugin de Agente (un comando)	Servidor MCP
Cursor	Plugin de Agente (clonado git)	Configuración del servidor MCP, CLI de habilidades
OpenCode	Plugin de Agente (npm)	Configuración del servidor MCP, CLI de habilidades
GitHub Copilot (VS Code)	Guía del Servidor MCP	CLI de habilidades
Claude Desktop	Guía del Servidor MCP	—
Windsurf	Guía del Servidor MCP	CLI de habilidades
Cline / Zed / otros	Guía del Servidor MCP	CLI de habilidades

Documentos creados para agentes

Cada página de documentación de Dodo Payments está disponible en un formato optimizado para consumo por IA:

Índice completo de documentos: docs.dodopayments.com/llms.txt — sirve el índice completo de la documentación para la ingestión de contexto.
Markdown simple: Añade .md a cualquier URL de documentación para obtener la versión en markdown sin formato (por ejemplo, /api-reference/introduction.md).
Repositorio de código fuente: github.com/dodopayments/dodo-docs — clona para indexación sin conexión.

Lo que tu agente puede hacer

Con el plugin instalado, tu agente de codificación puede:

Crea sesiones de pago y enlaces de pago — Pagos únicos y suscripciones
Configura la facturación por suscripción y basada en uso de extremo a extremo — Suscripciones, Facturación basada en uso, Facturación basada en créditos
Genera manejadores compatibles con Webhooks estándar con verificación de firma — Webhooks
Conecta los componentes React de BillingSDK para tablas de precios y gestión de suscripciones — BillingSDK
Crea flujos de claves de licencia para productos digitales — Claves de licencia
Implementa facturación basada en créditos con derechos, saldos, rollover y exceso — Créditos

Seguridad y mejores prácticas

Nunca comprometas claves API de producción. Usa modo de prueba durante el desarrollo. El Plugin de Agente utiliza OAuth de navegador por defecto — solo cambia a claves API locales si tu flujo de trabajo lo requiere.

Usa primero el modo de prueba. Prueba tu integración con claves dodo_test_... antes de ir en vivo. Consulta Modo de Prueba vs Modo en Vivo.
OAuth es el modo predeterminado. El Plugin de Agente se autentica a través de OAuth de navegador (sin secretos locales). Solo usa el modo de claves API si lo necesitas — consulta la sección Configurar abajo.
Revisa el código generado por el agente. Siempre verifica que los manejadores de webhooks incluyan la verificación de firma siguiendo la Especificación de Webhooks Estándar.

Configura con una clave API

Por defecto, el Plugin de Agente utiliza el servidor MCP remoto con OAuth de navegador — no se necesitan credenciales locales. Si tu flujo de trabajo requiere una clave API local (por ejemplo, entornos CI, servidores sin cabeza), puedes cambiar a modo stdio.

Local API key mode — Claude Code

Abre /plugins en Claude Code, selecciona Dodo Payments, y elige Configurar opciones. Completa:

dodo_api_key — tu clave dodo_test_... o dodo_live_...
dodo_webhook_key — tu secreto de firma de webhook
dodo_environment — test_mode o live_mode

Luego edita .mcp.json para apuntar 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 cambios a tu sesión actual.

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": "dodo_test_...",
        "DODO_PAYMENTS_WEBHOOK_KEY": "whsec_...",
        "DODO_PAYMENTS_ENVIRONMENT": "test_mode"
      },
      "enabled": true
    }
  }
}

Reinicia OpenCode para aplicar.

Próximos pasos

MCP Server

Referencia completa para ambos servidores MCP — todos los clientes soportados, configuración y herramientas disponibles

Agent Skills

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

Sentra IDE Assistant

Asistente de facturación impulsado por IA para VS Code, Cursor y Windsurf — pregunta, construye y planifica en tu editor

API Reference

Referencia completa de OpenAPI para todos los puntos finales de Dodo Payments

Documentation Index

​Instalar el plugin

Dodo Agent Plugin on GitHub

​Lo que obtienes

​Servidores MCP

​Habilidades del agente

​Prueba este prompt primero

​Otros agentes compatibles

​Documentos creados para agentes

​Lo que tu agente puede hacer

​Seguridad y mejores prácticas

​Configura con una clave API

​Próximos pasos

MCP Server

Agent Skills

Sentra IDE Assistant

API Reference

Instalar el plugin

Lo que obtienes

Servidores MCP

Habilidades del agente

Prueba este prompt primero

Otros agentes compatibles

Documentos creados para agentes

Lo que tu agente puede hacer

Seguridad y mejores prácticas

Configura con una clave API

Próximos pasos