Salta l'installazione. Attivo in meno di 2 minuti.
Avvia una prova gratuita su cloud.anythingmcp.com, aggiungi Paddle Billing con un clic, poi punta il tuo client AI (Claude, ChatGPT, Copilot o Cursor) all'endpoint MCP generato. Niente Docker, niente git clone, nessuna esperienza di sviluppo richiesta.
In breve
Paddle Billing, il merchant of record per la vendita di software: prodotti, prezzi e sconti, clienti con indirizzi e aziende, abbonamenti con anteprima, pausa e ripresa, transazioni e fatture PDF, rimborsi e crediti, report CSV, metriche di ricavi e MRR, eventi e notifiche webhook. Live o sandbox; disdetta e addebiti una tantum sono disattivati all'installazione.
Prova a chiedere
Prompt di esempio per Paddle Billing
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Paddle Billing, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente
git clone, niente server locale.
Paddle Billing + ChatGPT
Paddle Billing, il merchant of record per la vendita di software: prodotti, prezzi e sconti, clienti con indirizzi e aziende, abbonamenti con anteprima, pausa e ripresa, transazioni e fatture PDF, rimborsi e crediti, report CSV, metriche di ricavi e MRR, eventi e notifiche webhook. Live o sandbox; disdetta e addebiti una tantum sono disattivati all'installazione.
Prerequisiti
Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:
PADDLE_API_KEY, PADDLE_API_URL
Step 1 — Ottieni le credenziali
La configurazione richiede circa 2 minuti. Ti servono un account Paddle Billing, live o sandbox, e il permesso di creare chiavi API.
- In Paddle apri Developer tools, Authentication, API keys e crea una chiave.
- Assegna alla chiave i permessi che servono ai tool: lettura per prodotti, prezzi, sconti, clienti, indirizzi, aziende, abbonamenti, transazioni, adjustment, report, notifiche ed eventi, e scrittura solo per le entità che l'AI deve modificare. Una chiamata su un'entità senza permesso risponde 403.
- Incolla la chiave in
PADDLE_API_KEY, senza virgolette né prefissoBearer. Le chiavi live iniziano conpdl_live_apikey_, quelle sandbox conpdl_sdbx_apikey_. - Imposta
PADDLE_API_URLsuhttps://api.paddle.comper l'account live o suhttps://sandbox-api.paddle.comper un account sandbox, senza barra finale. Una chiave funziona solo sull'host del proprio ambiente. - Installa il connettore ed esegui
paddle_list_event_types: non richiede ID e conferma la chiave.
Il connettore invia la chiave come bearer token e fissa la versione 1 dell'API con l'header Paddle-Version. Copre solo Paddle Billing, non Paddle Classic.
Cosa legge: il catalogo, cioè prodotti con i loro prezzi, prezzi con ciclo di fatturazione, periodo di prova, override per paese e limiti di quantità, e sconti con codice, tipo, limite d'uso, utilizzi ed eventuale scadenza; clienti (ricerca per e-mail o testo) con indirizzi, aziende (ragione sociale, numero di registro, partita IVA, contatti per la fattura) e saldi di credito per valuta; abbonamenti con stato, voci, periodo di fatturazione, prossima data di addebito ed eventuale pausa, disdetta o ripresa programmata, a richiesta con l'anteprima del prossimo addebito; transazioni (checkout, rinnovi, fatture) con totali, dettaglio delle imposte, pagamenti con codici di errore e numero di fattura, filtrate per cliente, abbonamento, stato, numero di fattura o data di fatturazione o creazione; adjustment (rimborsi, crediti, chargeback) con il loro stato di approvazione; i report richiesti in precedenza; ricavi netti, MRR e abbonati attivi per giorno come nella dashboard di Paddle; gli eventi degli ultimi 90 giorni; le destinazioni delle notifiche, le notifiche webhook ed e-mail inviate e ogni tentativo di consegna con lo stato HTTP e la risposta del tuo endpoint.
Cosa scrive: crea e aggiorna prodotti, prezzi, sconti, clienti, indirizzi e aziende (si archiviano con status: archived; in Paddle non si cancella nulla); aggiorna gli abbonamenti (cambio di piano o di quantità con un proration_billing_mode, sconto, data di fatturazione, indirizzo, modalità di incasso), li mette in pausa, li riprende e attiva un abbonamento in prova, che incassa subito il primo pagamento; crea e aggiorna transazioni, come checkout che il cliente paga (il suo checkout.url) oppure come fattura con collection_mode: manual e status: billed; rimborsa o accredita una transazione con paddle_create_adjustment (i rimborsi partono come pending_approval finché Paddle non li ha verificati); crea link al portale clienti, richiede report CSV e reinvia notifiche. Una pausa o una disdetta programmata si rimuove con paddle_update_subscription e scheduled_change: null.
Prima l'anteprima: paddle_preview_subscription_update, paddle_preview_transaction e paddle_preview_prices calcolano addebiti, imposte e totali senza salvare nulla. Prima di un cambio di piano l'AI esegue l'anteprima, ti mostra l'addebito immediato e aspetta il tuo sì. Sull'host live, transazioni fatturate, modifiche agli abbonamenti, attivazioni e rimborsi muovono denaro reale.
Disattivati all'installazione: paddle_cancel_subscription (una disdetta immediata è definitiva) e paddle_create_subscription_charge (addebita un importo una tantum sul metodo di pagamento salvato). Un admin del workspace li attiva consapevolmente.
Formati dei dati: ogni risposta ha data e meta.request_id. Gli ID hanno un prefisso: pro_ prodotto, pri_ prezzo, dsc_ sconto, ctm_ cliente, add_ indirizzo, biz_ azienda, sub_ abbonamento, txn_ transazione, adj_ adjustment, rep_ report, ntf_ notifica. Gli importi sono stringhe nell'unità minima della valuta: "1999" in USD sono 19,99 e lo JPY non ha decimali. I totali di una transazione sono in details.totals (subtotal, discount, tax, total, grand_total), quelli per voce in details.line_items. Le date sono RFC 3339 in UTC. I filtri con più valori sono separati da virgole.
File e report: paddle_get_transaction_invoice e paddle_get_adjustment_credit_note restituiscono un link PDF temporaneo che scade dopo circa un'ora. I report vengono generati in background: paddle_create_report, poi paddle_get_report finché lo stato è ready, poi paddle_get_report_csv per un link CSV che scade dopo pochi minuti. I tipi di report sono transazioni, voci di transazione, adjustment, voci di adjustment, sconti, prodotti e prezzi, saldo, riconciliazione dei payout, checkout e abbonamenti.
Paginazione: i tool di elenco restituiscono fino a per_page elementi (50 di default, al massimo 200). Finché meta.pagination.has_more è true, l'AI prende il valore after dall'URL in meta.pagination.next e lo passa come after.
Limiti: Paddle consente 240 richieste al minuto per indirizzo IP e oltre risponde 429.
Errori comuni: gli errori arrivano come error.type, error.code ed error.detail, e error.errors elenca i campi non validi. 401 indica una chiave errata o una chiave dell'altro ambiente (una chiave sandbox sull'host live o viceversa). 403 forbidden indica che alla chiave manca il permesso per quell'entità: modifica la chiave in Paddle e aggiungilo. 404 entity_not_found indica un ID errato o un ID dell'altro ambiente.
Il connettore non cancella nulla, non crea né modifica destinazioni delle notifiche e non funziona con gli account Paddle Classic.
Step 2 — Installa l'adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Step 3 — Aggiungi il connettore in ChatGPT
L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (
https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostraYOUR_SERVER_ID.
ChatGPT aggiunge i server MCP come plugin dalla pagina Plugins, sul web e nei piani a pagamento. La modalità sviluppatore non serve più. In un workspace Business possono farlo solo admin e owner; in Enterprise ed Edu un amministratore può concedere il permesso Create plugins with MCPs.
- Vai su chatgpt.com/plugins, clicca Add e poi Add custom MCP server.
- Inserisci un nome, ad esempio Name:
Paddle Billing. - In Connection inserisci come Server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDe lascia Authentication su OAuth. - Seleziona I understand and want to continue, poi Create as a plugin. Quando ChatGPT lo chiede, accedi ad AnythingMCP e consenti l'accesso.
- Installa il nuovo plugin dai tuoi plugin personali, poi digita @ in una chat e selezionalo.
Tool disponibili
| Tool | What it does |
|---|---|
paddle_list_products | List products in the catalog with name, tax category, type, status and custom data |
paddle_get_product | Get one product by id (pro_...) with its name, description, tax category, image URL, status and custom data; include prices to list its… |
paddle_create_product | Create a catalog product (what you sell) |
paddle_update_product | Update a product: name, description, tax category, image, custom data, or archive it with status archived |
paddle_list_prices | List prices with their product id, unit price (amount in the lowest currency unit), billing cycle, trial period, quantity limits and status |
paddle_get_price | Get one price by id (pri_...): product, description, unit price and overrides per country, billing cycle, trial period, tax mode and… |
paddle_create_price | Create a price for a product: amount and currency, optional billing cycle (subscription) and trial, country overrides and quantity limits |
paddle_update_price | Update a price: description, name, amount, billing cycle, trial, overrides, quantity limits, custom data, or archive it |
paddle_list_discounts | List discounts with code, type (flat, flat_per_seat, percentage), amount, recurring settings, usage limit, times used, expiry and status |
paddle_get_discount | Get one discount by id (dsc_...): code, type, amount, currency, whether it recurs and for how many intervals, usage limit, times used… |
paddle_create_discount | Create a discount: percentage or flat amount, optional checkout code, recurring behaviour, usage limit, product or price restrictions and… |
paddle_update_discount | Update a discount: amount, code, recurring settings, limits, restrictions, expiry, custom data, or archive it with status archived |
paddle_list_customers | List customers with name, email, locale, marketing consent and status |
paddle_get_customer | Get one customer by id (ctm_...): name, email, locale, marketing consent, status, custom data and timestamps |
paddle_create_customer | Create a customer by email (unique per account) with optional name, locale and custom data |
paddle_update_customer | Update a customer: email, name, locale, custom data, or archive it with status archived |
paddle_list_customer_addresses | List the addresses saved for a customer (add_... ids): country, postal code, region, city and lines |
paddle_create_customer_address | Add an address to a customer |
paddle_update_customer_address | Update a customer address: lines, city, postal code, region, country, custom data, or archive it |
paddle_list_customer_businesses | List the businesses saved for a customer (biz_... ids): company name, company number, tax identifier (VAT number) and contacts, used for… |
paddle_create_customer_business | Add a business to a customer for B2B billing: name, company number, VAT or tax id and invoice contacts |
paddle_update_customer_business | Update a customer business: name, company number, tax identifier, contacts, custom data, or archive it |
paddle_list_customer_credit_balances | Credit balances of a customer per currency: available, reserved and used credit created by adjustments (credits) on their subscriptions |
paddle_create_customer_portal_session | Create authenticated links to the Paddle customer portal for a customer, where they can update payment methods, see invoices and cancel |
paddle_list_subscriptions | List subscriptions with status, customer, address, items (price and quantity), currency, billing period, next billing date and any… |
paddle_get_subscription | Get one subscription by id (sub_...): status, customer, items, discount, billing cycle and current period, next billing date, scheduled… |
paddle_preview_subscription_update | Preview what an update to a subscription would charge or credit, without changing it: immediate transaction, next transaction and the… |
paddle_update_subscription | Update a subscription: change items or quantities (upgrade, downgrade, add-ons) with a proration mode, apply a discount, change billing… |
paddle_pause_subscription | Pause a subscription at the end of the billing period (default) or immediately, optionally with a date to resume automatically |
paddle_resume_subscription | Resume a paused subscription now (effective_from immediately) or at a given date-time, or change the date of a scheduled resume |
paddle_cancel_subscription | Cancel a subscription at the end of the billing period (default, can be undone by removing the scheduled change) or immediately (final) |
paddle_activate_subscription | End the trial of a trialing subscription now and start billing it: the first payment is collected immediately |
paddle_create_subscription_charge | Bill a one-time charge on a subscription (e.g. extra seats or a setup fee), now or with the next renewal |
paddle_list_transactions | List transactions (checkouts, renewals, invoices) with status, customer, subscription, items, totals in the lowest currency unit, invoice… |
paddle_get_transaction | Get one transaction by id (txn_...): status, items, totals and tax breakdown (details.totals, amounts in the lowest currency unit)… |
paddle_create_transaction | Create a transaction: a draft or ready checkout for a customer to pay (returns checkout.url), or an invoice for manual collection (status… |
paddle_update_transaction | Update a draft or ready transaction: items, customer, address, business, currency, discount, billing details, or set status billed or… |
paddle_preview_transaction | Preview a transaction without creating it: line items, tax, discounts and totals for given prices, customer or location |
paddle_get_transaction_invoice | Get a temporary link to the PDF invoice of a billed or completed transaction |
paddle_preview_prices | Localized price preview for a list of prices: subtotal, tax, discount and total per item in the customer's currency and country, as on a… |
paddle_list_adjustments | List adjustments (refunds, credits, chargebacks) with action, status (pending_approval, approved, rejected, reversed), transaction… |
paddle_create_adjustment | Refund or credit a billed or completed transaction, fully or for some items |
paddle_get_adjustment_credit_note | Get a temporary link to the PDF credit note of an approved adjustment |
paddle_list_reports | List reports you requested with type, status (pending, ready, failed, expired), filters, row count and expiry |
paddle_create_report | Request a CSV report: transactions, transaction_line_items, adjustments, adjustment_line_items, discounts, products_prices, balance… |
paddle_get_report | Get one report by id (rep_...): type, status, filters, number of rows and when it expires |
paddle_get_report_csv | Get a temporary download link for a ready report as CSV |
paddle_get_revenue_metrics | Net revenue per day for a date range in the account balance currency, as shown in the Paddle dashboard (amounts in the lowest currency unit) |
paddle_get_mrr_metrics | Monthly recurring revenue per day for a date range, as shown in the Paddle dashboard (amounts in the lowest currency unit) |
paddle_get_active_subscribers_metrics | Number of active subscribers per day for a date range, as shown in the Paddle dashboard metrics |
paddle_list_event_types | List the event types Paddle can send (transaction.completed, subscription.canceled, ...) with a description and the API version of each |
paddle_list_events | List events (what happened in the account): event_type, occurred_at and the full entity in data |
paddle_list_notification_settings | List notification destinations (webhook URLs and emails) with their subscribed event types, active flag and API version |
paddle_list_notifications | List webhook and email notifications sent for events, with status (delivered, failed, needs_retry, not_attempted), times attempted and the… |
paddle_get_notification | Get one notification by id (ntf_...): status, event payload, destination, attempts and last error |
paddle_list_notification_logs | List the delivery attempts of a notification with the HTTP status and response body your endpoint returned, to debug failing webhooks |
paddle_replay_notification | Send a notification again to its destination, e.g. after fixing a failing webhook endpoint |
Esempi di prompt
- "Quali sono stati ricavi netti e MRR per giorno il mese scorso, e quanti abbonati attivi avevamo alla fine del mese?"
- "Trova la cliente [email protected] e mostra i suoi abbonamenti con stato, voci e prossima data di addebito."
- "Calcola l'anteprima del passaggio di questo abbonamento al prezzo annuale con addebito proporzionale e mostrami l'addebito immediato prima di modificare qualcosa."
- "Elenca le transazioni past_due di questa settimana con cliente, importo ed errore di pagamento."
- "Quali notifiche webhook sono fallite nelle ultime 24 ore e cosa ha risposto il nostro endpoint?"
FAQ
Il piano free di ChatGPT funziona con i server MCP personalizzati? OpenAI documenta i server MCP personalizzati solo per i piani a pagamento; il piano Free non è nell'elenco.
Prossimi passi
- Landing del connettore
- Collegare a Claude
- Collegare a Cursor
- Collegare a Gemini
- Collegare a Meta Muse
- Collegare a Microsoft Copilot
Questa guida ti è stata utile?