🤖 Nuevo en la v0.5.0

Conecta WhatsApp a tu IA

Deja que Claude (u otro asistente) lea tus mensajes, responda y transcriba audios directo en WhatsApp. Sin saber programar: solo sigue los pasos de abajo. Todo corre en tu máquina, nada pasa por un servidor externo.

Antes de nada: ten la extensión ZeroZapp instalada y WhatsApp Web abierto y con sesión iniciada. El resto es el paso a paso de abajo, desde cero.
1

Instala Node.js

¿Por qué esto? El servidor de ZeroZapp es un pequeño programa en JavaScript, y Node.js es el motor que lo hace correr en tu máquina. Es gratis, lo instalas una vez y te olvidas.

  1. 1. Entra en nodejs.org
  2. 2. Descarga el botón que dice "LTS" (la versión estable)
  3. 3. Abre el archivo descargado y ve haciendo clic en continuar hasta terminar

¿Quieres confirmar que funcionó? Abre la app Terminal (en Mac, busca "Terminal" en Spotlight) y pega esto:

node --version

Pulsa Enter. Si aparece un número como v20.11.0, todo está listo.

2

Conecta a tu cliente de IA

Elige el programa que usas:

Copia esta configuración (es la dirección que le dice a Claude cómo encontrar ZeroZapp):

{
  "mcpServers": {
    "zerozapp": {
      "command": "npx",
      "args": ["-y", "@zerozapp/mcp"]
    }
  }
}

Ahora pégala en Claude Desktop:

  1. 1. Abre el menú Claude → Settings (o pulsa Cmd + coma)
  2. 2. Ve a la pestaña Developer y haz clic en Edit Config
  3. 3. Pega lo que copiaste y guarda el archivo
  4. 4. Cierra Claude por completo y ábrelo de nuevo

💡 Si el archivo ya tiene otros servidores, pega solo el bloque "zerozapp" dentro de "mcpServers". El archivo está en ~/Library/Application Support/Claude/claude_desktop_config.json.

Estos programas editan archivos por su cuenta, así que lo más fácil es pedírselo. Pega este prompt en el propio asistente:

Agrega un servidor MCP llamado "zerozapp" en mi config, con command "npx" y args ["-y", "@zerozapp/mcp"]. Después dime cómo reiniciar para activarlo.

¿Prefieres a mano? En Claude Code, un comando en la terminal lo resuelve:

claude mcp add zerozapp -- npx -y @zerozapp/mcp

En Cursor, pega la misma configuración de la pestaña "Claude Desktop" en el archivo ~/.cursor/mcp.json. Después reinicia el cliente.

3

Activa el puente en la extensión

Abre la extensión ZeroZapp, ve a Settings → MCP y enciende Enable MCP bridge. Cuando conecte, el sello queda en Connected y tu cuenta aparece en la lista.

🔒 Si la máquina es compartida, define un token: agrega "env": { "ZEROZAPP_MCP_TOKEN": "tu-secreto" } en la configuración del paso 2 y pon el mismo token en la extensión.

4

¡Listo! Pídele algo a tu IA

Con WhatsApp Web abierto y el puente conectado, solo pide cosas como:

  • 💬 "Lista mis conversaciones no leídas en WhatsApp."
  • 💬 "Manda "ya voy" al 5511999999999."
  • 💬 "Busca el número de André y manda el PDF que está en /tmp/informe.pdf."
  • 💬 "Transcribe el último audio que me mandó María."

Lo que la IA puede hacer

Son 16 herramientas expuestas, organizadas en tres grupos:

🔍 Descubrimiento

list_accounts Lista las cuentas de WhatsApp conectadas
list_chats Conversaciones recientes con conteo de no leídos
get_recent_messages Último mensaje de cada conversación, para un triaje rápido
find_contact Busca contactos y conversaciones por nombre o teléfono
list_group_participants Lista los participantes de un grupo

📖 Lectura

get_messages Lee mensajes con filtros (remitente, búsqueda, media, etc)
transcribe_audio Transcribe una nota de voz o audio (Whisper)
get_image Descarga una imagen o sticker
get_document Descarga un documento (PDF, DOCX, ZIP...)
get_video Descarga un video

✉️ Envío y acciones

send_message Envía un mensaje de texto
send_image Envía una imagen con leyenda opcional
send_document Envía un documento (PDF, DOCX, ZIP...)
react_to_message Reacciona a un mensaje con un emoji
open_chat Abre una conversación en la interfaz de WhatsApp
archive_chat Archiva o desarchiva una conversación

El parámetro account es la parte del número en el ID de WhatsApp (ej: 5511999999999). Solo es necesario cuando tienes más de una cuenta conectada.

Cómo funciona por dentro

El servidor MCP corre localmente en tu máquina y habla con la extensión por WebSocket. Tu cliente de IA conversa con ese servidor, que reenvía los comandos a WhatsApp Web abierto en el navegador.

Cliente de IA  ──stdio──▶  servidor @zerozapp/mcp  ──WebSocket──▶  extensión ZeroZapp
                                                                      │
                                                                      ▼
                                                                 WhatsApp Web

Esa línea npx -y @zerozapp/mcp de la configuración es lo que descarga y enciende el servidor automáticamente (npx viene junto con Node). Puedes cambiar el puerto con ZEROZAPP_MCP_PORT (predeterminado 9223); la URL del WebSocket en la extensión es ws://127.0.0.1:9223.

¿Algún problema?

Ninguna cuenta conectada

Verifica que WhatsApp Web esté abierto y con sesión iniciada, y que el puente esté activado en Settings → MCP.

La extensión se queda reconectando

Confirma que el puerto coincide y que el token es idéntico en ambos lados. El log está en zerozapp-mcp-daemon.log (en la carpeta temporal del sistema).

auth_required y se desconecta

El token de la extensión y el del servidor son distintos. Déjalos iguales.

La herramienta da timeout

El Window.Store de WhatsApp puede no estar listo. Recarga WhatsApp Web e inténtalo de nuevo.

Privacidad y seguridad

  • 🔒 El servidor escucha solo en 127.0.0.1, nunca queda accesible por la red
  • 🔒 El puente viene desactivado por defecto: solo se enciende cuando lo activas
  • 🔒 Define un token siempre que la máquina sea compartida, y trátalo como una contraseña
  • 🔒 El puente puede leer todos tus mensajes y enviar mensajes en tu nombre

¿Aún no tienes ZeroZapp?

Instala la extensión y activa el puente MCP en pocos minutos.

Instalar desde la Chrome Web Store