WhatsApp em qualquer cliente MCP: Gemini CLI, VS Code, Cursor, Devin Desktop (Windsurf) e mais
Qualquer cliente MCP que aceite servidores remotos via Streamable HTTP com OAuth pode trabalhar com um número do WhatsApp Business: adicione a URL do servidor, faça login uma vez no navegador e as ferramentas do WhatsApp aparecem. Só a configuração muda. Cursor e Zed usam url, Gemini CLI usa httpUrl, Antigravity usa serverUrl, e VS Code e Cline precisam do transporte definido como HTTP.
A easyCoexistence roda um único servidor MCP remoto, https://easycoexistence.com/api/mcp, com login OAuth e mais de 30 ferramentas para os números do WhatsApp Business que você conecta pela Coexistência: saúde, mensagens, templates, roteamento e automações, a partir de qualquer cliente compatível com Streamable HTTP.
A chave de configuração do Gemini CLI para um servidor Streamable HTTP; ali, url significa um endpoint SSE.
A chave do Antigravity para um servidor remoto; url também funciona, mas httpUrl e o transporte SSE legado não são suportados.
Quando o Gemini CLI foi substituído pelo Antigravity CLI para usuários do plano gratuito e do Google One.
O tipo a definir para um servidor remoto no Cline; se omitido, o Cline usa por padrão o transporte SSE legado.
O novo nome do Windsurf; o FAQ dele diz que só o nome e a marca estão mudando.
O servidor MCP da easyCoexistence roda Streamable HTTP em modo stateless e não abre nenhum stream SSE.
Do que um cliente precisa para se conectar a um servidor MCP remoto do WhatsApp?
Três coisas, e a maioria dos clientes atuais tem todas. Streamable HTTP, o transporte MCP em que o cliente faz POST para uma única URL; o servidor aqui o executa em modo stateless e não abre stream SSE, então um cliente configurado para SSE falha. Descoberta OAuth: na primeira chamada, o servidor responde 401 indicando onde estão seus metadados, o cliente se registra por registro dinâmico de cliente e abre seu navegador, e o login usa PKCE. E um navegador na máquina onde o cliente roda.
Nenhum cabeçalho, chave de API ou token vai na configuração. O servidor aceita as versões de protocolo 2025-06-18, 2025-03-26 e 2024-11-05, e um cliente que só aceita servidores locais iniciados na sua máquina não consegue acessá-lo.
Qual configuração cada cliente usa?
Cada uma destas foi conferida na documentação do próprio cliente em 11 de novembro de 2026. O padrão é o mesmo em todos, um nome e a URL https://easycoexistence.com/api/mcp, mas a chave que guarda a URL e o lugar onde a entrada fica variam, e uma chave errada falha sem aviso em alguns clientes. Cada entrada precisa apenas de um nome e da URL, sem cabeçalho e sem token:
Como são os arquivos de configuração?
Estas são as entradas dos clientes que guardam servidores em arquivo, conforme aparecem na documentação de cada um. Cole a do seu cliente no arquivo indicado logo acima dela, mesclando com os servidores que já estiverem lá, depois recarregue o cliente e conclua o login que ele abrir. Quando um cliente também oferece um comando ou um formulário, esse caminho grava a mesma entrada para você:
// 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 adicionar 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 pela Command Palette para o mesmo fluxo guiado. Escolha HTTP (HTTP or Server-Sent Events), cole a URL, informe easycoexistence como ID do servidor e depois escolha Global e Copilot Global para uma configuração pessoal compartilhada entre seus workspaces naquela máquina. Conclua a autorização quando o VS Code pedir.
A referência da Microsoft chama o arquivo mais antigo .vscode/mcp.json, com sua chave servers, de formato descontinuado gerenciado pelo editor e orienta as configurações novas para os arquivos do Copilot. Um .mcp.json na raiz do workspace compartilha um servidor com a equipe; como a entrada não contém segredo, pode ser commitado com segurança.
Como adicionar 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 é salvo no projeto, em .gemini/settings.json. Depois execute /mcp auth easycoexistence para fazer login; o mesmo comando refaz o login quando os tokens expiram. O Google informa que o Gemini CLI foi substituído pelo Antigravity CLI em 18 de junho de 2026 para usuários do plano gratuito 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 único workspace. No CLI, /mcp abre o MCP Manager com o status de cada servidor; na IDE, selecione … no painel do agente, depois MCP Servers, Manage MCP Servers e View raw config. Como este servidor aceita registro dinâmico de cliente, nenhum ID de cliente é necessário.
Como adicionar 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 a aba Remote Servers, informe um nome e a URL, escolha Streamable HTTP e clique em Add Server; pela Cline CLI, execute cline mcp add easycoexistence com a URL e --transport http, e depois a ação Authorize OAuth do assistente.
O Devin Desktop, novo nome do Windsurf, gerencia servidores em Customize > MCPs na janela Agents e os guarda em ~/.config/devin/mcp_config.json ou na pasta .devin do projeto; quando as credenciais salvas expiram, o servidor mostra Needs authentication, e Authenticate refaz o login. Na Devin CLI, execute devin mcp add easycoexistence com a URL e -s user, já que o padrão é o escopo local, e depois devin mcp login easycoexistence.
O que funciona igual em todos os clientes?
Tudo o que está por trás da URL. Cada cliente faz login na mesma conta da easyCoexistence, vê os mesmos números pelo list_numbers e tem acesso às mesmas mais de 30 ferramentas. As regras da Meta vêm junto: uma mensagem livre só chega a quem escreveu nas últimas 24 horas, templates saem somente pela API, e um número em Coexistência envia no máximo 20 mensagens por segundo. As ferramentas de envio exigem um plano ativo em qualquer cliente, enquanto as de leitura continuam funcionando.
O que muda é o controle de cada cliente sobre as chamadas de ferramentas, como o Cursor, que por padrão pede aprovação antes de usar uma ferramenta MCP. O servidor envia sua lista de ferramentas quando um cliente se conecta e não anuncia mudanças, então recarregue ou reconecte o cliente depois que sua conta ganhar um recurso.
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 no settings.json do Gemini CLI. Ali, url significa um endpoint SSE, que este servidor não abre; use httpUrl ou gemini mcp add --transport http.
- Omitir type em uma entrada do Cline. Nesse caso, o Cline usa o transporte SSE legado e a conexão falha; defina type como streamableHttp.
- Adicionar o servidor no Gemini CLI ou na Devin CLI sem escopo e depois não encontrá-lo em outra pasta. O Gemini usa por padrão o escopo de projeto e o Devin, o local; passe -s user.
- Fazer login a partir de um servidor headless ou de uma sessão SSH. O Gemini CLI documenta que seu fluxo OAuth precisa de um navegador local e de um callback em localhost, então faça o login na sua própria máquina.
O app continua no seu celular, e cada número é monitorado 24/7 com alertas. De R$ 29,90 a R$ 3,90 por número por mês, caindo conforme você adiciona números, com os 3 primeiros dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
Existe uma versão local para instalar?
Não. O servidor é só remoto, então não há pacote, comando npx nem processo para manter rodando. Fechar o cliente não muda nada no número conectado.
Posso usar uma chave de API no cabeçalho em vez de fazer login?
Não. O servidor MCP aceita apenas tokens OAuth do próprio login da easyCoexistence. A chave ec_live_ gerada por create_api_key pertence à Partner API, a API REST para softwares que conectam os números dos seus clientes, e não dá acesso ao servidor MCP.
Quanto tempo dura o login?
Os tokens de acesso duram 1 hora, e o cliente os renova sozinho com um refresh token; cada renovação traz um novo, e um refresh token expira após 60 dias sem uso. Depois desse intervalo, o cliente pede que você faça login de novo.
Vários clientes podem usar a mesma conta ao mesmo tempo?
Sim. Cada cliente faz login separadamente, então Cursor, VS Code e um agente de terminal podem trabalhar lado a lado nos mesmos números, e remover um deixa os outros conectados.
Continue lendo
Pronto para começar?
Configure o WhatsApp Coexistence em minutos, não em meses. O aplicativo continua funcionando no celular.
Começar teste grátisVerificado em