Descripción general
El Model Context Protocol (MCP) es un estándar abierto que permite a las aplicaciones de IA conectarse a fuentes de datos y API externas. El servidor MCP de Dodo Payments proporciona a asistentes de IA como Claude, Cursor y otros clientes compatibles con MCP acceso a tu infraestructura de pagos. El servidor MCP de Dodo Payments utiliza una arquitectura de Code Mode. En lugar de exponer cientos de herramientas individuales para cada endpoint de la API, Code Mode permite a los agentes de IA escribir y ejecutar código TypeScript contra el SDK de Dodo Payments en un sandbox aislado.Capacidades principales
- Operaciones de pago — Crea, consulta y gestiona pagos y reembolsos
- Gestión de suscripciones — Gestiona la facturación recurrente, las actualizaciones y las cancelaciones
- Administración de clientes — Gestiona los datos de clientes y el acceso al portal
- Catálogo de productos — Crea y actualiza productos, precios y descuentos
- Gestión de licencias — Activa, valida y gestiona licencias de software
- Facturación basada en el uso — Registra y factura el uso medido
Cómo Funciona el Modo de Código
El servidor MCP de Dodo Payments proporciona a tu agente de IA dos herramientas:- Herramienta de búsqueda de documentación — Consulta la documentación sobre la API y el SDK de Dodo Payments para comprender las operaciones y los parámetros disponibles.
- Herramienta de ejecución de código — Escribe código TypeScript contra el SDK y lo ejecuta en un sandbox seguro.
Configuración rápida
Conéctate al servidor MCP de Dodo Payments desde tu cliente de IA:- Agent Plugin (recommended)
- Cursor
- Claude Desktop
- Windsurf
- Claude Code
El complemento de agente de Dodo instala los dos servidores MCP y las diecisiete skills en un solo paso para Claude Code, Codex CLI, Cursor, VS Code / GitHub Copilot, Kiro y OpenCode (OpenCode necesita una configuración adicional
skills.paths). Gemini CLI solo obtiene los dos servidores MCP, ya que no tiene una primitiva de skills de agente. Consulta la guía de agentes de programación con IA para ver los comandos de instalación de cada agente.Si tu agente no está en esa lista, utiliza las pestañas a continuación para configurar el servidor MCP directamente.Requiere Node.js 18 o posterior. El servidor remoto utiliza OAuth para la autenticación. En la primera conexión, se te pedirá que introduzcas tu API key y selecciones tu entorno.
Dodo Knowledge MCP
Además del servidor MCP de Dodo Payments (para ejecutar operaciones de la API), ofrecemos Dodo Knowledge MCP, un servidor de búsqueda semántica que proporciona a los asistentes de IA acceso instantáneo a la documentación de Dodo Payments.Construido con ContextMCP.ai: Dodo Knowledge MCP está impulsado por ContextMCP, lo que permite una búsqueda semántica rápida en nuestra documentación utilizando incrustaciones vectoriales.
¿Qué es Dodo Knowledge MCP?
Dodo Knowledge MCP es un servidor MCP remoto que proporciona búsqueda semántica de documentación. Encuentra documentación relevante mediante consultas en lenguaje natural, obtén información precisa y actualizada sobre Dodo Payments y conéctate sin necesidad de API keys ni instalación local.Configuración rápida
Conéctate a Dodo Knowledge MCP desde tu cliente de IA:- Cursor
- Claude Desktop
- Windsurf
- Claude Code
Añádelo a
~/.cursor/mcp.json:Requiere Node.js 18 o posterior. El paquete
mcp-remote gestiona la conexión con el servidor MCP remoto.Uso conjunto de ambos servidores MCP
Para disfrutar de la mejor experiencia de desarrollo asistido por IA, utiliza ambos servidores MCP:Solución de problemas de Knowledge MCP
Si encuentras problemas de conexión, borra la caché de autenticación de MCP conrm -rf ~/.mcp-auth, reinicia la aplicación cliente, revisa los registros del cliente en busca de mensajes de error y verifica la versión de Node.js (requiere 18 o posterior).
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 configuración ni instalación local.1
Access the remote server
Abre 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, añádela a la configuración de MCP:
3
Authenticate and configure
El flujo de OAuth te pedirá que:
- Introduzcas tu API key de Dodo Payments
- Selecciones tu entorno (test o live)
- Elijas el tipo de cliente MCP
4
Complete setup
Haz clic en Login and Approve para autorizar la conexión.
Una vez conectado, tu asistente de IA podrá interactuar con la API de Dodo Payments en tu nombre.
Paquete NPM
Instala y ejecuta el servidor MCP localmente.- NPX (No Installation)
- MCP Client Configuration
Docker
Ejecuta el servidor MCP en un contenedor.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 siguiente para instalar directamente el servidor MCP 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 el
mcp.json de Cursor mediante Cursor Settings > Tools & MCP > New MCP Server.Configuración manual1
Open Cursor settings
Ve a Cursor Settings > Tools & MCP o pulsa
Cmd/Ctrl + Shift + P y busca “MCP Settings”.2
Edit configuration
Haz clic en New MCP Server para abrir el archivo
mcp.json.3
Add Dodo Payments configuration
Elige una de las siguientes configuraciones:Servidor remoto (recomendado)NPX local
4
Save and restart
Guarda el archivo de configuración y reinicia Cursor.
Verifica la conexión preguntando al asistente de IA sobre tus datos de Dodo Payments.
Variables de entorno
Configura el comportamiento del servidor MCP mediante variables de entorno.Ejecución remota
Implementa el servidor MCP como un servidor HTTP remoto para clientes web o flujos de trabajo agénticos.Configuración del servidor remoto
Una vez implementados, los clientes pueden conectarse mediante la URL del servidor:Encabezados de autorización
El servidor remoto acepta autenticación mediante los siguientes encabezados:Prácticas recomendadas de seguridad
Code Mode proporciona seguridad inherente al ejecutar código en un entorno aislado e inyectar las claves de API del lado del servidor. Sigue estas prácticas recomendadas para proteger tus credenciales.API Key Management
API Key Management
Nunca confirmes credenciales en el control de versiones. Almacena las claves de API en variables de entorno o sistemas seguros de gestión de secretos:Rota las claves periódicamente generando nuevas claves de API y revocando las antiguas desde tu panel de Dodo Payments. Usa siempre claves de API del modo de prueba durante el desarrollo para evitar afectar los datos de producción.
Access Control
Access Control
Al realizar implementaciones remotas, exige siempre autenticación mediante el encabezado
Authorization o el encabezado x-dodo-payments-api-key.Network Security
Network Security
Implementa siempre los servidores MCP remotos detrás de endpoints HTTPS. Protégete contra el uso indebido implementando límites de velocidad tanto en el servidor MCP como en los niveles de API. Configura reglas de firewall para limitar qué clientes pueden conectarse a tu servidor MCP.
Solución de problemas
Connection issues
Connection issues
Verifica que tu clave de API esté configurada correctamente y tenga los permisos necesarios:Comprueba que puedas acceder a los endpoints de la API de Dodo Payments. Habilita el registro detallado en tu cliente MCP para diagnosticar problemas de conexión.
Authentication errors
Authentication errors
Asegúrate de usar claves de prueba con endpoints de prueba y claves activas con endpoints de producción. Verifica que
DODO_PAYMENTS_ENVIRONMENT esté configurado correctamente (live_mode para producción). Si los problemas persisten, genera una nueva clave de API desde tu panel.Tool execution failures
Tool execution failures
Asegúrate de que el asistente de IA proporcione parámetros con el formato correcto para cada herramienta. Comprueba la respuesta de error de la API para obtener indicaciones específicas sobre lo ocurrido. Verifica que la operación funcione al llamar directamente a la API de Dodo Payments mediante curl o Postman.
Por qué Code Mode
Las implementaciones tradicionales de MCP sufren de “proliferación de herramientas”, donde cada endpoint de API se expone como una herramienta independiente. Code Mode es mejor por varios motivos:Los LLM escriben código mejor de lo que llaman herramientas
Los LLM se entrenan con millones de líneas de código del mundo real, por lo que escriben scripts de forma natural. Las llamadas a herramientas suelen basarse en ejemplos sintéticos.“Hacer que un LLM realice tareas mediante llamadas a herramientas es como enviar a Shakespeare a una clase intensiva 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 los enfoques tradicionales, cada definición de herramienta consume tokens antes de que comience la conversación. Exponer más de 50 herramientas puede consumir entre 55K y más de 100K tokens. Anthropic descubrió que las definiciones de herramientas podían consumir hasta 134K tokens antes de la optimización. Code Mode carga solo 2 definiciones de herramientas (aproximadamente 1K tokens). El agente busca la documentación según sea necesario. Tool Search Tool de Anthropic conservó el 95 % de la ventana de contexto, reduciendo la sobrecarga de 77K a 8,7K tokens.Reduce la latencia mediante la orquestación programática
Las llamadas a herramientas tradicionales requieren un ciclo completo de inferencia del modelo para cada operación. Si una tarea requiere 20 llamadas a la API, son 20 ciclos de ida y vuelta. En Code Mode, el agente escribe un script que ejecuta todas las llamadas y devuelve únicamente el resultado final. Anthropic observó una reducción del 37 % en tokens y una mejora de la precisión (la recuperación de conocimiento mejoró del 25,6 % al 28,5 %) mediante este enfoque.Más seguro por diseño
Code Mode proporciona beneficios de seguridad inherentes:- Sin claves de API en los parámetros: las claves de API se inyectan del lado del servidor y nunca se exponen en los parámetros de las herramientas enviados 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: el agente solo tiene disponibles métodos del SDK autorizados.
Se adapta a cualquier tamaño de API
A medida que una API crece, el rendimiento del MCP tradicional se degrada porque deben cargarse más herramientas. Code Mode se mantiene constante con 2 herramientas, independientemente del tamaño de la superficie de la API. Cloudflare redujo más de 2500 endpoints de API a 2 herramientas y aproximadamente 1000 tokens de contexto.Para obtener más información, consulta los blogs de ingeniería de Anthropic y Cloudflare, así como la documentación de Programmatic Tool Calling de Claude.
Recursos
API Reference
Explora la documentación completa de la API de Dodo Payments
MCP Protocol
Obtén más información sobre el estándar Model Context Protocol
GitHub Repository
Consulta el código fuente del servidor MCP y contribuye
NPM Package
Instala el servidor MCP desde NPM