Collegare SumUp a Gemini CLI via MCP: pagamenti

💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connectors → SumUp, incolla le tue credenziali, genera una chiave API MCP — fatto. Niente Docker, niente git clone, nessun server locale.

SumUp + Gemini

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 in-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.

1. Accedi alla SumUp Dashboard su https://me.sumup.com.
2. Apri Settings → For Developers (oppure il Developer Portal).
3. Genera una chiave API (Personal Access Token) e incollala in SUMUP_API_KEY. Viene inviata come Bearer token a ogni chiamata.
4. 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 Gemini

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 mostra YOUR_SERVER_ID.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di SumUp.

Strumenti disponibili

FAQ

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

• Pagina del connettore
• Collegati a Claude
• Collegati a ChatGPT