Mcp Server Per Fatturazione Paddle
Interagisci con l'API di Paddle utilizzando assistenti AI come Claude, o in IDE potenziati da AI come Cursor. Gestisci il catalogo prodotti, la fatturazione e gli abbonamenti, e i report.
Panoramica
Cos'è il Paddle MCP Server?
Il Paddle MCP Server è uno strumento potente progettato per facilitare le interazioni con l'API di Paddle. Permette agli sviluppatori di gestire vari aspetti dei loro account Paddle, inclusi cataloghi di prodotti, fatturazione, abbonamenti e reportistica. Questo server funge da ponte tra le tue applicazioni e i servizi di Paddle, consentendo un'integrazione fluida e l'automazione delle attività.
Caratteristiche del Paddle MCP Server
- Integrazione API: Collega facilmente l'API di Paddle per eseguire operazioni come la creazione di prodotti, la gestione degli abbonamenti e la gestione dei pagamenti.
- Compatibilità con Assistenti AI: Interagisci con Paddle utilizzando assistenti AI come Claude o tramite IDE potenziati da AI come Cursor, migliorando produttività ed efficienza.
- Gestione Completa: Gestisci l'intero catalogo di prodotti, i processi di fatturazione e i modelli di abbonamento da un'unica interfaccia.
- Strumenti di Reportistica: Genera report dettagliati per analizzare vendite, comportamento dei clienti e altre metriche chiave per prendere decisioni aziendali informate.
- Open Source: Il Paddle MCP Server è disponibile pubblicamente, consentendo agli sviluppatori di contribuire al suo sviluppo e personalizzarlo per soddisfare le proprie esigenze specifiche.
Come Usare il Paddle MCP Server
- Installazione: Inizia clonando il repository da GitHub. Usa il comando:
git clone https://github.com/PaddleHQ/paddle-mcp-server.git
- Configurazione: Imposta le tue chiavi API di Paddle e configura le impostazioni del server secondo le tue esigenze.
- Esecuzione del Server: Avvia il server utilizzando il comando appropriato per il tuo ambiente. Assicurati che tutte le dipendenze siano installate.
- Chiamate API: Utilizza gli endpoint API forniti per interagire con Paddle. Puoi creare, leggere, aggiornare ed eliminare risorse secondo necessità.
- Monitoraggio e Reportistica: Usa gli strumenti di reportistica integrati per monitorare le tue vendite e abbonamenti, apportando modifiche se necessario.
Domande Frequenti
D: Quali linguaggi di programmazione supporta il Paddle MCP Server?
R: Il Paddle MCP Server è progettato per essere indipendente dal linguaggio, consentendo l'integrazione con qualsiasi linguaggio di programmazione in grado di effettuare richieste HTTP.
D: Il Paddle MCP Server è gratuito da usare?
R: Sì, il Paddle MCP Server è open-source e gratuito da usare. Puoi modificarlo e distribuirlo secondo i termini della licenza Apache-2.0.
D: Posso contribuire al Paddle MCP Server?
R: Assolutamente! I contributi sono benvenuti. Puoi inviare problemi, richieste di funzionalità o pull request sul repository di GitHub.
D: Come posso segnalare un bug?
R: Se riscontri problemi, ti preghiamo di segnalarli sulla pagina delle issue del repository del Paddle MCP Server su GitHub.
D: Dove posso trovare ulteriore documentazione?
R: Ulteriore documentazione e risorse possono essere trovate sul Paddle Developer Portal.
Dettaglio
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
Configurazione Server
{
"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": {}
}
}
}