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 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:
  1. 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
  2. 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
Esta arquitectura permite a los agentes de IA realizar operaciones de pago complejas y de múltiples pasos de manera determinista y repetible.
Usando el Modo de Código, los agentes pueden encadenar múltiples llamadas a la API, manejar lógica condicional y realizar cálculos, todo en una sola invocación de herramienta.

Dodo Knowledge MCP

Además del Servidor MCP de Dodo Payments (para ejecutar operaciones de API), proporcionamos 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 la base de conocimientos de Dodo Payments.
Construido con ContextMCP.ai: Dodo Knowledge MCP está impulsado por ContextMCP, lo que permite una búsqueda semántica rápida a través de 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 utilizando consultas en lenguaje natural
  • Respuestas Contextuales: Los asistentes de IA obtienen información precisa y actualizada sobre Dodo Payments
  • Sin Configuración: No se requieren claves de API ni instalación local: solo conéctate y comienza a consultar

Configuración Rápida

Conéctate a Dodo Knowledge MCP en tu cliente de IA:
Agregar 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 maneja la conexión al servidor MCP remoto.

Usando 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 manejo los webhooks?”, “¿Qué métodos de pago están soportados?”
Dodo Payments MCPOperaciones de APICrear pagos, gestionar suscripciones, manejar 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 entender cómo implementar una función, y luego ejecutar las llamadas a la API reales, todo en una sola conversación.

Solución de Problemas de Knowledge MCP

Si encuentras problemas de conexión:
  1. Limpiar caché de autenticación de MCP: rm -rf ~/.mcp-auth
  2. Reiniciar tu aplicación cliente
  3. Verificar registros del cliente para mensajes de error
  4. Verificar 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

Accede al servidor remoto

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

Configura tu cliente MCP

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

Autenticar y configurar

El flujo de OAuth te pedirá:
  • Ingresar tu clave API de Dodo Payments
  • Seleccionar tu entorno (prueba o producción)
  • Elegir tu tipo de cliente MCP
Mantén tu clave API segura. Usa claves de modo de prueba durante el desarrollo.
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.
# 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 siempre obtener la versión más reciente, o fija a una versión específica como @1.0.0 para estabilidad.

Docker

Ejecuta el servidor MCP en un entorno contenedorizado 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 Dodo Payments MCP en tu cliente de IA preferido.
Configura el servidor Dodo Payments MCP 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:[Agregar a Cursor](https://cursor.com/en-US/install-mcp?name=dodopayments-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImRvZG9wYXltZW50cy1tY3AiXSwiZW52Ijp7IkRPRE9fUEFZTUVOVFNfQVBJX0tFWSI6IlNldCB5b3VyIERPRE9fUEFZTUVOVFNfQVBJX0tFWSBoZXJlLiIsIkRPRE9fUEFZTUVOVFNfV0VCSE9PS19LRVkiOiJTZXQgeW91ciBET0RPX1BBWU1FTlRTX1dFQkhPT0tfS0VZIGhlcmUuIn19)Después de hacer clic, establece tus variables de entorno en el mcp.json de Cursor a través de Configuraciones de Cursor > Herramientas y MCP > Nuevo servidor MCP.Configuración Manual
1

Abrir configuraciones de Cursor

Navega a Configuraciones de Cursor > Características > Protocolo de Contexto de 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

Agrega la configuración de Dodo Payments

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

Guarda y reinicia

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 utilizando variables de entorno.
VariableDescripciónRequerido
DODO_PAYMENTS_API_KEYTu clave API de Dodo Payments
DODO_PAYMENTS_WEBHOOK_KEYTu clave de firma de webhookNo
DODO_PAYMENTS_ENVIRONMENTEstablecer en live_mode para producciónNo

Ejecución Remota

Despliega el servidor MCP como un servidor HTTP remoto para clientes basados en web o flujos de trabajo agenticos.
# 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 a través de los siguientes encabezados:
EncabezadoDescripción
AuthorizationAutenticación de token Bearer
x-dodo-payments-api-keyEncabezado de clave API directa

Capacidades del Cliente

Diferentes clientes MCP tienen diferentes niveles de soporte para la especificación MCP. El servidor puede ajustar automáticamente los esquemas de herramientas para sortear estas limitaciones.
# Auto-detect client (default)
npx dodopayments-mcp --client=infer

# Configure for specific clients
npx dodopayments-mcp --client=cursor
npx dodopayments-mcp --client=claude
npx dodopayments-mcp --client=claude-code
npx dodopayments-mcp --client=openai-agents

Preajustes de Cliente Disponibles

ClienteDescripción
inferDetección automática de cliente (predeterminado)
cursorEditor de Cursor
claudeClaude AI web o de escritorio
claude-codeClaude Code CLI
openai-agentsPlataforma de agentes de OpenAI

Configuración Manual de Capacidades

Para clientes no listados arriba, configura manualmente las capacidades:
# Disable $ref pointer support and set max tool name length
npx dodopayments-mcp --no-capability=refs --capability=tool-name-length=40
Capacidades disponibles:
  • top-level-unions - Soporte para tipos de unión de nivel superior
  • valid-json - Análisis correcto de argumentos de cadena JSON
  • refs - Soporte para punteros $ref en esquemas
  • unions - Soporte para tipos de unión (anyOf)
  • formats - Soporte para validaciones de formato
  • tool-name-length=N - Longitud máxima del nombre de la herramienta
Ejecuta npx dodopayments-mcp --describe-capabilities para obtener información detallada sobre las capacidades.

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.
# Only expose read operations (GET requests)
npx dodopayments-mcp --operation=read

# Only expose write operations (POST, PUT, DELETE)
npx dodopayments-mcp --operation=write
Usa --operation=read durante el desarrollo para evitar modificaciones accidentales a tus datos.

Filtrar por recurso

Limita las herramientas a recursos específicos de la API.
# Only expose payment-related tools
npx dodopayments-mcp --resource=payments

# Expose multiple resources
npx dodopayments-mcp --resource=payments --resource=customers

# Use wildcards for resource groups
npx dodopayments-mcp --resource=subscription*

Incluir o excluir herramientas específicas

Ajusta qué herramientas individuales están disponibles.
# Include only specific tools
npx dodopayments-mcp --tool=create_payments --tool=list_payments

# Exclude specific tools
npx dodopayments-mcp --no-tool=delete_products

# Disable the docs search tool
npx dodopayments-mcp --no-tools=docs

# List all available tools
npx dodopayments-mcp --list

Combinar filtros

Aplica múltiples filtros simultáneamente para un control preciso.
# Only payment and subscription read operations
npx dodopayments-mcp --operation=read --resource=payments --resource=subscriptions

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:
https://mcp.dodopayments.com/?operation=read
https://mcp.dodopayments.com/?resource=payments

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.
npx dodopayments-mcp --tools=dynamic
En modo dinámico, tres meta-herramientas reemplazan herramientas individuales de API:
  1. list_api_endpoints - Descubre métodos disponibles con filtrado opcional
  2. get_api_endpoint_schema - Obtiene el esquema detallado para un método específico
  3. invoke_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. Sobrescribe con --tools=all para incluir todas las herramientas.
# Use both dynamic tools and specific resources
npx dodopayments-mcp --tools=dynamic --resource=payments

Uso Avanzado

Integración programática

Construye servidores MCP personalizados o extiende el existente programáticamente.
import { server, endpoints, init } from "dodopayments-mcp/server";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

// Initialize with all default endpoints
init({ server, endpoints });

// Start the server
const transport = new StdioServerTransport();
await server.connect(transport);

Desarrollo de herramientas personalizadas

Extiende el servidor MCP con tus propias herramientas y lógica de negocio.
import { server, init } from "dodopayments-mcp/server";
import createPayments from "dodopayments-mcp/tools/payments/create-payments";
import { zodToJsonSchema } from "zod-to-json-schema";
import { z } from "zod";

// Define a custom tool
const customTool = {
  tool: {
    name: 'calculate_payment_total',
    description: 'Calculate payment total with tax and fees',
    inputSchema: zodToJsonSchema(
      z.object({
        amount: z.number().describe('Base amount in cents'),
        tax_rate: z.number().describe('Tax rate as decimal'),
      })
    ),
  },
  handler: async (client, args) => {
    const total = args.amount * (1 + args.tax_rate);
    return {
      content: [{
        type: 'text',
        text: JSON.stringify({ total, currency: 'usd' }),
      }],
    };
  },
};

// Initialize with custom tools
init({ 
  server, 
  endpoints: [createPayments, customTool] 
});

Mejores Prácticas de Seguridad

Protege tus credenciales de API y mantén integraciones seguras.
Nunca cometas credenciales en el control de versionesAlmacena claves API en variables de entorno o sistemas de gestión de secretos seguros.
# 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 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 de API en modo de prueba durante el desarrollo para evitar afectar los datos de producción.
Aplica filtrado de herramientas en producciónLimita las operaciones expuestas solo a lo que tu asistente de IA necesita.
# Production: read-only access
npx dodopayments-mcp --operation=read

# Development: full access
npx dodopayments-mcp
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.
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 en el servidor MCP como en la API.Restringe el acceso a la redConfigura reglas de firewall para limitar qué clientes pueden conectarse a tu servidor MCP.

Solución de Problemas

Verifica tu clave APIAsegúrate de que tu clave API esté configurada correctamente y tenga los permisos necesarios.
# Test your API key
curl -H "Authorization: Bearer dodo_test_..." \
  https://test.dodopayments.com/payments
Verifica tu conexión de redVerifica que puedes 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.
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é configurado correctamente (live_mode para producción).Regenera credencialesSi los problemas persisten, genera una nueva clave API a través de tu panel.
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.
Prueba un preajuste de cliente diferenteSi las herramientas no están funcionando correctamente, intenta especificar tu cliente explícitamente:
npx dodopayments-mcp --client=cursor
Verifica el soporte de capacidadesAlgunos clientes no admiten todas las características del esquema JSON. Usa --describe-capabilities para entender lo que se admite.

Recursos