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 está construido con Stainless y utiliza la arquitectura de Modo de Código, que permite a los agentes de IA escribir y ejecutar código TypeScript contra el SDK de Dodo Payments en un entorno de sandbox aislado.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 utiliza el Modo de Código, proporcionando a tu agente de IA dos herramientas poderosas:- Herramienta de Búsqueda de Documentos: Consultar la documentación sobre la API y el SDK de Dodo Payments para entender las operaciones y parámetros disponibles
- Herramienta de Ejecución de Código: Escribir código TypeScript contra el SDK que se ejecuta en un entorno de sandbox seguro sin acceso a la web o al sistema de archivos
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
Acceder al servidor remoto
Navega a https://mcp.dodopayments.com en tu navegador.
2
Configurar tu cliente MCP
Copia la configuración JSON proporcionada para tu cliente específico. Para Cursor o Claude Desktop, añade esto a tu configuración de MCP:
3
Autenticar y configurar
El flujo de OAuth te pedirá:
- Introducir tu clave API de Dodo Payments
- Seleccionar tu entorno (prueba o producción)
- Elegir tu tipo de cliente MCP
4
Completar configuración
Haz clic en Iniciar sesión y Aprobar 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.- NPX (Sin Instalación)
- Configuración del Cliente MCP
Docker
Ejecuta el servidor MCP en un entorno contenedorizado 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
- Otros Clientes
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 de abajo 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, establece tus variables de entorno en
mcp.json a través de Configuraciones de Cursor > Herramientas y MCP > Nuevo Servidor MCP.Configuración Manual1
Abrir configuraciones de Cursor
Navega a Configuraciones de Cursor > Características > Protocolo de Contexto del Modelo o presiona
Cmd/Ctrl + Shift + P y busca “Configuraciones de MCP”.2
Editar configuración
Haz clic en Editar Config para abrir el archivo
mcp_config.json.3
Agregar configuración de Dodo Payments
Elige una de las siguientes configuraciones:Servidor Remoto (Recomendado)Local NPX
4
Guardar y reiniciar
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 usando variables de entorno.| Variable | Descripción | Requerido |
|---|---|---|
DODO_PAYMENTS_API_KEY | Tu clave API de Dodo Payments | Sí |
DODO_PAYMENTS_WEBHOOK_KEY | Tu clave de firma de webhook | No |
DODO_PAYMENTS_ENVIRONMENT | Establecer en live_mode para producción | No |
Ejecución Remota
Despliega el servidor MCP como un servidor HTTP remoto para clientes basados en web o flujos de trabajo agenticos.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 a través de los siguientes encabezados:| Encabezado | Descripción |
|---|---|
Authorization | Autenticación de token Bearer |
x-dodo-payments-api-key | Encabezado de clave API directa |
Capacidades del Cliente
Diferentes clientes MCP tienen niveles variados de soporte para la especificación MCP. El servidor puede ajustar automáticamente los esquemas de herramientas para sortear estas limitaciones.Preajustes de Cliente Disponibles
| Cliente | Descripción |
|---|---|
infer | Detección automática del cliente (predeterminado) |
cursor | Editor Cursor |
claude | Claude AI web o desktop |
claude-code | Claude Code CLI |
openai-agents | Plataforma de agentes de OpenAI |
Configuración Manual de Capacidades
Para clientes no listados arriba, configura manualmente las capacidades:top-level-unions- Soporte para tipos de unión de nivel superiorvalid-json- Análisis correcto de argumentos de cadena JSONrefs- Soporte para punteros $ref en esquemasunions- Soporte para tipos de unión (anyOf)formats- Soporte para validaciones de formatotool-name-length=N- Longitud máxima del nombre de la herramienta
Filtrado de Herramientas
Controla qué operaciones de API se exponen a tu asistente de IA para optimizar el rendimiento y mantener la seguridad.Filtrar por tipo de operación
Restringe el acceso a operaciones de solo lectura o de escritura.Filtrar por recurso
Limita las herramientas a recursos específicos de la API.Incluir o excluir herramientas específicas
Ajusta qué herramientas individuales están disponibles.Combinar filtros
Aplica múltiples filtros simultáneamente para un control preciso.Filtrado de Parámetros de Consulta de URL (Servidor Remoto)
Al usar el servidor remoto, aplica filtros a través de parámetros de consulta de URL:Modo de Herramientas Dinámicas
Para APIs grandes, cargar todas las herramientas a la vez puede abrumar la ventana de contexto de la IA. El modo de herramientas dinámicas proporciona una alternativa más eficiente.list_api_endpoints- Descubre métodos disponibles con filtrado opcionalget_api_endpoint_schema- Obtiene el esquema detallado para un método específicoinvoke_api_endpoint- Ejecuta cualquier método con los parámetros apropiados
Las herramientas dinámicas se habilitan automáticamente para APIs con más de 50 métodos. Anula esto con
--tools=all para incluir todas las herramientas.Uso Avanzado
Integración programática
Construye servidores MCP personalizados o extiende el existente programáticamente.Desarrollo de herramientas personalizadas
Extiende el servidor MCP con tus propias herramientas y lógica de negocio.Mejores Prácticas de Seguridad
Protege tus credenciales de API y mantén integraciones seguras.Gestión de Claves API
Gestión de Claves API
Nunca comprometas credenciales en el control de versionesAlmacena claves API en variables de entorno o sistemas de gestión de secretos seguros.Rota las claves regularmenteGenera nuevas claves API periódicamente y revoca las antiguas a través de tu panel de Dodo Payments.Usa claves de prueba para el desarrolloSiempre usa claves API de modo de prueba durante el desarrollo para evitar afectar los datos de producción.
Control de Acceso
Control de Acceso
Aplica filtrado de herramientas en producciónLimita las operaciones expuestas solo a lo que tu asistente de IA necesita.Implementa autenticación para servidores remotosAl desplegar de forma remota, siempre requiere autenticación a través del encabezado
Authorization o del encabezado x-dodo-payments-api-key.Monitorea el uso de la APIRastrea la actividad del servidor MCP a través de tu panel de Dodo Payments y configura alertas para patrones inusuales.Seguridad de Red
Seguridad de Red
Usa HTTPS para servidores remotosSiempre despliega servidores MCP remotos detrás de puntos finales HTTPS.Implementa limitación de tasaProtege contra abusos implementando límites de tasa tanto a nivel de servidor MCP como de API.Restringe el acceso a la redConfigura reglas de firewall para limitar qué clientes pueden conectarse a tu servidor MCP.
Solución de Problemas
Problemas de conexión
Problemas de conexión
Verifica tu clave APIAsegúrate de que tu clave API esté configurada correctamente y tenga los permisos necesarios.Verifica tu conexión de redVerifica que puedas alcanzar los puntos finales de la API de Dodo Payments.Revisa los registros del clienteHabilita el registro detallado en tu cliente MCP para diagnosticar problemas de conexión.
Errores de autenticación
Errores de autenticación
Confirma el entorno de la clave APIAsegúrate de que estás usando claves de prueba con puntos finales de prueba y claves en vivo con puntos finales de producción.Verifica la variable de entornoVerifica que
DODO_PAYMENTS_ENVIRONMENT esté configurada correctamente (live_mode para producción).Regenera credencialesSi los problemas persisten, genera una nueva clave API a través de tu panel.Fallos en la ejecución de herramientas
Fallos en la ejecución de herramientas
Valida los parámetros de entradaAsegúrate de que el asistente de IA esté proporcionando parámetros correctamente formateados para cada herramienta.Revisa los mensajes de errorVerifica la respuesta de error de la API para obtener orientación específica sobre lo que salió mal.Prueba con la API directamenteVerifica que la operación funcione al llamar a la API de Dodo Payments directamente a través de curl o Postman.
Problemas de compatibilidad del cliente
Problemas de compatibilidad del cliente
Prueba un preajuste de cliente diferenteSi las herramientas no están funcionando correctamente, intenta especificar tu cliente explícitamente:Verifica el soporte de capacidadesAlgunos clientes no admiten todas las características del esquema JSON. Usa
--describe-capabilities para entender qué se admite.