Iniciar sessãoIniciar teste gratuito
Meta Tech Provider

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.

httpUrl

A chave das definições do Gemini CLI para um servidor Streamable HTTP; url aí significa um endpoint SSE.

serverUrl

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

18 June 2026

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

streamableHttp

O tipo a definir para um servidor remoto no Cline; se for omitido, o Cline usa por predefinição o transporte SSE antigo.

Devin Desktop

O novo nome do Windsurf; a FAQ diz que só o nome e a marca mudam.

POST only

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:

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

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

  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 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.
Fazer isto com a EasyCoexistence

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 gratuito

Verificado em