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 + Microsoft Copilot
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 Microsoft Copilot
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.
Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.
- In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
- Inserisci un Server name (per esempio
AnythingMCP), una Server description che dica cosa fa il connettore e il Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server. - Come autenticazione scegli API key, imposta Type su Header e come nome dell'header
X-API-Key, poi seleziona Create. - In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
- Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di
Paddle Billing. - Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.
Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.
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
Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.
Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.
L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.
Prossimi passi
- Landing del connettore
- Collegare a Claude
- Collegare a ChatGPT
- Collegare a Cursor
- Collegare a Gemini
- Collegare a Meta Muse
Questa guida ti è stata utile?