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:- Docs Search Tool: Consulta la documentación sobre la API y el SDK de Dodo Payments para comprender las operaciones y parámetros disponibles.
- Code Execution Tool: Escribe código TypeScript contra el SDK que se ejecuta en un entorno sandbox seguro.
Configuración rápida
Conéctate al servidor MCP de Dodo Payments desde tu cliente de IA:- Cursor
- Claude Desktop
- Windsurf
- Claude Code
Agrega a
~/.cursor/mcp.json: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:- Cursor
- Claude Desktop
- Windsurf
- Claude Code
Agrega a
~/.cursor/mcp.json: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:| Servidor | Propósito | Caso de uso |
|---|---|---|
| Dodo Knowledge MCP | Búsqueda de documentación | «¿Cómo gestiono los webhooks?», «¿Qué métodos de pago son compatibles?» |
| Dodo Payments MCP | Operaciones de API | Crear pagos, gestionar suscripciones, procesar reembolsos |
Solución de problemas de Knowledge MCP
Si encuentras problemas de conexión:- Borra la caché de autenticación de MCP:
rm -rf ~/.mcp-auth - Reinicia tu aplicación cliente
- Consulta los registros del cliente en busca de mensajes de error
- 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.Access the remote server
Navega a https://mcp.dodopayments.com en tu navegador.
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:
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
Paquete NPM
Instala y ejecuta el servidor MCP localmente usando NPM.- NPX (No Installation)
- MCP Client Configuration
Docker
Ejecuta el servidor MCP en un entorno containerizado para un despliegue consistente.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.- Cursor
- Claude Desktop
- Claude Code
- VS Code
- Cline (VS Code)
- Zed
- Other Clients
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:[
](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 manualOpen Cursor settings
Navega a Cursor Settings > Features > Model Context Protocol o presiona
Cmd/Ctrl + Shift + P y busca “MCP Settings”.Add Dodo Payments configuration
Elige una de las siguientes configuraciones:Servidor remoto (recomendado)NPX local
Variables de entorno
Configura el comportamiento del servidor MCP mediante variables de entorno.| Variable | Descripción | Obligatoria |
|---|---|---|
DODO_PAYMENTS_API_KEY | Tu clave de API de Dodo Payments | Sí |
DODO_PAYMENTS_WEBHOOK_KEY | Tu clave de firma de webhooks | No |
DODO_PAYMENTS_ENVIRONMENT | Establece live_mode para producción | No |
Ejecución remota
Despliega el servidor MCP como un servidor HTTP remoto para clientes web o flujos de trabajo de agentes.Configuración del servidor remoto
Una vez desplegado, los clientes pueden conectarse usando la URL del servidor:Encabezados de autorización
El servidor remoto acepta autenticación mediante los siguientes encabezados:| Encabezado | Descripción |
|---|---|
Authorization | Autenticación con token Bearer |
x-dodo-payments-api-key | Encabezado 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.API Key Management
API Key Management
Nunca cometas credenciales en control de versionesAlmacena las claves de API en variables de entorno o en sistemas seguros de gestión de secretos.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.
Access Control
Access Control
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.Network Security
Network Security
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
Connection issues
Connection issues
Verifica tu clave de APIAsegúrate de que tu clave de API esté configurada correctamente y tenga los permisos necesarios.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.
Authentication errors
Authentication errors
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.Tool execution failures
Tool execution failures
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.