Vai al contenuto
OmniChannels.ai

Assistenti e agenti IA

Cursor + OmniChannels.ai: inviate e monitorate i messaggi mentre sviluppate

Collegamento tramite MCPCollegamento tramite API e webhookAggiornato

In breve

Cursor si collega a OmniChannels.ai tramite il nostro server MCP remoto all'indirizzo https://mcp.broadnet.me/mcp. Aggiungetelo a .cursor/mcp.json con il vostro token in un'intestazione Authorization letta da una variabile d'ambiente. L'agente di Cursor potrà quindi inviare messaggi WhatsApp, SMS e RCS, elencare i template approvati e leggere i rapporti di consegna, chiedendo approvazione prima di ogni chiamata a uno strumento. Non serve alcuna estensione.

Cosa potete fare

  • Inviate messaggi di prova mentre scrivete codice

    Verificate un flusso di messaggi end to end senza uscire dall'editor, inviando solo ai vostri numeri verificati.

    Provate a chiedere

    “Invia un messaggio WhatsApp a 971500000000 per dire che l'ordine è stato spedito.”

  • Cercate nomi e variabili dei template

    L'agente elenca i template WhatsApp approvati, così il codice che scrivete usa nomi e parametri esatti.

    Provate a chiedere

    “Elenca i miei template WhatsApp approvati in arabo e mostra le variabili richieste da ciascuno.”

  • Analizzate i problemi di consegna

    Leggete il rapporto di consegna di un messaggio appena inviato dal vostro codice e scoprite perché è fallito.

    Provate a chiedere

    “Controlla il rapporto di consegna dell'ultimo messaggio che ho inviato e spiega l'eventuale errore.”

  • Scrivete il codice di integrazione dalla specifica

    Date all'agente la nostra specifica OpenAPI, così le chiamate REST che scrive usano i campi esatti, compresi gli invii multipart.

    Provate a chiedere

    “Usando la specifica OpenAPI, scrivi una funzione TypeScript che invii una campagna di SMS massivi.”

Come si collega

Collegamento tramite MCPCollegamento tramite API e webhook

OmniChannels.ai gestisce un server MCP remoto su Streamable HTTP. Cursor legge i server MCP da .cursor/mcp.json in un progetto o da ~/.cursor/mcp.json per tutti i progetti, e risolve ${env:NAME} nei campi url e headers, così il token può restare in una variabile d'ambiente invece che nel file.

Una volta collegato, Cursor elenca gli strumenti del server nelle impostazioni MCP, dove potete attivare o disattivare ciascuno di essi. Per impostazione predefinita Cursor chiede approvazione prima di eseguire uno strumento MCP e mostra prima gli argomenti. Mantenete l'approvazione attiva per ogni strumento che invia, perché ogni invio è un messaggio reale e addebitato.

  • Endpoint: https://mcp.broadnet.me/mcp (Streamable HTTP)
  • Intestazione: Authorization: Bearer ${env:BROADNET_TOKEN}
  • Configurazione: .cursor/mcp.json (progetto) o ~/.cursor/mcp.json (globale)
  • Diagnosi nel pannello Output, sotto MCP Logs

Configurazione

  1. 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. 2

    Ottenete una chiave MCP

    Nel portale di amministrazione aprite Integrations, poi MCP Integration, e scegliete Get temporary key.

    Guida: MCP server for AI agents
  3. 3

    Aggiungete il server a mcp.json

    Aggiungete una voce omnichannels sotto mcpServers con il nostro URL e un'intestazione Authorization che legge ${env:BROADNET_TOKEN}.

    Guida: Use the MCP server with Cursor
  4. 4

    Impostate la variabile e riavviate

    Impostate BROADNET_TOKEN nell'ambiente da cui parte Cursor, ad esempio il profilo della vostra shell, poi riavviate Cursor.

  5. 5

    Controllate gli strumenti

    Nelle impostazioni MCP di Cursor, disattivate ogni strumento non necessario all'agente e mantenete l'approvazione attiva per gli strumenti di invio.

  6. 6

    Inviate il primo messaggio

    Chiedete all'agente di inviare un messaggio di prova al vostro numero verificato, approvate la chiamata, poi controllate il rapporto di consegna.

Documentazione del fornitore

Cursor è un marchio del rispettivo proprietario. OmniChannels.ai non è affiliata a Cursor né da essa approvata; questa pagina descrive un collegamento realizzato con le funzioni MCP, HTTP o webhook di Cursor.

Flusso di lavoro di esempio

Come una richiesta tipica passa da Cursor al vostro cliente e ritorna.

  1. 01

    Agente Cursor

    Una richiesta nella chat dell'agente

  2. 02

    Server MCP OmniChannels.ai

    Lo strumento viene eseguito dopo la vostra approvazione

  3. 03

    Il vostro telefono di prova

    Messaggio WhatsApp, SMS o RCS consegnato

  4. 04

    Rapporto di consegna

    L'agente rilegge lo stato con uno strumento di lettura

1. Agente Cursor: Una richiesta nella chat dell'agente 2. Server MCP OmniChannels.ai: Lo strumento viene eseguito dopo la vostra approvazione 3. Il vostro telefono di prova: Messaggio WhatsApp, SMS o RCS consegnato 4. Rapporto di consegna: L'agente rilegge lo stato con uno strumento di lettura

Domande

Esiste un'estensione ufficiale OmniChannels.ai per Cursor?

No. Cursor si collega tramite il suo supporto MCP standard, usando il nostro endpoint MCP pubblico e il vostro token API in .cursor/mcp.json. Non c'è nulla da installare.

Posso committare .cursor/mcp.json nel mio repository?

Sì, se il token viene letto da una variabile d'ambiente con ${env:BROADNET_TOKEN}. La configurazione già pronta del portale contiene la chiave stessa, quindi tenete quella versione fuori dal controllo di versione.

Il server mostra un errore o nessuno strumento. Cosa devo controllare?

Aprite il pannello Output e scegliete MCP Logs. Un errore di autorizzazione indica che l'intestazione manca o che la chiave è errata o scaduta. Una variabile vuota significa che Cursor è stato avviato senza BROADNET_TOKEN impostato.

Su quali canali può inviare l'agente?

Gli strumenti coprono l'invio su ogni canale abilitato sul vostro account, ad esempio SMS, WhatsApp, RCS, Telegram, Messenger, Instagram e notifiche push. L'elenco esatto degli strumenti dipende dalla versione del server e dal vostro account.

Richiedi l’accesso a API e MCP

Indicateci canali, Paesi e caso d’uso. Un tecnico emette le credenziali di test e verifica i vostri numeri di prova.