In breve
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.
Configurazione guidata
Collega Customer.io a Microsoft Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Customer.io con la configurazione guidata e aggiungi il tuo URL MCP a Microsoft Copilot. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
Prova a chiedere
Prompt di esempio per Customer.io
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 → Customer.io, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente
git clone, niente server locale.
Customer.io + Microsoft Copilot
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.
- 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.
- Copia subito la chiave: Customer.io la mostra una sola volta. Incollala in
CUSTOMERIO_APP_API_KEYcosì come appare, senza il prefisso Bearer. È una App API key, non una Track API key. - Imposta
CUSTOMERIO_API_URLsul data center del tuo account:https://api.customer.ioper gli account negli Stati Uniti,https://api-eu.customer.ioper quelli nell'UE, senza/v1né altri percorsi. La regione viene fissata alla creazione dell'account. - 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_emailinvia 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_broadcastinvia 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 concustomer_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 Microsoft Copilot
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 mostraYOUR_SERVER_ID.
Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.
- In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
- Inserisci un Server name (per esempio
AnythingMCP), una Server description che dica cosa fa il connettore e il Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server. - Come autenticazione scegli API key, imposta Type su Header e come nome dell'header
X-API-Key, poi seleziona Create. - In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
- Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di
Customer.io. - Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.
Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.
Tool disponibili
| Tool | What it does |
|---|---|
customer_io_list_workspaces | List the workspaces of the Customer.io account with their id, name and counts of people, objects and messages sent in the billing period… |
customer_io_find_customers_by_email | Find the people in the workspace with an email address: returns their id, email and cio_id |
customer_io_search_customers | Search people in the workspace with a filter on segment membership and attribute values, up to 1000 per page; returns their identifiers… |
customer_io_get_customer_attributes | Get a person's profile: all attributes (stored as strings), identifiers, subscription preferences, timestamps and devices |
customer_io_get_customer_segments | List the segments a person currently belongs to (id, name, description) |
customer_io_list_customer_activities | List what happened to a person in the last 30 days or more: events, attribute changes, messages attempted, sent, opened, clicked, bounced… |
customer_io_list_customer_messages | List the deliveries sent to a person (newest six months unless start_ts and end_ts are given): message id, automation, broadcast or… |
customer_io_list_campaigns | List the automations (campaigns) of the workspace: id, name, type of trigger, state, active flag, created and updated times, trigger and… |
customer_io_get_campaign | Get one automation (campaign) with its trigger, segments, state, tags and actions (messages, delays, branches) |
customer_io_get_campaign_metrics | Get an automation's message metrics over a window: series of attempted, sent, delivered, opened, clicked, converted, bounced, spammed… |
customer_io_list_broadcasts | List the API-triggered broadcasts of the workspace: id, name, active flag, created and updated times, tags and actions |
customer_io_get_broadcast | Get one API-triggered broadcast: name, state, active flag, created, updated and first started times, tags and actions |
customer_io_get_broadcast_metrics | Get a broadcast's message metrics per period: series of attempted, sent, delivered, opened, clicked, converted, bounced, unsubscribed… |
customer_io_get_broadcast_trigger | Get the status of one broadcast trigger (as returned by customer_io_trigger_broadcast): created, processed and cancelled times, schedule… |
customer_io_list_newsletters | List the one-time sends (newsletters) of the workspace: id, name, type, sent and created times, recipient segments, tags and variant… |
customer_io_get_newsletter_metrics | Get a one-time send's message metrics per period: series of attempted, sent, delivered, opened, clicked, converted, bounced, unsubscribed… |
customer_io_list_segments | List the segments of the workspace (not archived ones): id, name, description, type (data-driven or manual), state, progress and tags |
customer_io_get_segment | Get one segment with its conditions (for data-driven segments), type, state and tags |
customer_io_get_segment_customer_count | Count the people currently in a segment, for example to size a broadcast audience before sending |
customer_io_list_segment_members | List the people in a segment, page by page: their identifiers (id, email, cio_id) |
customer_io_list_messages | List deliveries across the workspace, newest first, filtered by message type, metric (sent, delivered, opened, clicked, bounced… |
customer_io_get_message | Get one delivery by id: recipient, parent automation, broadcast, one-time send or transactional message, subject, template, created, sent… |
customer_io_list_activities | List activities across the workspace, newest first: events, attribute changes and message activity, optionally for one person, one type or… |
customer_io_list_transactional_messages | List the transactional message templates of the workspace (id, name, description, link tracking, body retention) |
customer_io_send_transactional_email | Send one transactional email (receipts, password resets, notifications) to up to 15 addresses in to, cc and bcc, from a transactional… |
customer_io_trigger_broadcast | Trigger an API-triggered broadcast: send it to its default audience set in Customer.io, or to listed emails or ids, per-person data, or… |
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
Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.
Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.
L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.
Prossimi passi
- Landing del connettore
- Collegare a Claude
- Collegare a ChatGPT
- Collegare a Cursor
- Collegare a Gemini
- Collegare a Meta Muse
Questa guida ti è stata utile?