WhatsApp no Windsurf: servidor MCP da ZapZap no Cascade

Passo a passo

1. 1

   Pegue as chaves e exporte no ambiente

   No painel (app.zapzapapi.com), Settings > API: copie a API Key e o API Secret. Exporte ZAPZAP_API_KEY, ZAPZAP_API_SECRET e, se quiser uma instância padrão, ZAPZAP_INSTANCE_ID.

2. 2

   Compile o servidor

   git clone https://github.com/zapzapapi/zapzap-mcp.git, npm install e npm run build, com Node.js 18 ou mais. O README do repositório prevê npx -y zapzap-mcp, mas em 11/11/2026 o pacote ainda não está publicado no npm (o registro responde 404). Por isso o caminho que funciona hoje é clonar, compilar e apontar o comando para dist/src/index.js.

3. 3

   Abra o arquivo de configuração pelo próprio Cascade

   A documentação do Windsurf (hoje em docs.devin.ai, lida em 11/11/2026) descreve a ação Open MCP config file do Cascade, que abre o mcp_config.json no caminho certo da sua versão. Use essa ação em vez de digitar o caminho, porque o local do arquivo mudou entre versões.

4. 4

   Adicione o servidor com interpolação

   O formato é mcpServers com command, args e env. A documentação informa que as variáveis de ambiente são interpoladas em command, args, env, url e headers com a sintaxe ${env:NOME}. Escreva os três nomes como no exemplo e não cole os valores no arquivo.

5. 5

   Atualize e teste com leitura

   Depois de adicionar um servidor, a documentação manda usar o botão de atualizar (refresh) para ele aparecer. Peça ao Cascade: "veja o status da minha instância e as últimas entregas de webhook". O Windsurf pede aprovação antes de chamar uma ferramenta MCP por padrão.

{
  "mcpServers": {
    "zapzap": {
      "command": "node",
      "args": ["/absolute/path/to/zapzap-mcp/dist/src/index.js"],
      "env": {
        "ZAPZAP_API_KEY": "${env:ZAPZAP_API_KEY}",
        "ZAPZAP_API_SECRET": "${env:ZAPZAP_API_SECRET}",
        "ZAPZAP_INSTANCE_ID": "${env:ZAPZAP_INSTANCE_ID}",
        "ZAPZAP_READ_ONLY": "true"
      }
    }
  }
}