In breve
Consulta account esercente, transazioni, pagamenti, checkout, ricevute, lettori di carte, membri del team e sotto-account SumUp da qualsiasi agente AI. In sola lettura, con autenticazione Bearer token.
Configurazione guidata
Collega SumUp a ChatGPT in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega SumUp con la configurazione guidata e aggiungi il tuo URL MCP a ChatGPT. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
Il plugin AnythingMCP nella directory di ChatGPT risponde, su AnythingMCP Cloud, a domande sui database aziendali (PostgreSQL, MySQL, SQL Server, Oracle, SAP HANA, SQLite, MongoDB, in sola lettura): apri la scheda (si apre in una nuova scheda) e clicca Install plugin. Tutti gli altri connettori si aggiungono a ChatGPT come server MCP personalizzato con l'URL MCP del tuo AnythingMCP.
Prova a chiedere
Prompt di esempio per SumUp
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.
💡 Non vuoi installare nulla? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connectors → SumUp, incolla le tue credenziali, genera una chiave API MCP — fatto. Nessun Docker, nessun
git clone, nessun server locale.
SumUp + ChatGPT
Consulta account esercente, transazioni, pagamenti, checkout, ricevute, lettori di carte, membri del team e sotto-account SumUp da qualsiasi agente AI. In sola lettura, con autenticazione Bearer token.
Prerequisiti
Consulta le istruzioni di configurazione complete incluse nel connettore (visibili nello store dell'app quando selezioni il connettore). Le variabili d'ambiente richieste per questo connettore sono:
SUMUP_API_KEY
Passaggio 1 — Ottieni le credenziali
La configurazione richiede circa 2 minuti. Ti servono un account esercente SumUp e una chiave API associata.
- Accedi alla SumUp Dashboard su https://me.sumup.com.
- Apri Settings → For Developers (oppure il Developer Portal).
- Genera una chiave API (Personal Access Token) e incollala in
SUMUP_API_KEY. Viene inviata come Bearer token a ogni chiamata. - Installa il connettore ed esegui
sumup_get_merchant_profile: restituisce il codice esercente, la ragione sociale, la valuta e il paese dell'account associato alla chiave, a conferma che la chiave funziona.
Cosa legge: il profilo dell'esercente; lo storico delle transazioni, per impostazione predefinita dalla più recente, filtrato per stato (come SUCCESSFUL, CANCELLED o FAILED) oppure limitato alle transazioni modificate a partire da un timestamp ISO 8601, fino a 100 per pagina; una singola transazione tramite il suo id o il suo codice transazione (come TD6Q7P2); i pagamenti verso il tuo conto bancario tra due date (YYYY-MM-DD); i checkout online e i link di pagamento, filtrati in base al tuo riferimento checkout; e i sotto-account operatore dell'account principale.
Codice esercente, ricevute, team e lettori di carte: le versioni attuali dell'API SumUp individuano un account tramite il suo codice esercente, che sumup_get_merchant_profile restituisce; se la chiave raggiunge più account, sumup_list_memberships li elenca e sumup_get_merchant ne mostra uno. Con quel codice l'AI legge anche le transazioni e i pagamenti sulle versioni attuali dell'API (i pagamenti includono le trattenute come rimborsi e chargeback), la ricevuta di una transazione, un singolo checkout online, i metodi di pagamento offerti online, i clienti salvati e le loro carte tokenizzate (solo le ultime quattro cifre), i membri, i ruoli personalizzati e le persone registrate (titolari, rappresentanti legali), e i lettori di carte associati con il loro stato in tempo reale e il checkout inviato a ciascuno. Gli strumenti precedenti per transazioni e pagamenti restano per le configurazioni esistenti. Un errore 403 significa che l'utente della chiave non ha in SumUp il permesso per quell'account.
Sola lettura: tutti i 26 strumenti eseguono solo letture. Nulla nel tuo account SumUp viene modificato; rimborsi, nuovi checkout, incassi sul lettore e modifiche ai membri si fanno nella SumUp Dashboard.
Già installato? I nuovi strumenti arrivano a un connettore installato in precedenza tramite il suo aggiornamento di catalogo: apri il connettore in AnythingMCP e, sotto Catalog update available, controlla l'elenco dei nuovi strumenti e clicca Apply update. Le tue credenziali e gli strumenti che hai aggiunto tu restano come sono.
Passaggio 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
Passaggio 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 mostriYOUR_SERVER_ID.
ChatGPT aggiunge i server MCP come plugin nella pagina Plugins, sul web e con i piani a pagamento. La modalità sviluppatore non è più necessaria. In un workspace Business solo amministratori e proprietari possono aggiungerne uno; in Enterprise ed Edu un amministratore può concedere il permesso Create plugins with MCPs.
- Vai su chatgpt.com/plugins, clicca su Add, quindi su Add custom MCP server.
- Inserisci un nome, ad es. Name:
SumUp. - In Connection, inserisci il 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 te lo chiede, accedi ad AnythingMCP e consenti l'accesso.
- Installa il nuovo plugin dai tuoi plugin personali, poi digita @ in una chat e selezionalo.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
sumup_get_merchant_profile | Recupera il profilo dell'esercente e le informazioni sull'account associati alla chiave API autenticata, inclusi codice esercente, ragione sociale… |
sumup_list_transactions | Elenca lo storico delle transazioni dell'account esercente autenticato, con filtri per intervallo di date, stato del pagamento e paginazione |
sumup_get_transaction | Recupera le informazioni dettagliate di una specifica transazione tramite ID transazione o codice transazione |
sumup_list_payouts | Recupera lo storico dei pagamenti e i report di liquidazione trasferiti al conto bancario dell'esercente, filtrati per intervallo di date |
sumup_list_checkouts | Elenca i checkout online e i link di pagamento generati per i clienti, con filtri opzionali per stato e riferimento del checkout |
sumup_list_subaccounts | Recupera i sottoaccount operatore configurati sotto l'account esercente principale |
sumup_list_memberships | Elenca gli account merchant (e le organizzazioni) a cui appartiene l'utente della chiave API, con il codice merchant come resource.id, il nome dell'account… |
sumup_get_merchant | Recupera un account merchant tramite il codice merchant: ragione sociale e dati legali, tipo di attività e profilo, paese, valuta e impostazioni locali predefinite… |
sumup_list_merchant_payouts | Elenca i payout sul conto bancario del merchant tra due date (API v1.0 attuale): data del payout, importo, commissione, valuta, stato, riferimento… |
sumup_list_merchant_transactions | Elenca le transazioni del merchant (API v2.1 attuale): pagamenti con carta, in contanti e online, rimborsi e chargeback con importo, valuta, stato… |
sumup_get_merchant_transaction | Recupera tutti i dettagli di una transazione (API v2.1 attuale): importo, IVA, mancia, commissione, stato, carta e modalità di inserimento, prodotti, piano di payout… |
sumup_get_receipt | Recupera la ricevuta strutturata di una transazione: dati del merchant, dati della transazione con prodotti e IVA, dati della carta (EMV) e dell'acquirer |
sumup_get_checkout | Recupera un checkout online tramite il suo id: importo, valuta, stato (PENDING, PAID, FAILED, EXPIRED), riferimento checkout, descrizione… |
sumup_get_customer | Recupera un cliente salvato (usato per pagamenti online ricorrenti o tokenizzati) tramite l'id cliente che hai assegnato: dati personali come il nome… |
sumup_list_payment_instruments | Elenca gli strumenti di pagamento salvati di un cliente: token della carta, tipo di carta e dati mascherati, mandato, data di creazione… |
sumup_list_payment_methods | Elenca i metodi di pagamento disponibili al merchant per i checkout online (carte, Apple Pay, Google Pay, iDEAL, Bancontact e altri)… |
sumup_list_members | Elenca i membri (utenti) di un account merchant con e-mail, ruoli, stato (accepted, pending…) e permessi |
sumup_get_member | Recupera un membro di un account merchant: utente, e-mail, ruoli, permessi, stato e timestamp |
sumup_list_roles | Elenca i ruoli personalizzati di un account merchant con nomi e permessi, per spiegare cosa consente il ruolo di un membro |
sumup_get_role | Recupera un ruolo personalizzato di un account merchant con i relativi permessi |
sumup_list_persons | Elenca le persone registrate per un account merchant (rappresentanti legali, titolari e altre persone dell'attività)… |
sumup_get_person | Recupera una persona registrata per un account merchant |
sumup_list_readers | Elenca i lettori di carte (ad es. SumUp Solo) associati all'account merchant: id, nome, stato, modello e identificativo del dispositivo |
sumup_get_reader | Recupera un lettore di carte associato: nome, stato, modello e identificativo del dispositivo, metadati e timestamp |
sumup_get_reader_status | Recupera lo stato in tempo reale di un lettore di carte: online o offline, livello della batteria, tipo di connessione, firmware e stato del checkout in corso |
sumup_get_reader_checkout | Recupera un checkout inviato a un lettore di carte: importo, stato e la transazione risultante |
FAQ
Il piano gratuito di ChatGPT funziona con i server MCP personalizzati? OpenAI documenta i server MCP personalizzati solo per i piani a pagamento; il piano Free non è nel suo elenco.
Prossimi passi
Questa guida ti è stata utile?