In breve
Claude Code si collega a OmniChannels.ai con un solo comando: claude mcp add --transport http verso https://mcp.broadnet.me/mcp con un'intestazione Authorization: Bearer. Potrà così inviare messaggi di prova, elencare i template WhatsApp e leggere i rapporti di consegna mentre scrive il codice di integrazione a partire dalla nostra specifica OpenAPI 3.1. I team condividono il server in .mcp.json e le regole di permesso stabiliscono quali strumenti vengono eseguiti senza conferma.
Cosa potete fare
Scrivete codice a partire dai template reali
Claude Code legge i vostri template WhatsApp approvati tramite MCP e scrive una funzione con esattamente le variabili richieste da ciascuno.
Provate a chiedere
“Usa gli strumenti omnichannels per elencare i miei template WhatsApp approvati, poi scrivi una funzione TypeScript che invii order_update con i campi necessari.”
Create un gestore di webhook
Indicate a Claude Code la guida ai webhook e scriverà un endpoint che memorizza gli stati di consegna e i messaggi in entrata, tollerando i campi che variano da un canale all'altro.
Provate a chiedere
“Scrivi un gestore webhook Express che registri per ID messaggio gli stati SUBMITTED, SENT, DELIVERED, READ, FAILED e REJECTED e registri nel log i campi sconosciuti invece di generare un errore.”
Generate un client tipizzato dalla specifica
Con la specifica OpenAPI salvata nel vostro repository, Claude Code usa percorsi e campi esatti invece di indovinarli.
Provate a chiedere
“Usando docs/omnichannels-openapi.yaml, scrivi un modulo Python che invii un SMS con POST /sms/sendSms ed elenca ogni campo usato con il suo tipo preso dalla specifica.”
Testate end to end sul vostro numero
Claude Code invia un messaggio di prova dopo la vostra approvazione della chiamata allo strumento, poi controlla il rapporto di consegna per confermare che il percorso del vostro codice funzioni.
Provate a chiedere
“Invia un SMS di prova da OmniDemo al mio numero 447700900123, poi controlla il suo rapporto di consegna.”
Analizzate gli invii falliti
Gli strumenti di lettura permettono a Claude Code di confrontare i rapporti di consegna con i vostri log e di risalire da un errore alla richiesta che lo ha causato.
Provate a chiedere
“Leggi il rapporto di consegna della campagna di ieri, riassumi i motivi dei fallimenti e confronta il nostro codice di nuovo tentativo con la guida agli errori.”
Come si collega
Claude Code aggiunge i server MCP remoti con claude mcp add --transport http e un'intestazione Authorization. La vostra shell espande il token da una variabile d'ambiente quando eseguite il comando; per un team, un file .mcp.json a livello di progetto permette a ogni sviluppatore di fornire il proprio token tramite ${BROADNET_TOKEN}, e Claude Code chiede a ciascuno di approvare il server prima di usarlo.
MCP serve per agire sul vostro account: inviare messaggi di prova, leggere template e rapporti di consegna. Per scrivere il codice di integrazione, date a Claude Code la nostra specifica OpenAPI 3.1 come fonte di riferimento per endpoint e campi, insieme alla guida ai webhook, perché i payload dei webhook non sono nella specifica. Regole di permesso come mcp__omnichannels__get_* consentono agli strumenti di lettura di funzionare senza conferma, mentre gli strumenti di invio la richiedono ancora.
- Comando: claude mcp add --transport http omnichannels https://mcp.broadnet.me/mcp
- Configurazione di team: committate .mcp.json con Bearer ${BROADNET_TOKEN}, mai una chiave
- Le regole di permesso indicano gli strumenti come mcp__omnichannels__<strumento>
- Specifica OpenAPI 3.1 su /developers/openapi.json per i campi esatti delle richieste
- L'SMS singolo usa JSON; gli invii massivi e la maggior parte degli altri canali usano multipart/form-data
Configurazione
- 1
Richiedete l'accesso API
Richiedete l'accesso di prova e ricevete un token API. Gli invii di prova arrivano solo ai vostri numeri verificati.
- 2
Ottenete una chiave temporanea
Nel portale di amministrazione aprite Integrations, poi MCP Integration, scegliete Get temporary key ed esportatela come BROADNET_TOKEN.
Guida: MCP server for AI agents - 3
Aggiungete il server
Eseguite claude mcp add --transport http omnichannels https://mcp.broadnet.me/mcp con l'intestazione Authorization, oppure committate un .mcp.json di progetto per il vostro team, poi verificatelo con /mcp.
Guida: Use the MCP server with Claude Code - 4
Impostate le regole di permesso
Consentite gli strumenti di lettura come mcp__omnichannels__get_* se lo desiderate, lasciate ogni strumento di invio con richiesta di conferma e negate gli strumenti che il progetto non richiede.
Guida: Use the MCP server with Claude Code - 5
Aggiungete la specifica OpenAPI
Scaricate openapi.yaml nel vostro repository e indicate a Claude Code di usarlo per percorsi degli endpoint, campi ed enum.
Guida: OpenAPI 3.1 spec - 6
Fate una prova sul vostro numero
Chiedete a Claude Code di inviare un messaggio di prova al vostro numero verificato, poi rileggete il rapporto di consegna.
Documentazione del fornitore
Claude Code è un marchio del rispettivo proprietario. OmniChannels.ai non è affiliata a Claude Code né da essa approvata; questa pagina descrive un collegamento realizzato con le funzioni MCP, HTTP o webhook di Claude Code.
