Come collegare Customer.io a Gemini via MCP

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

Customer.io + Gemini

Fai lavorare la tua AI con Customer.io: consulta le persone con attributi, segmenti, attività e messaggi, analizza automazioni, broadcast e invii singoli con le loro metriche, e invia email transazionali o avvia broadcast dopo la tua conferma.

Prerequisiti

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

CUSTOMERIO_API_URL, CUSTOMERIO_APP_API_KEY

Step 1 — Ottieni le credenziali

La configurazione richiede circa 3 minuti. Serve un utente Customer.io che possa creare una App API key, e devi sapere se il tuo account è ospitato negli Stati Uniti o nell'UE.

1. In Customer.io apri Settings → Account Settings → API Credentials → App API Keys (fly.customer.io/settings/api_credentials) e clicca Create App API Key. Scegli il workspace e l'accesso della chiave: accesso completo, oppure sola lettura più invio se l'AI deve solo leggere e inviare.
2. Copia subito la chiave: Customer.io la mostra una sola volta. Incollala in CUSTOMERIO_APP_API_KEY così come appare, senza il prefisso Bearer. È una App API key, non una Track API key.
3. Imposta CUSTOMERIO_API_URL sul data center del tuo account: https://api.customer.io per gli account negli Stati Uniti, https://api-eu.customer.io per quelli nell'UE, senza /v1 né altri percorsi. La regione viene fissata alla creazione dell'account.
4. Installa il connettore e inizia con customer_io_list_workspaces: verifica la chiave e mostra il workspace con il numero di persone e messaggi.

Una chiave per tutto il workspace: la App API key agisce per il suo workspace, non per una singola persona. Chi usa questo connettore vede tutte le persone, i segmenti e i messaggi che la chiave può leggere, quindi condividi il server MCP solo con chi è autorizzato a vederli.

Cosa copre: le persone (trovale per email, o cercale per appartenenza a un segmento e valori degli attributi), i loro attributi, segmenti, le attività degli ultimi 30 giorni e i messaggi inviati; i segmenti con condizioni, numero attuale di persone e membri; le automazioni, che l'API di Customer.io chiama campaigns, con le metriche dei messaggi; i broadcast avviati via API e gli invii singoli (newsletters nell'API) con le loro metriche; consegne e attività in tutto il workspace; e i modelli dei messaggi transazionali.

Gli invii aspettano il tuo sì: solo due tool inviano, tutti gli altri leggono.

• customer_io_send_transactional_email invia una vera email (ricevute, reset della password, notifiche) a un massimo di 15 indirizzi tra to, cc e bcc, da un modello transazionale o con oggetto e testo tuoi. Prima l'AI ti mostra destinatario, oggetto e contenuto.
• customer_io_trigger_broadcast invia a molte persone insieme. L'AI mostra prima il broadcast, la dimensione del pubblico (customer_io_get_segment_customer_count) e i dati, e lo avvia solo dopo un esplicito "yes, send". Poi ne segue l'avanzamento con customer_io_get_broadcast_trigger.

Track API non inclusa: identificare persone, registrare eventi e cancellare persone passa dalla Track API di Customer.io, che usa altre credenziali (Site ID e Track API key). Questo connettore non la usa, quindi non può modificare profili né cancellare nessuno.

Limiti: la App API consente circa 10 richieste al secondo. Gli invii transazionali condividono un limite indicativo di 3.000 richieste ogni 3 secondi, e un broadcast si può avviare al massimo una volta ogni 10 secondi. Gli elenchi lunghi arrivano a pagine e l'AI continua a leggere fino all'ultima. I timestamp sono secondi Unix.

Errori comuni: 401 significa che la App API key è sbagliata o è stata eliminata, oppure che l'account si trova nell'altra regione; controlla CUSTOMERIO_API_URL. 403: l'accesso della chiave non comprende questa azione, per esempio una chiave di sola lettura usata per inviare. 404: l'id non esiste in questo workspace. 400 o 422: un parametro o il filtro di ricerca non è valido; l'errore indica quale. 429: è stato raggiunto un limite; attendi e riprova.

Il connettore non usa la Track API né la Pipelines API, non esegue esportazioni o importazioni, non gestisce collections, snippets, webhook di reporting o liste di soppressione ESP e non modifica il contenuto di automazioni e broadcast.

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 Customer.io.

Tool disponibili

Esempi di prompt

• "Trova [email protected] in Customer.io e mostrami i suoi attributi, i suoi segmenti e le ultime email che le abbiamo inviato."
• "Com'è andata la nostra automazione di Onboarding negli ultimi 30 giorni: inviati, consegnati, aperti, cliccati e disiscritti?"
• "Quante persone ci sono adesso nel segmento Trial ending, e quali di loro hanno il piano pro?"
• "Avvia il broadcast Product update, ma prima di inviare mostrami chi lo riceverà e quante persone sono."

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