WhatsApp em qualquer cliente MCP: Gemini CLI, VS Code, Cursor, Devin Desktop (Windsurf) e outros
Qualquer cliente MCP que suporte servidores remotos sobre Streamable HTTP com OAuth pode funcionar com um número WhatsApp Business: adicione o URL do servidor, inicie sessão uma vez no navegador e as ferramentas do WhatsApp aparecem. Só a configuração muda. O Cursor e o Zed usam url, o Gemini CLI usa httpUrl, o Antigravity usa serverUrl, e o VS Code e o Cline precisam de ter o transporte definido como HTTP.
A easyCoexistence executa um único servidor MCP remoto, https://easycoexistence.com/api/mcp, com início de sessão OAuth e mais de 30 ferramentas para os números WhatsApp Business que liga através da Coexistence: estado, mensagens, modelos, encaminhamento e automações, a partir de qualquer cliente que fale Streamable HTTP.
A chave das definições do Gemini CLI para um servidor Streamable HTTP; url aí significa um endpoint SSE.
A chave do Antigravity para um servidor remoto; url também funciona, mas httpUrl e o transporte SSE antigo não são suportados.
Quando o Gemini CLI foi substituído pelo Antigravity CLI para utilizadores do plano gratuito e do Google One.
O tipo a definir para um servidor remoto no Cline; se for omitido, o Cline usa por predefinição o transporte SSE antigo.
O novo nome do Windsurf; a FAQ diz que só o nome e a marca mudam.
O servidor MCP da easyCoexistence usa Streamable HTTP em modo sem estado e não abre nenhum stream SSE.
O que é preciso um cliente ter para se ligar a um servidor MCP remoto do WhatsApp?
São três coisas, e a maioria dos clientes atuais tem todas. Streamable HTTP, o transporte MCP em que o cliente envia POST para um único URL; o servidor aqui usa-o em modo sem estado e não abre nenhum stream SSE, pelo que um cliente configurado para SSE falha. Descoberta OAuth: na primeira chamada o servidor responde 401 com uma indicação para os seus metadados, o cliente regista-se a si próprio através de registo dinâmico de clientes e abre o seu navegador, e o início de sessão usa PKCE. E um navegador na máquina onde corre o cliente.
Na configuração não se põe nenhum cabeçalho, chave de API ou token. O servidor aceita as versões de protocolo 2025-06-18, 2025-03-26 e 2024-11-05, e um cliente que suporte apenas servidores locais iniciados na sua máquina não consegue chegar a ele.
Que configuração usa cada cliente?
Cada um destes foi verificado na documentação do próprio cliente a 11 de novembro de 2026. O padrão é o mesmo em todos, um nome e o URL https://easycoexistence.com/api/mcp, mas a chave que guarda o URL e o local onde a entrada fica diferem, e uma chave errada falha em silêncio em alguns clientes. Cada entrada precisa apenas de um nome e do URL, sem cabeçalho nem token:
Como são os ficheiros de configuração?
Estas são as entradas dos clientes que guardam os servidores num ficheiro, tal como a sua documentação as mostra. Cole a do seu cliente no ficheiro indicado acima dela, fundindo-a com os servidores que já lá estejam, depois recarregue o cliente e conclua o início de sessão que ele abre. Quando um cliente também oferece um comando ou um formulário, esse caminho escreve a mesma entrada por si:
// 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" } } }Como se adiciona no VS Code?
Com o Copilot selecionado, execute Chat: Open Customizations, escolha MCP Servers e selecione Add Server (+) no grupo User, ou execute MCP: Add Server a partir da Paleta de Comandos para o mesmo fluxo guiado. Escolha HTTP (HTTP or Server-Sent Events), cole o URL, introduza easycoexistence como ID do servidor, depois escolha Global e Copilot Global para uma configuração pessoal partilhada pelos seus espaços de trabalho nessa máquina. Conclua a autorização quando o VS Code a pedir.
A referência da Microsoft chama ao ficheiro mais antigo .vscode/mcp.json, com a sua chave servers, o formato obsoleto gerido pelo editor, e indica as configurações novas para os ficheiros do Copilot. Um .mcp.json na raiz do espaço de trabalho partilha um servidor com a equipa; como a entrada não tem nenhum segredo, pode ser enviada para o repositório sem risco.
Como se adiciona no Gemini CLI e no Antigravity?
No Gemini CLI, execute gemini mcp add --transport http easycoexistence https://easycoexistence.com/api/mcp -s user. Sem -s user o servidor é guardado no projeto, em .gemini/settings.json. Depois execute /mcp auth easycoexistence para iniciar sessão; o mesmo comando volta a iniciar sessão quando os tokens expiram. A Google indica que o Gemini CLI foi substituído pelo Antigravity CLI a 18 de junho de 2026 para utilizadores dos planos gratuitos e do Google One.
No Antigravity, coloque a entrada com serverUrl em ~/.gemini/config/mcp_config.json para todos os projetos, ou em .agents/mcp_config.json para um só espaço de trabalho. Na CLI, /mcp abre o MCP Manager com o estado de cada servidor; no IDE, selecione … no painel do agente, depois MCP Servers, Manage MCP Servers e View raw config. Como este servidor suporta registo dinâmico de clientes, não é preciso nenhum ID de cliente.
Como se adiciona no Zed, no Cline e no Devin?
No Zed, abra Settings > AI > MCP Servers, clique em Add Server e escolha Add Remote Server; sem cabeçalho Authorization na entrada, o Zed executa o fluxo OAuth padrão do MCP. No Cline, abra o ícone MCP Servers, depois o separador Remote Servers, introduza um nome e o URL, escolha Streamable HTTP e clique em Add Server; a partir da CLI do Cline, execute cline mcp add easycoexistence com o URL e --transport http, e depois a ação Authorize OAuth do assistente.
O Devin Desktop, o novo nome do Windsurf, gere os servidores em Customize > MCPs na janela Agents e guarda-os em ~/.config/devin/mcp_config.json ou na pasta .devin do projeto; quando as credenciais guardadas expiram, o servidor mostra Needs authentication e Authenticate volta a iniciar sessão. Na CLI do Devin, execute devin mcp add easycoexistence com o URL e -s user, já que o âmbito predefinido é local, e depois devin mcp login easycoexistence.
O que funciona igual em todos os clientes?
Tudo o que está por trás do URL. Cada cliente inicia sessão na mesma conta easyCoexistence, vê os mesmos números através de list_numbers e obtém as mesmas mais de 30 ferramentas. As regras da Meta vêm com elas: uma mensagem escrita livremente só chega a quem escreveu nas últimas 24 horas, os modelos são enviados apenas pela API, e um número Coexistence envia no máximo 20 mensagens por segundo. As ferramentas de envio precisam de um plano ativo em todos os clientes, enquanto as de leitura continuam a funcionar.
O que muda é o controlo que o próprio cliente tem sobre as chamadas de ferramentas, como o Cursor pedir aprovação antes de usar uma ferramenta MCP por predefinição. O servidor envia a lista de ferramentas quando um cliente se liga e não anuncia alterações, por isso recarregue ou volte a ligar o cliente depois de a sua conta ganhar uma funcionalidade.
Como configurar
- 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.
Erros comuns
- Escrever url nas definições do Gemini CLI. Aí significa um endpoint SSE, que este servidor não abre; use httpUrl, ou gemini mcp add --transport http.
- Deixar type de fora numa entrada do Cline. O Cline usa então o transporte SSE antigo e a ligação falha; por isso defina type como streamableHttp.
- Adicionar o servidor no Gemini CLI ou no Devin CLI sem âmbito e depois não o encontrar noutra pasta. O Gemini usa por predefinição o âmbito do projeto e o Devin o local; passe -s user.
- Iniciar sessão a partir de um servidor sem interface ou de uma sessão SSH. O Gemini CLI documenta que o seu fluxo OAuth precisa de um navegador local e de um callback em localhost, por isso execute o início de sessão na sua própria máquina.
A aplicação fica no seu telemóvel, e cada número é monitorizado 24 horas por dia, com alertas. De US$ 9 a US$ 0,75 por número por mês, descendo à medida que acrescenta números, com os primeiros 3 dias gratuitos.
Perguntas frequentes
Existe uma versão local para instalar?
Não. O servidor é apenas remoto, por isso não há nenhum pacote, comando npx nem processo para manter a correr. Fechar o cliente não altera nada no número ligado.
Posso pôr uma chave de API num cabeçalho em vez de iniciar sessão?
Não. O servidor MCP aceita apenas tokens OAuth do próprio início de sessão da easyCoexistence. A chave ec_live_ criada por create_api_key pertence à Partner API, a API REST para software que liga os números dos seus clientes, e não abre o servidor MCP.
Quanto tempo dura o início de sessão?
Os tokens de acesso duram 1 hora e o cliente renova-os sozinho com um refresh token; cada renovação traz um novo, e um refresh token expira após 60 dias sem uso. Passado esse intervalo, o cliente pede-lhe que volte a iniciar sessão.
Podem vários clientes usar a mesma conta ao mesmo tempo?
Sim. Cada cliente inicia sessão por si, por isso o Cursor, o VS Code e um agente de terminal podem trabalhar lado a lado nos mesmos números, e remover um deixa os outros ligados.
Continue a ler
Pronto para começar?
Configure a Coexistência do WhatsApp em minutos, não em meses. A aplicação continua a funcionar no telemóvel.
Começar período experimental gratuitoVerificado em