Come collegare Twilio a Microsoft Copilot via MCP

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

Twilio + Microsoft Copilot

Fai lavorare la tua AI con Twilio: invia e consulta messaggi SMS e WhatsApp, controlla chiamate e numeri di telefono, verifica i numeri con Lookup, invia e controlla codici monouso con Verify e tieni d'occhio utilizzo, costi e credito.

Prerequisiti

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

TWILIO_ACCOUNT_SID, TWILIO_API_KEY_SID, TWILIO_API_KEY_SECRET

Step 1 — Ottieni le credenziali

1. Accedi su console.twilio.com. Il pannello Account Info nella pagina iniziale mostra l'Account SID (inizia con AC) e l'Auth Token.
2. Consigliato: crea una API key invece di usare l'Auth Token. Nella Console apri Settings → Account settings → API keys & auth tokens (nella Console legacy Admin → Account management → API keys & tokens), clicca su Create API key, scegli il tipo Standard e copia il SID (inizia con SK) e il Secret: Twilio mostra il secret una sola volta. Una key si può revocare da sola, senza cambiare l'Auth Token.
3. Inserisci l'Account SID in TWILIO_ACCOUNT_SID. Poi metti il SID della key (SK...) in TWILIO_API_KEY_SID e il suo secret in TWILIO_API_KEY_SECRET, oppure di nuovo l'Account SID (AC...) in TWILIO_API_KEY_SID e l'Auth Token in TWILIO_API_KEY_SECRET.
4. Installa il connettore e comincia con twilio_list_phone_numbers: elenca i numeri che possiedi, cioè i mittenti che l'AI può usare. Una API key Standard non può leggere il record dell'account stesso, quindi con una key di questo tipo twilio_get_account può rispondere 401 o 403; tutti gli altri strumenti funzionano.

Inviare costa e raggiunge persone reali: twilio_send_message e twilio_send_verification mandano un messaggio o un codice vero a una persona vera, e Twilio fattura ogni invio. Prima l'AI indica destinatario, mittente, canale e testo e aspetta il tuo sì. Lo stesso vale per twilio_cancel_scheduled_message.

Disattivati all'installazione: twilio_delete_message, che elimina per sempre un messaggio insieme al suo testo. Attivalo solo se l'AI deve eliminare messaggi.

Account trial: un account di prova invia solo a un massimo di cinque numeri verificati (altrimenti errore 21608) e solo nel paese in cui ti sei registrato. In trial, un SMS inviato tramite API può usare come testo solo uno dei template di esempio di Twilio (come sms_2fa o sms_appointment_reminders); per il testo libero serve un account aggiornato.

WhatsApp: metti whatsapp: davanti a entrambi i numeri (whatsapp:+4915112345678). Per un primo test usa la WhatsApp Sandbox nella Console legacy: la persona invia join <code> al numero della sandbox, poi per tre giorni puoi scriverle da whatsapp:+14155238886. Oltre 24 ore dopo il suo ultimo messaggio, WhatsApp consegna solo template approvati, inviati con content_sid (HX...) e content_variables (altrimenti errore 63016).

Numeri: sempre in formato E.164, cioè +, prefisso internazionale e numero senza spazi (+4915112345678). twilio_list_phone_numbers mostra i numeri da cui puoi inviare; twilio_list_messaging_services elenca i tuoi Messaging Service, necessari per i messaggi programmati (schedule_type fixed con send_at).

Stato di consegna: un nuovo messaggio parte come queued. Chiedi all'AI di controllarlo più tardi con twilio_get_message: failed o undelivered arrivano con un error_code che puoi cercare nell'elenco degli errori di Twilio. twilio_list_messages e twilio_list_calls mostrano lo storico, dal più recente.

Lookup: twilio_lookup_phone_number senza fields è gratuito e controlla formato e paese. Ogni pacchetto di dati in fields (come line_type_intelligence, sms_pumping_risk o caller_name) si paga a ogni ricerca, quindi l'AI chiede prima.

Verify: crea una volta un servizio Verify nella Console (Verify → Services → Create new); twilio_list_verify_services mostra il suo sid VA.... twilio_send_verification invia il codice via SMS, chiamata vocale, WhatsApp o email e twilio_check_verification controlla quello che la persona ha digitato (stato approved se è giusto). Ogni verifica riuscita costa circa 0,05 USD più il costo del canale.

Utilizzo e costi: twilio_list_usage_records copre un intervallo di date, twilio_list_usage_records_by_period divide per giorno, mese o anno oppure usa una finestra come ThisMonth. La categoria totalprice è la spesa totale; twilio_get_balance mostra il credito residuo.

Paginazione: le liste restituiscono next_page_uri (null nell'ultima pagina); per la pagina successiva l'AI passa i valori page e page_token che contiene.

Errori comuni: 401 o 20003 significa SID o secret sbagliati, oppure una API key usata con un Account SID a cui non appartiene. 404 o 20404 significa che in questo account non esiste quel messaggio, quella chiamata, quel numero o quel servizio. 21211 è un numero to non valido, 21606 un numero from che non è un numero Twilio di questo account o non può inviare SMS, 21610 un destinatario che ha risposto STOP. 429 o 20429 significa troppe richieste: attendi e riprova.

Il connettore non effettua chiamate, non compra né configura numeri e non gestisce Conversations, Studio, Flex, Voice TwiML e webhook.

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

1. In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
2. Inserisci un Server name (per esempio AnythingMCP), una Server description che dica cosa fa il connettore e il Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server.
3. Come autenticazione scegli API key, imposta Type su Header e come nome dell'header X-API-Key, poi seleziona Create.
4. 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.
5. Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di Twilio.
6. 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

Esempi di prompt

• "Mostrami i messaggi SMS e WhatsApp che abbiamo inviato oggi e segnala quelli non riusciti o non consegnati, con il codice di errore."
• "Quanto abbiamo speso su Twilio questo mese, diviso per categoria, e quanto credito ci resta?"
• "Controlla se +4915112345678 è un numero valido e a quale paese appartiene."
• "Invia un SMS dal nostro numero Twilio a +4915112345678 per dire al cliente che l'ordine 1042 è stato spedito e arriva domani."

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