Come collegare Twilio a Cursor 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 + Cursor

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 Cursor

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.

Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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 Cursor.
3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
4. Inizia a chattare: l'agente ora può usare i tool di Twilio.

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

Cursor supporta server MCP personalizzati nel piano gratuito? Sì, MCP è disponibile nei piani Hobby, Pro e Business.

Prossimi passi

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