WhatsApp en Windsurf: el servidor MCP de ZapZap en Cascade

Paso a paso

1. 1

   Toma las claves y expórtalas en el entorno

   En el panel (app.zapzapapi.com), Settings > API: copia la API Key y el API Secret. Exporta ZAPZAP_API_KEY, ZAPZAP_API_SECRET y, si quieres una instancia predeterminada, ZAPZAP_INSTANCE_ID.

2. 2

   Compila el servidor

   git clone https://github.com/zapzapapi/zapzap-mcp.git, npm install y npm run build, con Node.js 18 o superior. El README del repositorio prevé npx -y zapzap-mcp, pero el 11/11/2026 el paquete aún no está publicado en npm (el registro responde 404). El camino que funciona hoy es clonar, compilar y apuntar el comando a dist/src/index.js.

3. 3

   Abre el archivo de configuración desde el propio Cascade

   La documentación de Windsurf (hoy en docs.devin.ai, leída el 11/11/2026) describe la acción Open MCP config file de Cascade, que abre el mcp_config.json en la ruta correcta de tu versión. Usa esa acción en vez de escribir la ruta, porque la ubicación del archivo cambió entre versiones.

4. 4

   Agrega el servidor con interpolación

   El formato es mcpServers con command, args y env. La documentación informa que las variables de entorno se interpolan en command, args, env, url y headers con la sintaxis ${env:NOMBRE}. Escribe los tres nombres como en el ejemplo y no pegues los valores en el archivo.

5. 5

   Actualiza y prueba con lectura

   Después de agregar un servidor, la documentación indica usar el botón de actualizar (refresh) para que aparezca. Pide a Cascade: "mira el estado de mi instancia y las últimas entregas de webhook". Windsurf pide aprobación antes de llamar a una herramienta MCP por defecto.

{
  "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"
      }
    }
  }
}