Skip to main content

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:
  1. 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.
  2. Herramienta de ejecución de código — Escribe código TypeScript contra el SDK y lo ejecuta en un sandbox seguro.
Esta arquitectura permite a los agentes realizar operaciones complejas de varios pasos en una sola invocación. Por ejemplo, un agente puede enumerar todas las suscripciones activas, filtrarlas según determinados criterios y aplicar un descuento a cada una, todo en un único script.
Los agentes pueden encadenar varias llamadas a la API, gestionar lógica condicional y realizar cálculos sin tener que volver al LLM.

Configuración rápida

Conéctate al servidor MCP de Dodo Payments desde tu cliente de IA:
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:
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:
Con ambos servidores configurados, tu agente puede buscar documentación para comprender una función y, después, ejecutar las llamadas a la API para implementarla, todo en una sola conversación.

Solución de problemas de Knowledge MCP

Si encuentras problemas de conexión, borra la caché de autenticación de MCP con rm -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
Mantén tu API key segura. Utiliza API keys de 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 podrá interactuar con la API de Dodo Payments en tu nombre.

Paquete NPM

Instala y ejecuta el servidor MCP localmente.
El servidor local ejecuta tu código en un sandbox de Deno. Instala Deno 2.8 o anterior y asegúrate de que deno esté en tu PATH; el sandbox no se inicia con Deno 2.9 o posterior. La ejecución de código local solo funciona en macOS y Linux. En Windows, utiliza el servidor remoto o ejecuta el servidor local mediante WSL2.
Utiliza @latest para obtener siempre la versión más reciente, o fija una versión específica como @2.51.0 para mayor estabilidad.

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.
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:[Añadir a 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 manual
1

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.
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.
Al realizar implementaciones remotas, exige siempre autenticación mediante el encabezado Authorization o el encabezado x-dodo-payments-api-key.
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

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.
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.
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
Última modificación el 28 de septiembre de 2026