Salta l'installazione. Attivo in meno di 2 minuti.
Avvia una prova gratuita su cloud.anythingmcp.com, aggiungi PayPal 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
Fai lavorare la tua AI con il tuo conto PayPal business: crea e incassa ordini, rimborsa pagamenti, crea, invia e sollecita fatture, cerca nello storico delle transazioni e nei saldi, esamina le contestazioni e consulta piani di abbonamento, abbonamenti e lotti di payout. Sandbox o live, con le chiavi della tua app REST.
Prova a chiedere
Prompt di esempio per PayPal
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 → PayPal, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente
git clone, niente server locale.
PayPal
Fai lavorare la tua AI con il tuo conto PayPal business: crea e incassa ordini, rimborsa pagamenti, crea, invia e sollecita fatture, cerca nello storico delle transazioni e nei saldi, esamina le contestazioni e consulta piani di abbonamento, abbonamenti e lotti di payout. Sandbox o live, con le chiavi della tua app REST.
Setup
- Accedi a developer.paypal.com con il tuo conto PayPal business e apri Apps & Credentials. L'interruttore in alto passa tra Sandbox e Live; ognuno ha app e chiavi proprie.
- Usa la Default Application oppure clicca su Create App, scegli il tipo Merchant e, nella sandbox, seleziona il conto business sandbox per cui l'app deve operare.
- Apri l'app e, tra le sue funzionalità, spunta ciò a cui l'AI deve accedere: Invoicing, Transaction Search, Subscriptions (copre anche i prodotti del catalogo), Customer Disputes e Payouts.
- Copia il Client ID in
PAYPAL_CLIENT_IDe Secret key 1 (clicca per mostrarla) inPAYPAL_CLIENT_SECRET. Devono venire entrambi dalla stessa app e dalla stessa sezione, Sandbox o Live. - Imposta
PAYPAL_API_URLsuhttps://api-m.sandbox.paypal.comper le chiavi sandbox o suhttps://api-m.paypal.comper le chiavi live, senza barra finale. - Installa il connettore. Non c'è nessun passaggio Authorize with Provider e nessuna schermata di consenso PayPal: il connettore accede come la tua app REST con client ID e secret.
- Comincia con
paypal_get_balancesper controllare che le chiavi raggiungano il conto giusto (serve Transaction Search sull'app).
Restare connessi: il connettore ottiene i token di accesso con client ID e secret e li rinnova prima che scadano, quindi non c'è nessun accesso da ripetere.
Le nuove funzionalità richiedono tempo: PayPal può impiegare fino a 9 ore per attivare una funzionalità appena spuntata su un'app che ha già emesso token. Fino ad allora quelle chiamate rispondono 403 NOT_AUTHORIZED, quindi spunta tutto ciò che ti serve prima della prima installazione.
Pagamenti ed email: paypal_capture_order, paypal_refund_capture e paypal_cancel_subscription muovono o fermano denaro reale su un conto live, mentre paypal_send_invoice, paypal_remind_invoice e paypal_cancel_invoice inviano un'email al cliente. L'AI dice prima esattamente cosa succederà (importo, valuta, cliente, id) e aspetta il tuo sì. Incassi e rimborsi portano un request id, così un nuovo tentativo non può agire due volte.
Permessi e solo lettura: l'app raggiunge solo le funzionalità che spunti, quindi lascia fuori quelle che l'AI non deve usare. Per una configurazione in sola lettura disattiva paypal_create_order, paypal_capture_order, paypal_refund_capture, paypal_create_draft_invoice, paypal_send_invoice, paypal_remind_invoice, paypal_cancel_invoice e paypal_cancel_subscription. Con le chiavi sandbox puoi provare tutto prima senza rischi.
Disattivati all'installazione: paypal_delete_draft_invoice, che elimina definitivamente una bozza o una fattura programmata. Attivalo solo se l'AI deve eliminare bozze; le fatture già inviate si annullano invece con paypal_cancel_invoice.
Ordini e rimborsi: paypal_create_order non addebita nulla. Restituisce un link di approvazione che l'acquirente deve aprire e confermare; solo dopo paypal_capture_order può incassare il denaro. paypal_refund_capture rimborsa un incasso per intero oppure in parte, se indichi un importo, fino a quanto resta dopo i rimborsi precedenti.
Fatture e storico: paypal_create_draft_invoice non invia nulla finché paypal_send_invoice non spedisce la fattura, e PayPal consente al massimo 2 solleciti al giorno. paypal_search_transactions copre al massimo 31 giorni per chiamata (i periodi più lunghi si interrogano mese per mese) e risale fino a 3 anni; nuove transazioni e saldi compaiono con un ritardo fino a 3 ore. Le contestazioni risalgono fino a 180 giorni.
Errori comuni: 401 invalid_client o invalid_token significa client ID o secret errati, oppure chiavi dell'altro ambiente rispetto a PAYPAL_API_URL (le chiavi sandbox vogliono l'URL sandbox, quelle live l'URL live). 403 NOT_AUTHORIZED o PERMISSION_DENIED significa che la funzionalità non è spuntata sull'app, o lo è da meno di 9 ore. 422 UNPROCESSABLE_ENTITY indica la regola violata, per esempio ORDER_NOT_APPROVED (l'acquirente non ha ancora approvato), AMOUNT_MISMATCH o CAPTURE_FULLY_REFUNDED. 429 RATE_LIMIT_REACHED significa che PayPal sta limitando l'app: aspetta un minuto e riprova.
Il connettore non gestisce pagamenti con carta e salvataggio dei metodi di pagamento (vaulting), webhook, invio di payout, accettazione o risposta alle contestazioni, né modifica dei piani di abbonamento.
Prerequisiti: PAYPAL_CLIENT_ID, PAYPAL_CLIENT_SECRET, PAYPAL_API_URL
Installazione locale del connettore
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
Apri http://localhost:3000/connectors/store, scegli PayPal e inserisci le variabili elencate nei Prerequisiti.
Tool disponibili
| Tool | What it does |
|---|---|
paypal_create_order | Create a checkout order (nothing is charged yet) |
paypal_get_order | Read one checkout order: status (CREATED, APPROVED, COMPLETED, VOIDED, ...), amounts, payer, and for completed orders the captures under… |
paypal_capture_order | Collect the money of an order the buyer has approved (intent CAPTURE) |
paypal_get_capture | Read one captured payment: amount, status (COMPLETED, PENDING, PARTIALLY_REFUNDED, REFUNDED, DECLINED), seller fees and net amount, and… |
paypal_refund_capture | Refund a captured payment, in full (no amount) or in part |
paypal_get_refund | Read one refund: amount, status (COMPLETED, PENDING, FAILED, CANCELLED), note to the payer and the capture it belongs to |
paypal_get_authorization | Read one authorized payment (an order created with intent AUTHORIZE): amount, status (CREATED, CAPTURED, PARTIALLY_CAPTURED, VOIDED… |
paypal_list_invoices | List invoices, newest first, with id, number, status, recipient, amount and due date |
paypal_search_invoices | Search invoices by recipient, number, status, currency, dates or amount (all filters combined with AND) |
paypal_create_draft_invoice | Create a draft invoice |
paypal_get_invoice | Read one invoice: status, recipient, items, amounts, due amount, payments and refunds recorded on it, and the payer link (links[] rel… |
paypal_send_invoice | Send a draft invoice |
paypal_remind_invoice | Email a payment reminder for a sent, unpaid invoice (PayPal allows 2 reminders a day) |
paypal_cancel_invoice | Cancel a sent invoice so it can no longer be paid; by default the recipient is told by email |
paypal_delete_draft_invoice | Delete a draft or scheduled invoice for good (sent invoices are cancelled with paypal_cancel_invoice instead) |
paypal_search_transactions | Search the account history (Transaction Search): payments received and sent, refunds, fees, transfers and their payer and cart details |
paypal_get_balances | Read the account balances per currency (available, withheld and total), now or as of a past time: balances[] with as_of_time |
paypal_list_disputes | List disputes, claims and chargebacks raised against the account (last 180 days), with dispute_id, reason, status, dispute_state, amount… |
paypal_get_dispute | Read one dispute in full: reason, status, amounts, disputed transactions, messages, offers, evidence and the deadline to respond… |
paypal_list_products | List catalog products (the products subscription plans belong to): id, name, description, type and dates |
paypal_get_product | Read one catalog product: name, description, type (PHYSICAL, DIGITAL, SERVICE), category, image and home URLs |
paypal_list_plans | List subscription plans, optionally for one product: id, name, status (CREATED, ACTIVE, INACTIVE), product_id and dates |
paypal_get_plan | Read one subscription plan: billing cycles with prices and frequency, trial periods, setup fee, taxes and payment failure settings |
paypal_list_subscriptions | List subscriptions, filtered by plan and status: id, status, plan_id, subscriber, start time and next billing time |
paypal_get_subscription | Read one subscription: status, plan, subscriber (name, email, shipping address), billing info (outstanding balance, last payment, next… |
paypal_list_subscription_transactions | List the payments of one subscription between two times: id, status, amounts with fees and net, payer and time |
paypal_cancel_subscription | Cancel a subscription for good: no further payments are collected and it cannot be reactivated |
paypal_get_payout_batch | Read one payout batch: batch status and totals, and its items (receiver, amount, status, fees, errors) |
Esempi di prompt
- "Qual è il mio saldo PayPal attuale e quali pagamenti sono arrivati negli ultimi 7 giorni?"
- "Crea una bozza di fattura per Acme Srl: 10 ore di consulenza a 90 EUR, scadenza a 30 giorni. Fammela vedere prima di inviarla."
- "Quali contestazioni aspettano una mia risposta e entro quando devo rispondere a ciascuna?"
- "Elenca gli abbonamenti attivi del piano Pro Monthly e dimmi quali hanno pagamenti non riusciti."
Prossimi passi
Questa guida ti è stata utile?
