WhatsApp desde el navegador

Conecta una aplicación MCP del navegador o del teléfono, como ChatGPT o Claude, a wa en un ordenador que controlas. Configurarás un túnel HTTPS con inicio de sesión, comprobarás qué acciones permite el perfil de wa y aprenderás a detener la conexión o revocar el acceso.

Términos utilizados en esta página:

• MCP (Protocolo de contexto modelo) es la forma estándar en que una aplicación de IA llama a herramientas externas. wa personal mcp es el servidor MCP que viene con wa; la guía del servidor MCP cubre aplicaciones en su propia computadora.
• Conexión remota significa que la aplicación se conecta desde sus propios servidores, a través de Internet, a la dirección que ti le proporcione. wa personal mcp --http ofrece las mismas herramientas a través de HTTP en 127.0.0.1 para esto.
• Túnel HTTPS es un programa que le da a un puerto de tu ordenador una dirección HTTPS pública. Esta página utiliza Embudo de escala de cola; El túnel Cloudflare también funciona. No es necesario comprar un dominio para Funnel.
• URL pública es esa dirección, por ejemplo https://laptop.tail1234.ts.net. Se lo pasas a wa como --public-url, y la aplicación lo obtiene con /mcp al final.
• Código de acceso es un código de un solo uso que wa imprime en tu terminal. La página de inicio de sesión de la aplicación lo solicita, por lo que solo una persona que vea ese terminal puede conectar una aplicación.

ChatGPT / Claude ──internet──▶ Tailscale Funnel ──▶ wa personal mcp --http (login) ──▶ WhatsApp

Qué puedes hacerCopy Anchor Link

Antes de empezarCopy Anchor Link

• Quien inicia sesión lee tu WhatsApp. El inicio de sesión necesita la clave de acceso de tu terminal. Nunca pongas un túnel delante de wa personal mcp sin --http: ese modo no tiene ningún inicio de sesión.
• Los permisos de perfil deciden qué puede cambiar la aplicación. deny y readonly bloquean escrituras; ask y allow permiten que una escritura MCP solicitada se realice sin un formulario en el servidor. La aprobación de la aplicación es independiente y depende de tu configuración. La lista de destinatarios y el límite por horas aún se aplican (lo que puede hacer un agente, permisos).
• El servidor comparte la única conexión del dispositivo con serve. Las lecturas del almacén local funcionan mientras se ejecuta serve. A diferencia del terminal y wa personal mcp, el servidor HTTP no pasa por serve: un envío, una edición o una reacción de la aplicación se rechaza hasta que serve se detiene, y serve no puede iniciarse mientras el servidor mantiene una conexión (una conexión, compartida con serve).
• La computadora que ejecuta wa debe permanecer encendida. Para usarlo desde un teléfono, o desde una computadora portátil sin nada instalado, ejecute todo esto en un servidor pequeño que esté siempre encendido y vincule allí wa (wa personal setup --agent none). Ese es un dispositivo vinculado más en tu teléfono.
• Quién puede agregar un conector remoto:

Tu cuenta debe permitir añadir un conector MCP remoto. Comprueba los requisitos actuales de cuenta y región antes de iniciar el túnel.

Si un paso no funciona, abra un problema.

Inicie el túnel y el servidor.Copy Anchor Link

Instale wa y vincule un perfil primero (instalación, vinculación). Usa el mismo usuario y perfil del sistema operativo para la configuración y para el servidor MCP. Coloque un perfil antes del comando cuando sea necesario: wa work mcp. Tailscale es una instalación separada.

Instale Tailscale, inicie sesión y habilite Funnel: MagicDNS, los certificados HTTPS y el permiso Funnel deben estar habilitados en su tailnet (su red Tailscale). El primer comando del embudo puede imprimir un enlace de aprobación.Mantén dos ventanas de terminal abiertas. El primero recorre el túnel. Copie el origen HTTPS que imprime en la segunda ventana cuando se le solicite. El origen es la dirección sin /mcp ni ninguna otra ruta. Mantén un puerto público explícito como :8443 en él.

El servidor escucha en 127.0.0.1:8765 e imprime un código de acceso único. Nunca necesita derechos de administrador; Sólo el túnel puede necesitarlos. Lo que puede hacer la aplicación es el propio permissions del perfil; configúrelos antes de comenzar (permisos para este proceso de servidor).

Windows (PowerShell)Copy Anchor Link

Instale la aplicación Tailscale para Windows e inicie sesión desde el menú de su bandeja. Abra una nueva ventana de PowerShell después de instalar Node.js, wa y Tailscale, para que vea la RUTA actualizada. Usa .cmd para los comandos npm para evitar errores de política de ejecución de PowerShell.

Primera ventana: ejecute PowerShell como administrador de Funnel. El operador de llamada & maneja el espacio en la ruta de instalación predeterminada; cambie la ruta si instaló Tailscale en otro lugar.

& "$env:ProgramFiles\Tailscale\tailscale.exe" funnel 8765

Segunda ventana: PowerShell normal, como el usuario que vinculó wa:

$mcpPublicUrl = Read-Host 'Paste the HTTPS origin printed by Funnel (no /mcp)'
wa.cmd personal mcp --http --port 8765 --public-url $mcpPublicUrl

Ejecuta ambos procesos en el propio Windows. WSL es un entorno separado: un túnel de Windows que apunta a la dirección de bucle invertido de Windows puede no llegar a un servidor dentro de WSL.

MacOS (Terminal)Copy Anchor Link

Instale e inicie sesión en la aplicación Tailscale. Su CLI viene con la aplicación; utilice esta ruta cuando tailscale no esté en la RUTA (guía CLI de Tailscale). Primera ventana de Terminal:

TAILSCALE_BE_CLI=1 /Applications/Tailscale.app/Contents/MacOS/Tailscale funnel 8765

Segunda ventana de Terminal, como el mismo usuario que ejecutó wa personal setup. Esto funciona tanto en zsh como en bash:

printf 'Paste the HTTPS origin printed by Funnel (no /mcp): '
IFS= read -r mcpPublicUrl
wa personal mcp --http --port 8765 --public-url "$mcpPublicUrl"

Linux (Terminal)Copy Anchor Link

Instale Tailscale con las instrucciones de Linux, luego inicie sesión con sudo tailscale up. Primera ventana de terminal:

sudo tailscale funnel 8765

Segunda ventana de terminal: su usuario normal, sin sudo, por lo que wa encuentra el dispositivo vinculado por wa personal setup:

printf 'Paste the HTTPS origin printed by Funnel (no /mcp): '
IFS= read -r mcpPublicUrl
wa personal mcp --http --port 8765 --public-url "$mcpPublicUrl"

Ejecuta varios servidores juntosCopy Anchor Link

Cada servidor necesita su propio puerto local y su propia dirección HTTPS pública. Por ejemplo, mantenga tg en 8765 local y 443 público; ejecute un segundo comando Funnel con --https=8443 8766 y ejecute wa con --port 8766. Usa el segundo origen del embudo, con :8443, para el --public-url de wa y para la dirección de su conector que termina en /mcp. Usa el comando Tailscale de su sistema desde arriba para el segundo comando Funnel. Funnel admite los puertos públicos 443, 8443 y 10000 (Referencia de comando de Funnel).

Receptor de webhook para un botCopy Anchor Link

Un número de WhatsApp Business en la Cloud API recibe sus mensajes solo mediante webhook, por lo que su receptor se publica de la misma manera (un número de WhatsApp Business como bot). wa <profile> bot watch --public-url escucha en 8766 local. Con Funnel, publíquelo en un puerto público que el servidor MCP no utiliza, como 10000:

tailscale funnel --bg --https=10000 8766
wa cloudtest bot watch --public-url https://<name>.ts.net:10000

Ejecuta primero tailscale funnel status para ver qué puertos públicos están ocupados. Con un túnel de Cloudflare con nombre, agregue un segundo nombre de host público cuyo servicio local sea http://127.0.0.1:8766. Ingrese el mismo origen que la URL de devolución de llamada en el Panel de aplicaciones de Meta. El receptor solo guarda las entregas con una firma válida de tu aplicación.

Alternativa: Túnel CloudflareCopy Anchor Link

Si ya usa Cloudflare, apunte su túnel al mismo servidor MCP local. Un nombre de host fijo necesita una cuenta de Cloudflare y un dominio en Cloudflare. Siga la configuración del túnel con nombre: instale cloudflared para su sistema, cree el túnel en el panel, inicie su conector y agregue un nombre de host público como mcp.example.com. Configure su servicio local en http://127.0.0.1:8765 y ejecute MCP en esa misma computadora.

Inicie el servidor en una segunda terminal:

wa personal mcp --http --port 8765 --public-url https://mcp.example.com

Añade https://mcp.example.com/mcp a su aplicación de IA con OAuth y DCR, como se describe en conectar la aplicación. --public-url es el origen público utilizado para iniciar sesión, no la dirección local ni la ruta /mcp. El túnel no cambia los permisos del perfil. Verifique el JSON en https://mcp.example.com/.well-known/oauth-protected-resource/mcp, luego inicie sesión y vea la lista de herramientas.

Un túnel rápido temporal no funciona. cloudflared tunnel --url http://127.0.0.1:8765 proporciona una dirección trycloudflare.com aleatoria sin cuenta ni dominio, pero los túneles rápidos no admiten SSE (eventos enviados por el servidor, la forma en que el servidor HTTP MCP transmite las respuestas). Elige Embudo o un túnel con nombre.

Conecta la aplicaciónCopy Anchor Link

La dirección de la aplicación es el origen de su túnel con /mcp al final, por ejemplo https://<device>.<network>.ts.net/mcp. Agréguelo como conector MCP remoto:

• ChatGPT o Codex web: abra Complementos, elija + Agregar servidor MCP personalizado y cree un complemento con el Dirección /mcp y OAuth, como se describe en la guía de conexión OpenAI. Conéctese con el código de acceso, instale el complemento y actívelo en su chat (o menciónelo con @). Elige el registro dinámico de clientes (DCR) cuando se lo ofrezcan; el servidor admite DCR y el desafío del código S256 que solicitan los requisitos de OpenAI OAuth.
• Claude: agregue un conector personalizado con esta dirección, como se describe en Conectores personalizados Claude. En la configuración del conector también puede configurar cada herramienta como siempre permitida, necesita aprobación o bloqueada.

Las tres herramientas funcionan sin indicaciones, recursos o obtención de MCP (preguntas que el servidor hace a la aplicación), por lo que las aplicaciones que solo admiten herramientas pueden usarlas.

La aplicación abre la página de inicio de sesión wa. Verifica la línea que dice dónde va el inicio de sesión: debe ser la aplicación que estás conectando, como chatgpt.com o claude.ai. A continuación teclea la clave de acceso desde tu terminal. El código caduca después de diez minutos; Se imprime un nuevo código después de cada inicio de sesión. Cinco códigos incorrectos detienen el inicio de sesión durante 30 segundos; después de eso se imprime un nuevo código.

La aplicación permanece conectada siempre que utilice la conexión al menos una vez cada 30 días; renueva su inicio de sesión por sí mismo. Después de 30 días sin uso, pide un nuevo código.

Permisos para este proceso de servidorCopy Anchor Link

El servidor no puede ver si la aplicación le preguntó antes de una llamada. Si la aplicación siempre permite una herramienta, la siguiente llamada puede realizarse sin una nueva pregunta.

El permissions del perfil decide qué puede hacer la aplicación. Repita --permission key=level para restringirlos solo a este proceso de servidor: --permission messages.send=readonly deja de enviar. Nunca se afloja: una anulación que daría más que el perfil (de readonly a allow, un deny a cualquier cosa) detiene el servidor al inicio y validation_error nombra la clave. Una anulación deja la configuración guardada, la lista de destinatarios y el límite por hora tal como están. Para permitir que la aplicación envíe desde un perfil de solo lectura, primero cambie el perfil: wa personal config set permissions.messages.send allow. Las claves de permiso se encuentran en la página permisos.

Detener o revocar el accesoCopy Anchor Link

Pulsa Ctrl-C en ambas ventanas de terminal para detener el servidor y este túnel. Inícielos nuevamente con los mismos comandos; Los inicios de sesión de la aplicación sobreviven a un reinicio normal del servidor. Al detener el servidor también se interrumpe la conexión del dispositivo, por lo que serve puede comenzar de nuevo.

Si inició Funnel con --bg, Ctrl-C no detiene esa ruta en segundo plano. Verifique tailscale funnel status y apague solo su puerto público, por ejemplo tailscale funnel --https=443 off. No utilice funnel reset cuando otro servidor utilice Funnel: borra todas las rutas.

Revocar el acceso de las aplicaciones es independiente de detener un proceso. Para cerrar sesión en todas las aplicaciones de un perfil:

wa personal mcp --revoke --json

Esas aplicaciones deben iniciar sesión nuevamente con un nuevo código. Esto no desvincula el dispositivo de WhatsApp.

Si no funcionaCopy Anchor Link

• La aplicación dice que no se puede conectar: abra https://<device>.<network>.ts.net/.well-known/oauth-protected-resource/mcp en un navegador. Debe mostrar un JSON corto. Si no es así, Funnel no se está ejecutando, no está habilitado en su red Tailscale o apunta a otro puerto.
• La página de inicio de sesión dice "Demasiados códigos incorrectos": después de cinco códigos incorrectos, espera 30 segundos y luego el terminal muestra un nuevo código. Si no los escribiste, alguien encontró tu dirección: detén el servidor y piensa en un nuevo nombre de dispositivo en Tailscale.
• La aplicación se conecta, pero no hay herramientas: wa personal mcp check verifica que el servidor MCP se inicie y enumere sus herramientas. No comprueba el enlace a WhatsApp ni al túnel; wa personal doctor lee el estado del dispositivo.
• La lectura funciona, la escritura falla: el servidor HTTP no pasa por serve, por lo que se rechaza una escritura mientras se ejecuta serve; el error lo nombra. De lo contrario, verifique los permisos del perfil y cualquier anulación de --permission: deny y readonly bloquean las escrituras aunque la aplicación las apruebe.
• Necesitas un registro de llamadas a herramientas: wa personal runs list las muestra. Las llamadas exitosas aparecen sólo cuando la grabación está activada; las llamadas fallidas se mantienen de forma predeterminada, a menos que la grabación se haya desactivado con "record": false o --no-record (diagnóstico).