# Collega gli agenti IA a BroadNet con MCP. - URL canonico: https://www.broadnet.me/it/developers/mcp - Lingua: it - Ultimo aggiornamento: 2026-10-21 - Editore: BroadNet (https://www.broadnet.me) - Versione Markdown della pagina, generata dalla pagina pubblicata. Model Context Protocol· /developers/mcp Il server MCP di BroadNet espone l'API di messaggistica di BroadNet come strumenti che un agente IA può invocare. Punta qualsiasi client MCP che supporti i server remoti verso un unico endpoint, autenticati con il tuo token BroadNet e l'agente potrà inviare e tracciare messaggi sul tuo account. **Endpoint** https://mcp.broadnet.me/mcp **Trasporto** MCP Streamable HTTP **Autenticazione** Authorization: Bearer **Canali** WhatsApp, SMS, RCS, Telegram, Push, e-mail, Messenger, Instagram ## Che cos'è il server MCP Il Model Context Protocol (MCP) è uno standard aperto che permette agli assistenti IA di individuare e invocare strumenti esterni. Il server MCP di BroadNet è un server remoto: il tuo client si collega via HTTPS, elenca gli strumenti disponibili e li invoca per tuo conto. Gli strumenti corrispondono alla stessa API di BroadNet documentata nel riferimento API e nella specifica OpenAPI: invio di messaggi, modelli WhatsApp, report di consegna. L'agente agisce con i permessi del token che gli fornisci, esattamente come farebbe il tuo codice. ## Due server MCP: conoscenza e messaggistica BroadNet gestisce due server MCP. Il server di messaggistica descritto in questa pagina agisce sul tuo account. Il server di conoscenza è pubblico: un agente può interrogarlo su copertura di BroadNet, regole dei Sender ID, tariffe di listino pubblicate, normative e dati aziendali senza login. Server di conoscenza (pubblico) Risposte in sola lettura dagli stessi dati di questo sito. Nessun account, nessun token, nessun dato personale. **Endpoint** https://www.broadnet.me/mcp **Autenticazione** Nessuna **Accesso** Sola lettura **Strumenti** search_site, get_facts, check_coverage, sender_id_rules, estimate_price, count_sms_segments, get_regulation, list_answers, get_answer, list_case_studies, get_case_study, get_changelog, get_status **Limite di richieste** 60 richieste al minuto per IP Server di messaggistica (il tuo account) Invia e traccia i messaggi con i permessi del tuo token BroadNet. **Endpoint** https://mcp.broadnet.me/mcp **Autenticazione** Authorization: Bearer **Accesso** Agisce sul tuo account Prova il server di conoscenza da terminale: prima l'handshake initialize, poi una chiamata a uno strumento. initialize (server di conoscenza) ``` curl -X POST https://www.broadnet.me/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -d '{"jsonrpc":"2.0","id":1,"method":"initialize", "params":{"protocolVersion":"2025-06-18","capabilities":{}, "clientInfo":{"name":"curl","version":"1.0"}}}' ``` tools/call (server di conoscenza) ``` curl -X POST https://www.broadnet.me/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "MCP-Protocol-Version: 2025-06-18" \ -d '{"jsonrpc":"2.0","id":2,"method":"tools/call", "params":{"name":"sender_id_rules","arguments":{"country":"ae"}}}' ``` Il server di conoscenza supporta MCP 2026-07-28 (metadati per richiesta, server/discover) e le revisioni precedenti basate su initialize fino alla 2024-11-05. I prezzi restituiti sono tariffe di listino indicative, non preventivi; le risposte normative sono indicazioni di pianificazione, non consulenza legale. ## Endpoint e autenticazione Esiste un unico endpoint per tutti gli account: https://mcp.broadnet.me/mcp. Ogni richiesta deve includere il tuo token BroadNet in un'intestazione Authorization. Il token si ottiene dal tuo account BroadNet. Nella demo viene generato nel portale BroadAdmin, in Integrations → MCP Integration, con «Get temporary key»; il portale precisa che una chiave permanente viene emessa dall'amministratore del tuo account o dall'account principale. Una richiesta senza l'intestazione viene rifiutata a livello di protocollo: questa è la risposta reale del server a una chiamata initialize non autenticata: risposta senza token ``` event: message data: {"jsonrpc":"2.0","id":1,"error":{"code":-32001, "message":"Authorization bearer token is required. Connect with an 'Authorization: Bearer ' header."}} ``` ## Collegare un client MCP La maggior parte dei client MCP accetta una configurazione JSON con l'URL del server e le intestazioni della richiesta. Una voce tipica è questa: mcp.json ``` { "mcpServers": { "broadnet": { "type": "http", "url": "https://mcp.broadnet.me/mcp", "headers": { "Authorization": "Bearer ${BROADNET_TOKEN}" } } } } ``` I nomi dei campi variano leggermente da un client all'altro (alcuni si aspettano un type "http" o "streamable-http", altri leggono le intestazioni da un'impostazione separata). Consulta la documentazione MCP del tuo client e tieni il token fuori dai file versionati: usa le variabili d'ambiente se il client le supporta. Per provare la connessione senza un client, invia tu stesso la richiesta MCP initialize: handshake initialize ``` curl -X POST https://mcp.broadnet.me/mcp \ -H "Authorization: Bearer $BROADNET_TOKEN" \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -d '{"jsonrpc":"2.0","id":1,"method":"initialize", "params":{"protocolVersion":"2025-06-18","capabilities":{}, "clientInfo":{"name":"curl","version":"1.0"}}}' ``` ## Cosa mostra la demo La registrazione del team di prodotto illustra l'intero flusso in cinque passaggi, con Cursor come client MCP: 1. 1 Accedi Entra nel portale BroadAdmin con il tuo account BroadNet. 2. 2 Ottieni una chiave e la configurazione Apri Integrations → MCP Integration, genera una chiave temporanea e copia la configurazione del client già pronta. 3. 3 Aggiungi il server al client Nel client MCP, aggiungi un nuovo server MCP e incolla la configurazione in mcp.json: URL https://mcp.broadnet.me/mcp con l'intestazione Bearer. 4. 4 Controlla gli strumenti Il client si collega ed elenca gli strumenti BroadNet, ognuno dei quali può essere attivato o disattivato. 5. 5 Chiedi in linguaggio naturale L'utente chiede all'agente di inviare un messaggio WhatsApp a un numero. L'agente sceglie lo strumento di invio WhatsApp, l'API risponde HTTP 200 con il messaggio accettato e il messaggio arriva su WhatsApp dall'account aziendale. Nella registrazione il client riporta 380 strumenti BroadNet, tra cui send_message, post_sms_send, post_whatsapp_message_send, get_whatsapp_template_list, post_whatsapp_template_send, post_rcs_message_send, post_telegram_message_send, post_instagram_message_send, post_messenger_message_send, post_push_message_send e get_report_delivery. L'elenco esatto dipende dalla versione del server e dal tuo account. Una versione commentata della stessa registrazione aggiunge una scheda di panoramica: un solo endpoint MCP, gli stessi passaggi di copia e incolla per ogni agente. Registrazione dimostrativa (1 minuto e 10 secondi, senza audio): accedi a BroadAdmin, connetti Cursor al server BroadNet MCP e invia un messaggio WhatsApp in linguaggio naturale. Versione narrata (1 minuto e 20 secondi, con voce fuori campo) dello stesso flusso, con una schermata di panoramica all'inizio. ## Note di sicurezza - Il token è una credenziale di invio Chiunque lo possieda può inviare messaggi dal tuo account. Conservalo come una password, mai in un file condiviso o versionato. - Per le prove usa chiavi temporanee Usa una chiave temporanea mentre fai prove e chiedi una chiave permanente all'amministratore del tuo account solo per un agente in produzione. - Attiva solo gli strumenti necessari I client MCP consentono di disattivare i singoli strumenti. Un agente che invia solo SMS non ha bisogno degli strumenti per modelli, onboarding o account. - Mantieni una persona nel processo Gli agenti agiscono su istruzioni in linguaggio naturale. Fai chiedere al client una conferma prima degli strumenti che inviano messaggi, soprattutto verso molti destinatari. - Revoca un token compromesso Se un token viene esposto, contatta l'amministratore del tuo account o il supporto BroadNet per revocarlo ed emetterne uno nuovo. ## Approfondimenti [Riferimento API Gli endpoint REST dietro gli strumenti MCP, con autenticazione Bearer.](https://www.broadnet.me/it/developers/api) [Specifica OpenAPI 3.1 La descrizione completa dell'API in formato leggibile dalle macchine.](https://www.broadnet.me/developers/openapi.yaml) [Guida rapida Invia il tuo primo SMS con curl o con l'SDK TypeScript.](https://www.broadnet.me/it/developers/quickstart) [Guida: agenti IA sicuri Come gli agenti inviano SMS e WhatsApp tramite MCP e quali protezioni impostare per prime.](https://www.broadnet.me/it/blog/mcp-server-sms-whatsapp-ai-agents) ## Domande ### Qual è l'URL del server MCP di BroadNet? https://mcp.broadnet.me/mcp. Usa il trasporto MCP Streamable HTTP e richiede un'intestazione Authorization: Bearer con il tuo token BroadNet. ### Quali client IA possono collegarsi? Qualsiasi client MCP in grado di collegarsi a un server remoto via Streamable HTTP e di inviare un'intestazione Authorization personalizzata. La registrazione dimostrativa usa Cursor. ### Dove ottengo il token? Dal tuo account BroadNet. Nel portale BroadAdmin, Integrations → MCP Integration emette una chiave temporanea; una chiave permanente viene fornita dall'amministratore del tuo account o dall'account principale. ### L'agente può inviare messaggi reali? Sì. Nella registrazione della demo, l'invio di WhatsApp da parte dell'agente restituisce HTTP 200 e il messaggio arriva sul telefono. Gli strumenti operano con le autorizzazioni del tuo token, esattamente come farebbero le tue chiamate API, quindi considera ogni invio come reale: abilita solo gli strumenti necessari all'agente e richiedi una conferma per gli invii. ## Sviluppa con BroadNet Ottieni un account e un token, poi collega il tuo agente o chiama direttamente l'API. [Contattaci](https://www.broadnet.me/it/contact) [Area sviluppatori](https://www.broadnet.me/it/developers)