Come collegare Seal Subscriptions a Gemini via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Seal Subscriptions, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Seal Subscriptions + Gemini

Gestisci gli abbonamenti Shopify di Seal Subscriptions dalla tua AI: trova gli abbonati, leggi gli addebiti in arrivo e quelli falliti, salta o riprogramma una consegna, metti in pausa o riattiva, cambia articoli, indirizzo e sconti, e gestisci regole di abbonamento e webhook.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

SEAL_SUBSCRIPTIONS_API_TOKEN

Step 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti e serve un negozio Shopify con l'app Seal Subscriptions e l'accesso alle sue impostazioni.

1. Nell'admin di Shopify apri Apps → Seal Subscriptions → Settings → General Settings → API.
2. Copia l'API token, non l'API secret (che serve solo a firmare i webhook), in SEAL_SUBSCRIPTIONS_API_TOKEN e installa il connettore. Il token viene inviato solo a Seal.
3. Il token appartiene a un solo negozio: installa il connettore una volta per negozio.

Cosa copre: abbonamenti cercati per e-mail o nome del cliente, oppure per stato (attivo, in pausa, annullato); tutto ciò che si rinnova in un intervallo di tempo; il singolo abbonamento con cliente, indirizzo di spedizione, intervalli di consegna e fatturazione, articoli, sconti e addebiti (programmati, completati o falliti con il messaggio di errore); le regole di abbonamento (i piani offerti nelle pagine prodotto); e i webhook.

Cosa può cambiare l'AI: mettere in pausa, riprendere o riattivare un abbonamento; cambiarne intervalli, metodo di consegna e indirizzo di spedizione; aggiungere prodotti, anche una tantum per il prossimo rinnovo; sostituire una variante o cambiare quantità e prezzo; applicare un codice sconto; saltare un addebito in arrivo, annullare il salto o riprogrammarlo; inviare al cliente l'e-mail di Seal con il link per aggiornare il metodo di pagamento; e registrare un webhook.

Conferma prima: ogni scrittura agisce sull'abbonamento di un cliente reale, e il cliente vede salti, pause e addebiti. L'AI dice di quale abbonamento si tratta (cliente e id) e cosa cambierà, e aspetta il tuo sì.

Disattivati all'installazione: seal_subscriptions_cancel_subscription, seal_subscriptions_schedule_cancellation, seal_subscriptions_remove_items, seal_subscriptions_remove_discount_code, seal_subscriptions_delete_webhook, i due strumenti che addebitano subito denaro (seal_subscriptions_charge_now e seal_subscriptions_process_billing_attempt) e seal_subscriptions_get_customer_magic_link, il cui link permette a chiunque lo abbia di modificare gli abbonamenti di quel cliente. Attiva solo quelli che servono al tuo team, uno alla volta.

Privacy: gli abbonamenti contengono nomi, e-mail, telefono, indirizzi e le ultime cifre della carta. L'AI mostra solo ciò che serve alla domanda, e il link di modifica segreto del cliente viene tolto dalle risposte.

Errori comuni: 403 Access forbidden.: il token è sbagliato, revocato o di un altro negozio; copialo di nuovo dalle impostazioni API di Seal. 503: Seal consente 10 richieste contemporanee per token; aspetta che finiscano le chiamate in corso e riprova. 404 o success: false: l'id non esiste, oppure l'azione non è consentita nello stato attuale dell'abbonamento, per esempio saltare un addebito già elaborato.

Il connettore non crea né elimina abbonamenti o singoli addebiti, non modifica le regole di abbonamento, non gestisce gli ordini di evasione degli abbonamenti prepagati e non crea link di quick checkout.

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 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 Seal Subscriptions.

Tool disponibili

Esempi di prompt

• "Trova l'abbonamento di [email protected] e dimmi quando è il prossimo addebito e cosa contiene."
• "Quali abbonamenti si rinnovano la prossima settimana? Raggruppali per prodotto."
• "Elenca gli abbonamenti il cui ultimo addebito è fallito, con l'errore, e invia a quei clienti l'e-mail per aggiornare il metodo di pagamento."
• "Salta la prossima consegna di Marco Rossi, è in vacanza, e sposta quella successiva al 3 novembre."
• "Metti in pausa l'abbonamento di [email protected] finché non ti dico altrimenti."

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

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT