Servidor Mcp Para Facturación Paddle
Interactúa con la API de Paddle utilizando asistentes de IA como Claude, o en IDEs potenciados por IA como Cursor. Gestiona el catálogo de productos, la facturación y suscripciones, y los informes.
Resumen
¿Qué es Paddle MCP Server?
Paddle MCP Server es una herramienta poderosa diseñada para facilitar las interacciones con la API de Paddle. Permite a los desarrolladores gestionar varios aspectos de sus cuentas de Paddle, incluyendo catálogos de productos, facturación, suscripciones e informes. Este servidor actúa como un puente entre tus aplicaciones y los servicios de Paddle, permitiendo una integración fluida y la automatización de tareas.
Características de Paddle MCP Server
- Integración de API: Conéctate fácilmente con la API de Paddle para realizar operaciones como crear productos, gestionar suscripciones y manejar pagos.
- Compatibilidad con Asistentes de IA: Interactúa con Paddle utilizando asistentes de IA como Claude o a través de IDEs impulsados por IA como Cursor, mejorando la productividad y eficiencia.
- Gestión Integral: Gestiona todo tu catálogo de productos, procesos de facturación y modelos de suscripción desde una única interfaz.
- Herramientas de Informes: Genera informes detallados para analizar ventas, comportamiento del cliente y otros métricas clave para tomar decisiones comerciales informadas.
- Código Abierto: Paddle MCP Server está disponible públicamente, lo que permite a los desarrolladores contribuir a su desarrollo y personalizarlo para satisfacer sus necesidades específicas.
Cómo Usar Paddle MCP Server
- Instalación: Comienza clonando el repositorio desde GitHub. Usa el comando:
git clone https://github.com/PaddleHQ/paddle-mcp-server.git
- Configuración: Configura tus claves de API de Paddle y ajusta la configuración del servidor de acuerdo a tus requisitos.
- Ejecución del Servidor: Inicia el servidor utilizando el comando apropiado para tu entorno. Asegúrate de que todas las dependencias estén instaladas.
- Llamadas a la API: Utiliza los endpoints de API proporcionados para interactuar con Paddle. Puedes crear, leer, actualizar y eliminar recursos según sea necesario.
- Monitoreo e Informes: Usa las herramientas de informes integradas para monitorear tus ventas y suscripciones, haciendo ajustes según sea necesario.
Preguntas Frecuentes
P: ¿Qué lenguajes de programación soporta Paddle MCP Server?
R: Paddle MCP Server está diseñado para ser independiente del lenguaje, permitiendo la integración con cualquier lenguaje de programación que pueda realizar solicitudes HTTP.
P: ¿Es Paddle MCP Server gratuito para usar?
R: Sí, Paddle MCP Server es de código abierto y gratuito para usar. Puedes modificarlo y distribuirlo bajo los términos de la licencia Apache-2.0.
P: ¿Puedo contribuir a Paddle MCP Server?
R: ¡Absolutamente! Las contribuciones son bienvenidas. Puedes enviar problemas, solicitudes de características o solicitudes de extracción en el repositorio de GitHub.
P: ¿Cómo reporto un error?
R: Si encuentras algún problema, por favor repórtalo en la página de problemas del repositorio de Paddle MCP Server en GitHub.
P: ¿Dónde puedo encontrar más documentación?
R: Documentación adicional y recursos se pueden encontrar en el Portal de Desarrolladores de Paddle.
Detalle
MCP Server for Paddle Billing
Paddle Billing is the developer-first merchant of record. We take care of payments, tax, subscriptions, and metrics with one unified API that does it all.
This is a Model Context Protocol (MCP) server that provides tools for interacting with the Paddle API.
Important: This MCP server works with Paddle Billing. It does not support Paddle Classic. To work with Paddle Classic, see: Paddle Classic API reference
Features
- List products in your Paddle catalog
- Create new products
- List prices for products
- Create new prices for products
- List customers
- List transactions
- List subscriptions
- Create custom reports for financial analysis
Installation
To use the MCP server, you'll need an API key. You can create and manage API keys in Paddle > Developer tools > Authentication:
- Sandbox: https://sandbox-vendors.paddle.com/authentication-v2
- Live: https://vendors.paddle.com/authentication-v2
To run the server in a client like Claude Desktop, Cursor or Windsurf, add the following to your MCP config:
{
"mcpServers": {
"paddle": {
"command": "npx",
"args": ["-y", "@paddle/paddle-mcp", "--api-key=PADDLE_API_KEY", "--environment=(sandbox|production)"]
}
}
}
Replace PADDLE_API_KEY
with your API key, and pass the correct value as environment
.
For detailed setup guides, see:
Development
-
Install dependencies:
pnpm install
-
Build the server:
pnpm build
-
Update client to use the local build:
{ "mcpServers": { "paddle": { "command": "node", "args": ["path/to/paddle-mcp-server/build/index.js"], "env": { "PADDLE_API_KEY": "your_api_key", "PADDLE_ENVIRONMENT": "sandbox" } } } }
Debugging
To debug the MCP server, you can use the MCP Inspector tool:
-
Run the server with the inspector:
pnpm inspector
-
Open the provided URL in your browser to view and debug the MCP requests and responses.
-
Include the
--api-key
and--environment
arguments.
Learn more
Configuración del Servidor
{
"mcpServers": {
"paddle-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/metorial/mcp-container--paddlehq--paddle-mcp-server--paddle-mcp-server",
"node ./build/index.js --api-key paddle-api-key --environment paddle-environment"
],
"env": {}
}
}
}