Saltar al contenido
🤖 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. Entra en nodejs.org
  2. Descarga el botón que dice "LTS" (la versión estable)
  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:

Claude Desktop

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. Abre el menú Claude → Settings (o pulsa Cmd + coma)
  2. Ve a la pestaña Developer y haz clic en Edit Config
  3. Pega lo que copiaste y guarda el archivo
  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.

Claude Code / Cursor

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_accountsLista las cuentas de WhatsApp conectadas
  • list_chatsConversaciones recientes con conteo de no leídos
  • get_recent_messagesÚltimo mensaje de cada conversación, para un triaje rápido
  • find_contactBusca contactos y conversaciones por nombre o teléfono
  • list_group_participantsLista los participantes de un grupo

📖 Lectura

  • get_messagesLee mensajes con filtros (remitente, búsqueda, media, etc)
  • transcribe_audioTranscribe una nota de voz o audio (Whisper)
  • get_imageDescarga una imagen o sticker
  • get_documentDescarga un documento (PDF, DOCX, ZIP...)
  • get_videoDescarga un video

✉️ Envío y acciones

  • send_messageEnvía un mensaje de texto
  • send_imageEnvía una imagen con leyenda opcional
  • send_documentEnvía un documento (PDF, DOCX, ZIP...)
  • react_to_messageReacciona a un mensaje con un emoji
  • open_chatAbre una conversación en la interfaz de WhatsApp
  • archive_chatArchiva 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