Server MCP per WhatsApp: collegare agenti IA a WhatsApp e SMS
Come un server MCP per WhatsApp permette a Claude, Cursor e altri agenti IA di inviare WhatsApp e SMS in sicurezza: setup, guardrail, consenso e casi d'uso.
Di OmniChannels.ai Editorial Team · Revisione di BroadNet Messaging Solutions Team
Integrazione
Risposta breve
Un server MCP per WhatsApp espone le operazioni di messaggistica come strumenti che un agente IA può scoprire e richiamare tramite il Model Context Protocol. Con il server MCP di OmniChannels.ai su https://mcp.broadnet.me/mcp, un client come Claude Code o Cursor si autentica con un Bearer token e può inviare messaggi SMS e WhatsApp, elencare i template e leggere i rapporti di consegna. L'agente agisce con i permessi del vostro account, quindi i guardrail sono fondamentali.
In questa pagina
- Che cos'è un server MCP per WhatsApp?
- Come funziona il server MCP di OmniChannels.ai?
- Come collego Claude, Cursor o un altro client?
- Cosa può fare un agente IA con WhatsApp e SMS?
- Come evito che un agente IA scriva alle persone sbagliate?
- Quali regole di WhatsApp e SMS valgono ancora?
- Esempio pratico: un team di assistenza aggiunge un assistente per lo stato di consegna
- Quando MCP è la scelta sbagliata?
- Come vi aiuta OmniChannels.ai
Punti chiave
- MCP (Model Context Protocol) è uno standard aperto che permette a un client IA di elencare e richiamare strumenti su un server remoto; il server di OmniChannels.ai associa i propri strumenti alla stessa API REST che userebbe il vostro codice.
- Un solo endpoint, https://mcp.broadnet.me/mcp su Streamable HTTP, e un solo header, Authorization: Bearer <token>, collegano Claude Code, Cursor, VS Code, Claude Desktop e altri client.
- Un agente con strumenti di invio può scrivere a persone reali e spendere credito reale, quindi abilitate solo gli strumenti che gli servono e richiedete la conferma di una persona prima di ogni invio.
- Le regole di WhatsApp valgono anche per gli agenti: opt-in, template approvati fuori dalla finestra di assistenza clienti e regole sui Sender ID per gli SMS.
- Usate una chiave temporanea mentre sperimentate e una chiave permanente solo per un agente di produzione rivisto.
Questa guida è per sviluppatori e responsabili tecnici che vogliono che un agente IA invii o tracci messaggi WhatsApp e SMS senza scrivere a mano ogni integrazione. Spiega che cos'è un server MCP per WhatsApp, come collegarne uno, quali guardrail impostare prima che l'agente tocchi clienti reali e dove MCP è lo strumento sbagliato.
Che cos'è un server MCP per WhatsApp?
Un server MCP per WhatsApp è un servizio che espone le operazioni di messaggistica, come l'invio di un template o la lettura di un rapporto di consegna, come strumenti che un client IA può scoprire e richiamare. Parla il Model Context Protocol (MCP), uno standard aperto per collegare gli assistenti IA a strumenti e dati esterni.
Senza MCP, dare a un assistente la capacità di inviare un messaggio significa scrivere una funzione personalizzata per ogni modello o framework. Con MCP il client si collega a un solo URL, chiede al server quali strumenti esistono e li richiama quando la richiesta di un utente ne ha bisogno. La nostra voce del glossario sui server MCP ne dà la definizione breve.
Due punti sfuggono facilmente:
- MCP non aggira le regole di WhatsApp. Il server richiama le stesse operazioni della WhatsApp Business Platform di qualsiasi altra integrazione, quindi template, opt-in e finestra di assistenza clienti valgono comunque.
- L'agente è sicuro quanto il suo token. Gli strumenti agiscono con i permessi, i Sender ID e il credito della chiave che fornite.
Come funziona il server MCP di OmniChannels.ai?
È un server MCP remoto su un unico endpoint, autenticato con un Bearer token. I suoi strumenti corrispondono alla stessa API REST documentata nella documentazione per sviluppatori, quindi ciò che un agente può fare è ciò che potrebbe fare il vostro codice con quel token.
| Impostazione | Valore |
|---|---|
| Endpoint | https://mcp.broadnet.me/mcp |
| Trasporto | MCP Streamable HTTP |
| Autenticazione | Authorization: Bearer <token> a ogni richiesta |
| Agisce su | Il vostro account: canali, Sender ID, template e credito |
| Aree di strumenti tipiche | Invio su ogni canale (SMS, WhatsApp, RCS, Telegram, Messenger, Instagram, Push), elenco e invio di template WhatsApp, lettura dei rapporti di consegna |
L'elenco esatto degli strumenti dipende dalla versione del server e dal vostro account, quindi leggetelo dal vostro client invece che da un articolo. Una richiesta senza token viene rifiutata a livello di protocollo, il che è un utile smoke test.
Come collego Claude, Cursor o un altro client?
Aggiungete endpoint e header alla configurazione MCP del client e tenete il token in una variabile d'ambiente o in un input segreto, così non finisce mai in un repository.
Collegamento in cinque passaggi
- Ottenete una chiave. Nel portale di amministrazione aprite Integrazioni, poi Integrazione MCP, e scegliete Ottieni chiave temporanea. Una chiave permanente per un agente di produzione viene dall'amministratore dell'account o dall'account master.
- Conservatela come segreto. Ad esempio esportatela come
BROADNET_TOKENnella vostra shell. - Aggiungete il server al client. Per Claude Code:
claude mcp add --transport http omnichannels https://mcp.broadnet.me/mcp \
--header "Authorization: Bearer $BROADNET_TOKEN"
- Controllate gli strumenti. In Claude Code il comando
/mcpmostra il server e i suoi strumenti. In Cursor, VS Code e Claude Desktop la configurazione si trova nel file di impostazioni MCP del client. - Disattivate ciò che l'agente non usa, prima del primo prompt reale.
I formati dei client cambiano tra le versioni, quindi gli snippet esatti per Cursor, VS Code e Claude Desktop sono nella documentazione, con pagine passo passo per Claude Code, Cursor e n8n. La documentazione MCP di Claude Code è il riferimento per i suoi comandi.
Per testare senza alcun client, inviate la richiesta MCP initialize all'endpoint con il vostro token. La documentazione mostra il comando curl completo.
Cosa può fare un agente IA con WhatsApp e SMS?
Tutto ciò che gli strumenti collegati consentono: inviare, consultare e riportare. Il valore pratico sta nei compiti flessibili, in linguaggio naturale, attorno alla messaggistica, più che nei flussi ad alto volume che conviene tenere nel codice.
Esempi di prompt adatti a un agente:
- «Invia un SMS da OmniDemo a 447700900123 per dire che il tecnico arriva alle 15.»
- «Elenca i miei template WhatsApp approvati in arabo.»
- «Invia il template WhatsApp
order_updatea 971500000000 con numero d'ordine INV-400.» - «Quanti messaggi della campagna degli estratti conto di ieri sono falliti e perché?»
- «Prepara una bozza di card RCS per il nostro lancio autunnale e mostramela prima di inviare qualsiasi cosa.»
Buoni casi d'uso, in ordine approssimativo di sicurezza:
| Caso d'uso | Strumenti necessari | Rischio |
|---|---|---|
| Domande sulla consegna del personale di assistenza («questo cliente ha ricevuto l'SMS?») | Strumenti di sola lettura dei report | Basso |
| Assistente per sviluppatori che invia messaggi di prova ai vostri numeri mentre costruite un'integrazione | Strumenti di invio, solo numeri di prova | Da basso a medio |
| Consultazione dei template e bozze di testi da rivedere | Strumenti di elenco dei template | Basso |
| Assistente operativo che invia avvisi singoli dopo l'approvazione di una persona | Strumenti di invio più conferma | Medio |
| Agente autonomo che scrive ai clienti | Strumenti di invio, senza conferma | Alto; richiede un progetto rivisto |
Un assistente interno che risponde a domande sulla consegna non ha bisogno di alcuno strumento di invio. Rimuoveteli.
Come evito che un agente IA scriva alle persone sbagliate?
Trattate l'agente come un nuovo collaboratore con un telefono aziendale: permessi limitati, supervisione all'inizio e un registro di ciò che ha fatto. La documentazione elenca le misure di sicurezza; eccole con il ragionamento.
- Privilegio minimo. Abilitate solo gli strumenti che il compito richiede. Un agente che risponde a domande sulla consegna non ha bisogno di strumenti di invio; uno che invia OTP non ha bisogno di strumenti per template o account.
- Una persona nel ciclo. Configurate il client per chiedere conferma prima di ogni strumento che invia, e sempre prima degli invii a molti destinatari. In Claude Code le regole di permesso indicano gli strumenti MCP come
mcp__<server>__<tool>, così potete lasciare che gli strumenti di lettura girino liberamente mentre quelli di invio chiedono comunque conferma. - Chiavi temporanee per gli esperimenti. Usate una chiave temporanea durante i test e una chiave permanente solo per un agente di produzione rivisto.
- Prima numeri di prova. Puntate i nuovi agenti ai vostri numeri verificati finché non vi fidate del loro comportamento.
- Guardate i log. Rivedete nei rapporti di consegna ciò che l'agente ha inviato, soprattutto nelle prime settimane.
- Revocate subito. Se una chiave è esposta, chiedete all'amministratore dell'account o al nostro supporto di revocarla e rilasciarne una nuova.
- Rispettate il consenso. Gli agenti devono seguire le stesse regole di opt-in, Sender ID e canale di qualsiasi altro mittente.
La prompt injection merita una menzione speciale. Se un agente legge testo non attendibile, come un messaggio in arrivo da un cliente o una pagina web, quel testo può contenere istruzioni. Non date a un agente che legge contenuti non attendibili un accesso non supervisionato agli strumenti di invio. Tenete separati lettura e invio, con una persona che approva l'invio.
Quali regole di WhatsApp e SMS valgono ancora?
Tutte. L'agente è solo un altro mittente.
- Opt-in. La WhatsApp Business Messaging Policy di Meta richiede che le persone abbiano dato l'opt-in a ricevere vostre comunicazioni. Un agente che può scrivere a chiunque sia in un foglio di calcolo non cambia questo.
- Template e finestra. I messaggi WhatsApp liberi sono possibili solo dentro la finestra di assistenza clienti; fuori serve un template approvato. Vedi la nostra guida alla finestra di assistenza clienti di 24 ore e la documentazione dell'API WhatsApp.
- Costi. Meta addebita ogni messaggio consegnato in base alla categoria e un agente può generare volume in fretta. Fissate un tetto a ciò che può inviare e simulate i costi con il nostro calcolatore dei prezzi WhatsApp.
- Sender ID degli SMS. In molti paesi gli SMS richiedono un Sender ID registrato. L'agente usa i Sender ID approvati sul vostro account.
Esempio pratico: un team di assistenza aggiunge un assistente per lo stato di consegna
«Souq Rafiq» (nome di fantasia), un rivenditore online degli Emirati, vuole che il proprio personale di assistenza risponda a «il cliente ha ricevuto il nostro messaggio?» senza aprire dashboard.
- Configurazione: un amministratore genera una chiave temporanea e collega Claude Desktop al server MCP per due responsabili dell'assistenza.
- Strumenti: sono abilitati solo gli strumenti di lettura dei report. Gli strumenti di invio sono disattivati.
- Uso: un responsabile chiede: «Quanti messaggi della campagna degli estratti conto di ieri sono falliti e perché?» L'agente legge il rapporto di consegna e riassume i motivi per stato.
- Verifica: dopo due settimane l'amministratore controlla i rapporti di consegna, conferma che non è stato inviato nulla e richiede una chiave permanente per un piccolo assistente di produzione.
- Passo successivo: per consentire all'assistente di reinviare un avviso mancato, il team abilita uno strumento di invio con la conferma attiva e lo limita prima a un gruppo di numeri di prova.
Quando MCP è la scelta sbagliata?
Usate l'API REST, la specifica OpenAPI o l'SDK per tutto ciò che è deterministico e ad alto volume.
- OTP e flussi transazionali. Un codice di accesso deve venire da codice che controllate, non da un modello che potrebbe parafrasarlo. Vedi il quickstart REST.
- Campagne massive. Usate gli strumenti di campagna o gli endpoint bulk con un file rivisto, non un prompt conversazionale.
- Chat con i clienti senza supervisione. Un agente rivolto ai clienti richiede un flusso conversazionale progettato, conoscenza, passaggio a operatori umani e monitoraggio. È un prodotto di agente IA, non una sessione MCP di uno sviluppatore.
- Limiti di questa guida. I formati di configurazione dei client e l'elenco degli strumenti cambiano tra le versioni. Confermate entrambi nella documentazione e nel vostro client.
Come vi aiuta OmniChannels.ai
OmniChannels.ai fornisce il server MCP su https://mcp.broadnet.me/mcp accanto all'API REST su https://api.broadnet.me, con un unico modello di Bearer token per SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, Email e Push. BroadNet è un Meta Business Solution Provider ufficiale e il suo prodotto di agenti IA supporta inglese e arabo, con passaggio a un operatore umano e uso di strumenti tramite MCP; vedi gli agenti IA. L'accesso di prova è limitato ai vostri numeri verificati. Partite dalla guida MCP e dalla panoramica per sviluppatori.
Domande frequenti
Che cos'è un server MCP?
Un server MCP è un programma che offre strumenti ai client IA tramite il Model Context Protocol, uno standard aperto. Il client si collega, elenca gli strumenti e li richiama quando la richiesta di un utente ne ha bisogno. Un server MCP remoto gira sull'infrastruttura del provider, quindi vi collegate a un URL e vi autenticate invece di installare codice.
Claude può inviare messaggi WhatsApp?
Claude da solo non raggiunge WhatsApp, ma un client Claude che supporta MCP può richiamare gli strumenti di un server MCP di messaggistica. Con il server MCP di OmniChannels.ai collegato, Claude Code o Claude Desktop possono inviare dal vostro account un template WhatsApp approvato o un SMS, nel rispetto delle impostazioni degli strumenti e delle regole di Meta.
È sicuro lasciare che un agente IA invii messaggi?
È sicuro solo con i guardrail. Abilitate il minimo insieme di strumenti, richiedete la conferma di una persona per gli invii, testate prima sui vostri numeri verificati, usate chiavi temporanee mentre sperimentate e rivedete i rapporti di consegna. L'agente agisce con i permessi del vostro token, quindi può spendere credito e raggiungere persone reali se glielo consentite.
Serve un template WhatsApp perché un agente scriva a qualcuno?
Sì, fuori dalla finestra di assistenza clienti. Meta consente messaggi liberi solo finché è attiva una finestra aperta dal cliente; altrimenti l'azienda deve inviare un template approvato. Un agente può elencare i vostri template approvati e inviarne uno per nome, ma non può inventare sul momento un nuovo template approvato.
Il server MCP sostituisce l'API REST?
No. Gli strumenti corrispondono alla stessa API REST, con lo stesso token e gli stessi permessi. Usate MCP quando un client IA deve scoprire e richiamare da sé le operazioni, e usate l'API REST, la specifica OpenAPI o l'SDK per il codice di produzione deterministico, come i flussi OTP e le notifiche degli ordini.
Come ottengo una chiave MCP?
Accedete al portale di amministrazione, aprite Integrazioni, poi Integrazione MCP, e scegliete Ottieni chiave temporanea. Una chiave permanente per un agente di produzione viene rilasciata dall'amministratore dell'account o dall'account master. L'accesso di prova è limitato ai vostri numeri verificati e non esiste una registrazione self-service immediata.
Fonti
Continuate a leggere
Altre guideIntegrazione
Inviare un messaggio WhatsApp via API: cURL, Node, Python, PHP
Come inviare un messaggio WhatsApp con una API: esempi in cURL, Node.js, Python e PHP per template e messaggi di sessione, con stati ed errori.
10 min di lettura
Integrazione
Guida ai webhook WhatsApp: eventi, sicurezza e nuovi tentativi
Come funzionano i webhook WhatsApp: eventi di messaggi e stati, gestore affidabile, firma di Meta, nuovi tentativi, idempotenza e recupero degli eventi persi.
10 min di lettura
Assistenza clienti
Agente IA su WhatsApp per l'assistenza clienti: progetto e regole
Come progettare un agente IA su WhatsApp per l'assistenza clienti: conoscenza, guardrail, passaggio a un operatore, arabo e inglese e termini Meta 2026.
10 min di lettura
