Saltar al contenido principal

Descripción general

El Protocolo de Contexto del Modelo (MCP) es un estándar abierto que permite a las aplicaciones de IA conectarse de forma segura a fuentes de datos externas y APIs. El Servidor MCP de Dodo Payments proporciona a asistentes de IA como Claude, Cursor y otros clientes compatibles con MCP acceso estructurado a tu infraestructura de pagos. El servidor MCP de Dodo Payments utiliza la arquitectura Code Mode. En lugar de exponer cientos de herramientas individuales para cada endpoint de la API, Code Mode permite que los agentes de IA escriban y ejecuten código TypeScript contra el SDK de Dodo Payments en un entorno aislado tipo sandbox.

Capacidades clave

  • Operaciones de Pago: Crear, recuperar y gestionar pagos y reembolsos
  • Gestión de Suscripciones: Manejar facturación recurrente, actualizaciones y cancelaciones
  • Administración de Clientes: Gestionar datos de clientes y acceso al portal
  • Catálogo de Productos: Crear y actualizar productos, precios y descuentos
  • Gestión de Licencias: Activar, validar y gestionar licencias de software
  • Facturación Basada en Uso: Rastrear y facturar por uso medido

Cómo Funciona el Modo de Código

El servidor MCP de Dodo Payments ofrece a tu agente de IA exactamente dos herramientas:
  1. Docs Search Tool: Consulta la documentación sobre la API y el SDK de Dodo Payments para comprender las operaciones y parámetros disponibles.
  2. Code Execution Tool: Escribe código TypeScript contra el SDK que se ejecuta en un entorno sandbox seguro.
Esta arquitectura permite a los agentes realizar operaciones complejas de múltiples pasos en una sola invocación. Por ejemplo, un agente puede listar todas las suscripciones activas, filtrarlas según criterios específicos y aplicar un descuento a cada una, todo dentro de un único script.
Mediante Code Mode, los agentes pueden encadenar múltiples llamadas a la API, manejar lógica condicional y realizar cálculos sin requerir múltiples viajes de ida y vuelta al LLM.

Configuración rápida

Conéctate al servidor MCP de Dodo Payments desde tu cliente de IA:
Agrega a ~/.cursor/mcp.json:
{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"]
    }
  }
}
Requiere Node.js 18 o superior. El servidor remoto utiliza OAuth para autenticación: se te solicitará ingresar tu clave de API y seleccionar tu entorno en la primera conexión.

Dodo Knowledge MCP

Además del servidor MCP de Dodo Payments (para ejecutar operaciones de API), ofrecemos Dodo Knowledge MCP, un servidor de búsqueda semántica que brinda a los asistentes de IA acceso instantáneo a la documentación y base de conocimientos de Dodo Payments.
Desarrollado con ContextMCP.ai: Dodo Knowledge MCP funciona con ContextMCP, lo que permite búsquedas semánticas rápidas en nuestra documentación mediante incrustaciones vectoriales.

¿Qué es Dodo Knowledge MCP?

Dodo Knowledge MCP es un servidor MCP remoto que ofrece:
  • Búsqueda semántica de documentación: Encuentra documentación relevante utilizando consultas en lenguaje natural.
  • Respuestas contextuales: Los asistentes de IA obtienen información precisa y actualizada sobre Dodo Payments.
  • Configuración cero: No se requieren claves de API ni instalación local: simplemente conéctate y comienza a consultar.

Configuración rápida

Conéctate a Dodo Knowledge MCP desde tu cliente de IA:
Agrega a ~/.cursor/mcp.json:
{
  "mcpServers": {
    "dodo-knowledge": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://knowledge.dodopayments.com/mcp"]
    }
  }
}
Requiere Node.js 18 o superior. El paquete mcp-remote gestiona la conexión con el servidor MCP remoto.

Usar ambos servidores MCP juntos

Para la mejor experiencia de desarrollo asistido por IA, recomendamos usar ambos servidores MCP:
ServidorPropósitoCaso de uso
Dodo Knowledge MCPBúsqueda de documentación«¿Cómo gestiono los webhooks?», «¿Qué métodos de pago son compatibles?»
Dodo Payments MCPOperaciones de APICrear pagos, gestionar suscripciones, procesar reembolsos
{
  "mcpServers": {
    "dodo-knowledge": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://knowledge.dodopayments.com/mcp"]
    },
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"]
    }
  }
}
Con ambos servidores configurados, tu asistente de IA puede primero buscar documentación para comprender cómo implementar una función y luego ejecutar las llamadas reales a la API, todo dentro de una sola conversación.

Solución de problemas de Knowledge MCP

Si encuentras problemas de conexión:
  1. Borra la caché de autenticación de MCP: rm -rf ~/.mcp-auth
  2. Reinicia tu aplicación cliente
  3. Consulta los registros del cliente en busca de mensajes de error
  4. Verifica la versión de Node.js: Requiere Node.js 18+

Knowledge MCP Server

Accede a la página de configuración de Dodo Knowledge MCP

Instalación

Elige el método de instalación que mejor se adapte a tu flujo de trabajo.

Servidor MCP remoto (recomendado)

Accede al servidor MCP alojado sin ninguna configuración o instalación local. Esta es la forma más rápida de comenzar.
1

Access the remote server

Navega a https://mcp.dodopayments.com en tu navegador.
2

Configure your MCP client

Copia la configuración JSON proporcionada para tu cliente específico. Para Cursor o Claude Desktop, agrégala a tus ajustes de MCP:
{
  "mcpServers": {
    "dodopayments_api": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"]
    }
  }
}
3

Authenticate and configure

El flujo OAuth te pedirá que:
  • Ingreses tu clave de API de Dodo Payments
  • Selecciones tu entorno (test o producción)
  • Elijas tu tipo de cliente MCP
Mantén tu clave de API segura. Usa claves en modo test durante el desarrollo.
4

Complete setup

Haz clic en Login and Approve para autorizar la conexión.
Una vez conectado, tu asistente de IA puede interactuar con la API de Dodo Payments en tu nombre.

Paquete NPM

Instala y ejecuta el servidor MCP localmente usando NPM.
# Set your environment variables
export DODO_PAYMENTS_API_KEY="dodo_test_..."
export DODO_PAYMENTS_WEBHOOK_KEY="your_webhook_key"
export DODO_PAYMENTS_ENVIRONMENT="live_mode"

# Run the latest version
npx -y dodopayments-mcp@latest
Usa @latest para descargar siempre la versión más reciente o fija una versión específica como @1.0.0 para mayor estabilidad.

Docker

Ejecuta el servidor MCP en un entorno containerizado para un despliegue consistente.
# Pull the latest image
docker pull ghcr.io/dodopayments/mcp:latest

# Run the container
docker run -e DODO_PAYMENTS_API_KEY="dodo_test_..." \
  -e DODO_PAYMENTS_WEBHOOK_KEY="your_webhook_key" \
  -e DODO_PAYMENTS_ENVIRONMENT="live_mode" \
  ghcr.io/dodopayments/mcp:latest
Las imágenes de Docker están disponibles en GitHub Container Registry.

Configuración del cliente

Configura el servidor MCP de Dodo Payments en tu cliente de IA preferido.
Configura el servidor MCP de Dodo Payments en Cursor para habilitar el acceso conversacional a tus datos de pagos.Instalación con un clicUsa el botón a continuación para instalar el servidor MCP directamente en Cursor:[Add to Cursor](https://cursor.com/en-US/install-mcp?name=dodopayments-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImRvZG9wYXltZW50cy1tY3AiXSwiZW52Ijp7IkRPRE9fUEFZTUVOVFNfQVBJX0tFWSI6IlNldCB5b3VyIERPRE9fUEFZTUVOVFNfQVBJX0tFWSBoZXJlLiIsIkRPRE9fUEFZTUVOVFNfV0VCSE9PS19LRVkiOiJTZXQgeW91ciBET0RPX1BBWU1FTlRTX1dFQkhPT0tfS0VZIGhlcmUuIn19)Después de hacer clic, configura tus variables de entorno en mcp.json de Cursor mediante Cursor Settings > Tools & MCP > New MCP Server.Configuración manual
1

Open Cursor settings

Navega a Cursor Settings > Features > Model Context Protocol o presiona Cmd/Ctrl + Shift + P y busca “MCP Settings”.
2

Edit configuration

Haz clic en Edit Config para abrir el archivo mcp_config.json.
3

Add Dodo Payments configuration

Elige una de las siguientes configuraciones:Servidor remoto (recomendado)
{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"]
    }
  }
}
NPX local
{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "dodopayments-mcp@latest"],
      "env": {
        "DODO_PAYMENTS_API_KEY": "dodo_test_...",
        "DODO_PAYMENTS_WEBHOOK_KEY": "your_webhook_key"
      }
    }
  }
}
4

Save and restart

Guarda el archivo de configuración y reinicia Cursor.
Verifica la conexión preguntándole al asistente de IA sobre tus datos de Dodo Payments.

Variables de entorno

Configura el comportamiento del servidor MCP mediante variables de entorno.
VariableDescripciónObligatoria
DODO_PAYMENTS_API_KEYTu clave de API de Dodo Payments
DODO_PAYMENTS_WEBHOOK_KEYTu clave de firma de webhooksNo
DODO_PAYMENTS_ENVIRONMENTEstablece live_mode para producciónNo

Ejecución remota

Despliega el servidor MCP como un servidor HTTP remoto para clientes web o flujos de trabajo de agentes.
# Start as remote server
npx -y dodopayments-mcp --transport=http

# Specify a custom port
npx -y dodopayments-mcp --transport=http --port=3000

Configuración del servidor remoto

Una vez desplegado, los clientes pueden conectarse usando la URL del servidor:
{
  "mcpServers": {
    "dodopayments_api": {
      "url": "http://localhost:3000",
      "headers": {
        "Authorization": "Bearer your_api_key"
      }
    }
  }
}

Encabezados de autorización

El servidor remoto acepta autenticación mediante los siguientes encabezados:
EncabezadoDescripción
AuthorizationAutenticación con token Bearer
x-dodo-payments-api-keyEncabezado directo de clave de API

Mejores prácticas de seguridad

Code Mode proporciona seguridad inherente al ejecutar el código en un entorno sandbox y al inyectar las claves de API del lado del servidor. Sigue estas mejores prácticas adicionales para proteger tus credenciales.
Nunca cometas credenciales en control de versionesAlmacena las claves de API en variables de entorno o en sistemas seguros de gestión de secretos.
# Use environment variables
export DODO_PAYMENTS_API_KEY="dodo_test_..."

# Use a .env file (add to .gitignore)
echo "DODO_PAYMENTS_API_KEY=dodo_test_..." > .env
Rota las claves regularmenteGenera nuevas claves de API periódicamente y revoca las antiguas desde tu panel de Dodo Payments.Usa claves de prueba para el desarrolloSiempre emplea claves en modo test durante el desarrollo para evitar afectar datos de producción.
Implementa autenticación para servidores remotosAl desplegar de forma remota, siempre exige autenticación mediante el encabezado Authorization o x-dodo-payments-api-key.Monitorea el uso de la APIRastrea la actividad del servidor MCP desde el panel de Dodo Payments y configura alertas para patrones inusuales.
Usa HTTPS para servidores remotosDespliega siempre los servidores MCP remotos detrás de endpoints HTTPS.Implementa limitación de velocidadProtege contra abusos implementando límites de tasa tanto en el servidor MCP como en los niveles de la API.Restringe el acceso a la redConfigura reglas de firewall para limitar qué clientes pueden conectarse a tu servidor MCP.

Resolución de problemas

Verifica tu clave de APIAsegúrate de que tu clave de API esté configurada correctamente y tenga los permisos necesarios.
# Test your API key
curl -H "Authorization: Bearer dodo_test_..." \
  https://test.dodopayments.com/payments
Revisa tu conexión de redVerifica que puedas alcanzar los endpoints de la API de Dodo Payments.Revisa los registros del clienteActiva el registro detallado en tu cliente MCP para diagnosticar problemas de conexión.
Confirma el entorno de la clave de APIAsegúrate de usar claves de prueba con endpoints de prueba y claves en vivo con endpoints de producción.Verifica la variable de entornoConfirma que DODO_PAYMENTS_ENVIRONMENT esté configurada correctamente (live_mode para producción).Regenera las credencialesSi los problemas persisten, genera una nueva clave de API desde tu panel.
Valida los parámetros de entradaAsegúrate de que el asistente de IA proporcione parámetros correctamente formateados para cada herramienta.Revisa los mensajes de errorConsulta la respuesta de error de la API para obtener orientación específica sobre lo que falló.Prueba directamente con la APIVerifica que la operación funcione al llamar directamente a la API de Dodo Payments vía curl o Postman.

Por qué Code Mode

Las implementaciones tradicionales de MCP a menudo sufren de “proliferación de herramientas”, donde cada endpoint de la API se expone como una herramienta separada. Code Mode es un enfoque superior por varias razones:

Los LLM escriben código mejor que llaman herramientas

Los LLM han sido entrenados con millones de líneas de código del mundo real, lo que los hace naturalmente competentes para escribir scripts. En contraste, la invocación de herramientas suele basarse en ejemplos sintéticos.
«Hacer que un LLM realice tareas mediante llamadas a herramientas es como poner a Shakespeare en una clase de mandarín de un mes y luego pedirle que escriba una obra en ese idioma.» — Cloudflare

Elimina la sobrecarga de la ventana de contexto

En un enfoque tradicional, cada definición de herramienta consume tokens antes de que la conversación siquiera comience. Exponer más de 50 herramientas puede consumir fácilmente de 55K a más de 100K tokens. Anthropic descubrió que las definiciones de herramientas podían consumir hasta 134K tokens antes de la optimización. Con Code Mode, solo se cargan 2 definiciones de herramienta (~1K tokens). El agente busca la documentación que necesita bajo demanda. La herramienta Tool Search de Anthropic preservó el 95 % de la ventana de contexto, reduciendo la sobrecarga de 77K a 8.7K tokens.

Reduce la latencia mediante orquestación programática

La llamada tradicional a herramientas requiere una inferencia completa del modelo por cada operación. Si una tarea requiere 20 llamadas a la API, eso son 20 viajes de ida y vuelta. En Code Mode, el agente escribe un script que ejecuta todas las llamadas y devuelve solo el resultado final. Anthropic observó una reducción del 37 % en tokens y una mejora en la precisión (la recuperación de conocimientos aumentó del 25.6 % al 28.5 %) usando este enfoque programático.

Más seguro por diseño

Code Mode ofrece beneficios de seguridad inherentes:
  • No hay claves de API en los parámetros: las claves se inyectan del lado del servidor y nunca se exponen en los parámetros que se envían al LLM.
  • Sandbox aislado: el código se ejecuta en un entorno seguro sin acceso a la red ni al sistema de archivos del host.
  • SDK controlado: solo los métodos autorizados del SDK están disponibles para el agente.

Escala a cualquier tamaño de API

A medida que una API crece, el rendimiento de MCP tradicional se degrada porque se deben cargar más herramientas en el contexto. Code Mode permanece constante con 2 herramientas sin importar el área de superficie de la API. Cloudflare logró reducir más de 2,500 endpoints de API a solo 2 herramientas y aproximadamente 1,000 tokens de contexto.
Para más detalles sobre los beneficios de esta arquitectura, consulta los blogs de ingeniería de Anthropic y Cloudflare, y la documentación de Programmatic Tool Calling de Claude.

Recursos