EntrarComeçar teste grátis
Meta Tech Provider

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.

httpUrl

A chave de configuração do Gemini CLI para um servidor Streamable HTTP; ali, url significa um endpoint SSE.

serverUrl

A chave do Antigravity para um servidor remoto; url também funciona, mas httpUrl e o transporte SSE legado não são suportados.

18 June 2026

Quando o Gemini CLI foi substituído pelo Antigravity CLI para usuários do plano gratuito e do Google One.

streamableHttp

O tipo a definir para um servidor remoto no Cline; se omitido, o Cline usa por padrão o transporte SSE legado.

Devin Desktop

O novo nome do Windsurf; o FAQ dele diz que só o nome e a marca estão mudando.

POST only

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:

Cursor~/.cursor/mcp.json or .cursor/mcp.json, under mcpServers, with url
VS Code (Copilot)MCP: Add Server, then HTTP; or ~/.copilot/mcp-config.json with type http and url
Gemini CLIgemini mcp add --transport http, or httpUrl in settings.json
Antigravity~/.gemini/config/mcp_config.json or .agents/mcp_config.json, with serverUrl
ZedSettings > AI > MCP Servers, Add Remote Server; context_servers with url
ClineRemote Servers tab with Streamable HTTP, or type streamableHttp with url
Devin CLIdevin mcp add with the URL, then devin mcp login

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ê:

One entry per client
// 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

  1. 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.
  2. 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.
  3. Reload and sign inReload the client, then approve the browser sign-in it opens with your easyCoexistence account.
  4. 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.
Fazendo isso com o EasyCoexistence

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átis

Verificado em