WhatsApp in qualsiasi client MCP: Gemini CLI, VS Code, Cursor, Devin Desktop (Windsurf) e altri
Ogni client MCP che supporta server remoti su Streamable HTTP con OAuth può funzionare con un numero WhatsApp Business: aggiungi l'URL del server, accedi una volta nel browser e compaiono gli strumenti WhatsApp. Cambia solo la configurazione. Cursor e Zed usano url, Gemini CLI usa httpUrl, Antigravity usa serverUrl, e VS Code e Cline richiedono che il transport sia impostato su HTTP.
easyCoexistence gestisce un unico server MCP remoto, https://easycoexistence.com/api/mcp, con accesso OAuth e più di 30 strumenti per i numeri WhatsApp Business che colleghi tramite Coexistence: stato, messaggi, template, instradamento e automazioni, da qualsiasi client che supporta Streamable HTTP.
La chiave delle impostazioni di Gemini CLI per un server Streamable HTTP; url, lì, indica un endpoint SSE.
La chiave di Antigravity per un server remoto; url funziona anche, mentre httpUrl e il transport SSE legacy non sono supportati.
Quando Gemini CLI è stato sostituito da Antigravity CLI per gli utenti del piano gratuito e di Google One.
Il tipo da impostare per un server remoto in Cline; se omesso, Cline usa come predefinito il transport SSE legacy.
Il nuovo nome di Windsurf; le sue FAQ dicono che cambiano solo il nome e il marchio.
Il server MCP di easyCoexistence usa Streamable HTTP in modalità stateless e non apre alcuno stream SSE.
Di cosa ha bisogno un client per connettersi a un server MCP WhatsApp remoto?
Tre cose, e la maggior parte dei client attuali le ha tutte. Streamable HTTP, il transport MCP in cui il client invia POST a un unico URL; il server qui lo esegue in modalità stateless e non apre alcuno stream SSE, quindi un client impostato su SSE fallisce. OAuth discovery: alla prima chiamata il server risponde con 401 e un rimando ai suoi metadati, il client si registra tramite dynamic client registration e apre il browser, e l'accesso usa PKCE. E serve un browser sulla macchina dove gira il client.
Nella configurazione non va nessuna intestazione, nessuna chiave API né token. Il server accetta le versioni del protocollo 2025-06-18, 2025-03-26 e 2024-11-05, e un client che supporta solo server locali avviati sulla tua macchina non può raggiungerlo.
Quale configurazione usa ciascun client?
Ognuna di queste è stata verificata nella documentazione del client l'11 novembre 2026. Lo schema è lo stesso ovunque, un nome e l'URL https://easycoexistence.com/api/mcp, ma la chiave che contiene l'URL e il punto in cui sta la voce cambiano, e in alcuni client una chiave sbagliata fallisce in silenzio. Ogni voce richiede solo un nome e l'URL, senza intestazioni né token:
Come sono i file di configurazione?
Queste sono le voci per i client che tengono i server in un file, come mostrato nella loro documentazione. Incolla quella del tuo client nel file indicato sopra, unendola agli eventuali server già presenti, poi ricarica il client e completa l'accesso che apre. Dove un client offre anche un comando o un modulo, quel percorso scrive la stessa voce per te:
// Cursor: ~/.cursor/mcp.json
{ "mcpServers": { "easycoexistence": { "url": "https://easycoexistence.com/api/mcp" } } }
// VS Code with Copilot: ~/.copilot/mcp-config.json
{ "mcpServers": { "easycoexistence": { "type": "http", "url": "https://easycoexistence.com/api/mcp" } } }
// Gemini CLI: ~/.gemini/settings.json
{ "mcpServers": { "easycoexistence": { "httpUrl": "https://easycoexistence.com/api/mcp" } } }
// Antigravity: ~/.gemini/config/mcp_config.json
{ "mcpServers": { "easycoexistence": { "serverUrl": "https://easycoexistence.com/api/mcp" } } }
// Zed: settings.json
{ "context_servers": { "easycoexistence": { "url": "https://easycoexistence.com/api/mcp" } } }
// Cline: cline_mcp_settings.json
{ "mcpServers": { "easycoexistence": { "type": "streamableHttp", "url": "https://easycoexistence.com/api/mcp" } } }Come lo aggiungi in VS Code?
Con Copilot selezionato, esegui Chat: Open Customizations, scegli MCP Servers e seleziona Add Server (+) nel gruppo User, oppure esegui MCP: Add Server dalla Command Palette per lo stesso flusso guidato. Scegli HTTP (HTTP or Server-Sent Events), incolla l'URL, inserisci easycoexistence come server ID, poi scegli Global e Copilot Global per una configurazione personale condivisa tra i tuoi workspace su quella macchina. Completa l'autorizzazione quando VS Code la richiede.
La documentazione Microsoft chiama il vecchio file .vscode/mcp.json, con la chiave servers, il formato deprecato gestito dall'editor, e indirizza le nuove configurazioni ai file di Copilot. Un file .mcp.json nella radice del workspace condivide un server con i colleghi; poiché la voce non contiene segreti, può essere sottoposto a commit in sicurezza.
Come lo aggiungi in Gemini CLI e Antigravity?
In Gemini CLI, esegui gemini mcp add --transport http easycoexistence https://easycoexistence.com/api/mcp -s user. Senza -s user il server viene salvato nel progetto, in .gemini/settings.json. Poi esegui /mcp auth easycoexistence per accedere; lo stesso comando accede di nuovo quando i token scadono. Google segnala che Gemini CLI è stato sostituito da Antigravity CLI il 18 giugno 2026 per gli utenti del piano gratuito e di Google One.
In Antigravity, inserisci la voce con serverUrl in ~/.gemini/config/mcp_config.json per ogni progetto, oppure in .agents/mcp_config.json per un solo workspace. Nella CLI, /mcp apre l'MCP Manager con lo stato di ciascun server; nell'IDE, seleziona … nel pannello dell'agente, poi MCP Servers, Manage MCP Servers e View raw config. Poiché questo server supporta dynamic client registration, non serve alcun client ID.
Come lo aggiungi in Zed, Cline e Devin?
In Zed, apri Impostazioni > AI > MCP Servers, clicca su Add Server e scegli Add Remote Server; senza un'intestazione Authorization nella voce, Zed esegue il flusso OAuth standard di MCP. In Cline, apri l'icona MCP Servers, poi la scheda Remote Servers, inserisci un nome e l'URL, scegli Streamable HTTP e clicca su Add Server; dalla CLI di Cline, usa cline mcp add easycoexistence con l'URL e --transport http, poi l'azione Authorize OAuth della procedura guidata.
Devin Desktop, il nuovo nome di Windsurf, gestisce i server in Customize > MCPs nella finestra Agents e li conserva in ~/.config/devin/mcp_config.json o nella cartella .devin del progetto; quando le credenziali salvate scadono, il server mostra Needs authentication e Authenticate accede di nuovo. Nella CLI di Devin, esegui devin mcp add easycoexistence con l'URL e -s user, poiché l'ambito predefinito è quello locale, poi devin mcp login easycoexistence.
Cosa funziona allo stesso modo in ogni client?
Tutto ciò che sta dietro l'URL. Ogni client accede allo stesso account easyCoexistence, vede gli stessi numeri tramite list_numbers e ottiene gli stessi più di 30 strumenti. Con essi arrivano le regole di Meta: un testo libero raggiunge solo chi ha scritto nelle ultime 24 ore, i template partono solo tramite l'API, e un numero Coexistence invia al massimo 20 messaggi al secondo. Gli strumenti di invio richiedono un piano attivo in ogni client, mentre gli strumenti di lettura continuano a funzionare.
Ciò che cambia è il controllo che il client esercita sulle chiamate agli strumenti, come Cursor che, per impostazione predefinita, chiede l'approvazione prima di usare uno strumento MCP. Il server invia l'elenco degli strumenti quando un client si connette e non segnala le modifiche, quindi ricarica o riconnetti il client dopo che il tuo account ottiene una nuova funzione.
Come configurarlo
- Connect your numberSign up at easycoexistence.com and connect the number through Meta's Embedded Signup; the WhatsApp Business app keeps working on the phone.
- Add the serverUse your client's command or form, or paste its entry into the right file, with https://easycoexistence.com/api/mcp as the URL.
- Reload and sign inReload the client, then approve the browser sign-in it opens with your easyCoexistence account.
- Try a requestAsk "Which WhatsApp numbers do I have, and are they healthy?" and check that the client calls list_numbers.
Errori comuni
- Scrivere url nel settings.json di Gemini CLI. Lì indica un endpoint SSE, che questo server non apre; usa httpUrl, oppure gemini mcp add --transport http.
- Omettere type in una voce di Cline. Cline allora usa il transport SSE legacy e la connessione fallisce, quindi imposta type su streamableHttp.
- Aggiungere il server in Gemini CLI o nella CLI di Devin senza un ambito, e poi non trovarlo in un'altra cartella. Gemini usa come predefinito l'ambito di progetto e Devin quello locale; passa -s user.
- Accedere da un server senza interfaccia o da una sessione SSH. Gemini CLI documenta che il suo flusso OAuth richiede un browser locale e un callback localhost, quindi esegui l'accesso sulla tua macchina.
L'app resta sul tuo telefono e ogni numero è monitorato 24/7 con avvisi. Da US$ 9 a US$ 0,75 per numero al mese, con il prezzo che scende man mano che aggiungi numeri, con i primi 3 giorni gratuiti.
Domande frequenti
C'è una versione locale da installare?
No. Il server è solo remoto, quindi non c'è alcun pacchetto, comando npx o processo da tenere in esecuzione. Chiudere il client non cambia nulla sul numero collegato.
Posso mettere una chiave API in un'intestazione invece di accedere?
No. Il server MCP accetta solo token OAuth dell'accesso proprio di easyCoexistence. La chiave ec_live_ di create_api_key appartiene alla Partner API, l'API REST per il software che collega i numeri dei propri clienti, e non apre il server MCP.
Quanto dura l'accesso?
I token di accesso durano 1 ora e il client li rinnova da solo con un refresh token; ogni rinnovo ne porta uno nuovo, e un refresh token scade dopo 60 giorni di inattività. Dopo questa pausa il client ti chiede di accedere di nuovo.
Più client possono usare lo stesso account contemporaneamente?
Sì. Ogni client accede per conto proprio, quindi Cursor, VS Code e un agente da terminale possono lavorare fianco a fianco sugli stessi numeri, e rimuoverne uno lascia gli altri collegati.
Continua a leggere
Pronto per iniziare?
Configura WhatsApp Coexistence in pochi minuti, non in mesi. L'app continua a funzionare sul telefono.
Inizia la prova gratuitaVerificato il