WhatsApp en Claude: el servidor MCP de ZapZap en Claude Code y Claude Desktop

Paso a paso

1. 1

   Genera la clave y conecta un número

   En el panel (app.zapzapapi.com), abre Settings > API y copia la API Key y el API Secret. Crea una instancia y conecta el número por código QR. Exporta las dos claves en tu terminal como ZAPZAP_API_KEY y ZAPZAP_API_SECRET: van al entorno del servidor, nunca al prompt.

2. 2

   Clona y compila el servidor MCP

   Necesitas Node.js 18 o superior. Ejecuta git clone https://github.com/zapzapapi/zapzap-mcp.git y, dentro de la carpeta, npm install y npm run build. 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

   Regístralo en Claude Code

   Usa claude mcp add con las variables de entorno y el separador -- antes del comando, como en la documentación de Claude Code (leída el 11/11/2026): claude mcp add --env ZAPZAP_API_KEY=... --env ZAPZAP_API_SECRET=... --transport stdio zapzap -- node /ruta/zapzap-mcp/dist/src/index.js. El alcance predeterminado es local (solo tú, en este proyecto); -s project escribe en el .mcp.json del repositorio, que va al control de versiones, así que nunca pongas la clave ahí. Confirma con claude mcp list y, dentro de Claude Code, con /mcp.

4. 4

   O regístralo en Claude Desktop

   En Settings > Developer > Edit Config, edita claude_desktop_config.json (macOS: ~/Library/Application Support/Claude; Windows: %APPDATA%\Claude) y agrega mcpServers.zapzap con command node, args apuntando a dist/src/index.js (ruta absoluta) y env con las dos claves. Cierra Claude Desktop por completo y ábrelo de nuevo, como indica la guía de MCP (leída el 11/11/2026).

5. 5

   Prueba solo con lectura

   Pide: "lista mis instancias y dime cuál está conectada" y después "verifica si 5511999999999 tiene WhatsApp". Son herramientas de lectura (list_instances, get_instance_status, check_whatsapp_numbers). Solo después quita ZAPZAP_READ_ONLY para habilitar el envío.

6. 6

   Habilita el envío con aprobación en cada llamada

   Las herramientas de envío están marcadas como no idempotentes y destructivas, así que el cliente MCP pide confirmación antes de cada send_text. Mantén esa confirmación activa, usa una instancia dedicada y nunca dejes que el asistente envíe a una lista que no revisaste.

# 1) Build the MCP server from the repository (the npm package is not published yet)
git clone https://github.com/zapzapapi/zapzap-mcp.git
cd zapzap-mcp && npm install && npm run build

# 2) Register it in Claude Code (keys come from your shell, never from the prompt)
claude mcp add --env ZAPZAP_API_KEY="$ZAPZAP_API_KEY" --env ZAPZAP_API_SECRET="$ZAPZAP_API_SECRET" --env ZAPZAP_READ_ONLY=true --transport stdio zapzap -- node "$PWD/dist/src/index.js"

# 3) Check that it connected
claude mcp list