Telegram y MAX en ChatGPT, Claude o Gemini desde la web
Conecta Telegram y MAX a un chat de IA como ChatGPT, Claude o Gemini en el navegador o la aplicación móvil. No necesitas sus aplicaciones de escritorio.
Usa Telegram y MAX desde un chat de IA en el navegador o la aplicación móvil: encuentra mensajes, reúne contexto y prepara respuestas. Se configura con unos comandos y una dirección en los ajustes del chat. No necesitas instalar ChatGPT o Claude en el ordenador. La aplicación debe admitir MCP remoto por HTTP y un acceso OAuth compatible con este servidor; elige tu aplicación abajo.
Esta guía conecta el servicio de mensajería que elijas y lo comprueba con una petición sobre tus chats. Un programa en tu ordenador accede al servicio de mensajería; tu chat de IA llega a ese programa mediante una dirección pública. MCP es el modo de conectar estas herramientas al agente. A continuación obtendremos la dirección y la añadiremos a la aplicación. Mantén el ordenador encendido y el servidor MCP de la herramienta de línea de comandos y el túnel HTTPS en ejecución mientras uses la conexión. No necesitas la aplicación de escritorio del servicio de mensajería.
En esta página:
- Antes de empezar
- 1. Preparar una dirección pública
- 2. Obtener la dirección e iniciar la conexión
- 3. Añadir la conexión a tu chat de IA
- Probar primero la lectura
- Elegir qué puede hacer el agente
- Antes funcionaba y ahora no conecta
- Ambos servicios de mensajería a la vez
- Detener, reiniciar o revocar
- Si algo falla
- Cómo funciona la conexión
- Conectar sin mantener encendido el portátil
Antes de empezar
- Instala la herramienta de línea de comandos de Telegram o MAX e inicia sesión en tu cuenta. No necesitas un agente local para usar el navegador:
tg personal setup --agent noneomax personal setup --agent none. - Haz la configuración inicial en el ordenador que ejecuta la herramienta y mantenlo encendido durante el uso. Al final explicamos la opción de un servidor siempre encendido.
- Tu cuenta del chat de IA debe permitir añadir una conexión propia. Si no aparece esa opción en tu cuenta de trabajo, consulta al administrador. Las instrucciones de OpenAI y de Claude muestran las opciones actuales.
En el siguiente paso instalaremos el programa para obtener la dirección pública y explicaremos dónde hacer clic.
1. Preparar una dirección pública
Usaremos Tailscale, un programa que hace accesible por internet la conexión de tu ordenador. No hace falta instalarlo en el móvil ni en otro dispositivo donde abras el chat.
Si usas WireCat Desktop, la guía de conexión hace este paso por ti. Abre la herramienta, luego Servidor MCP (o conectar la web), Iniciar y conectar, y en Dirección pública elige Tailscale Funnel. Todas tus herramientas comparten una dirección, con una ruta para cada una. La guía Configurar Tailscale Funnel para el MCP de WireCat tiene los pasos para macOS, Windows y Linux.
Instalar Tailscale e iniciar sesión
- Abre la página de descarga y elige Windows, macOS o Linux.
- En Windows o macOS, descarga y ejecuta el instalador y abre la aplicación. Pulsa el icono de Tailscale junto al reloj en Windows o en la barra superior de macOS, y elige Log in. Para Linux, sigue las instrucciones de instalación y acceso.
- En el navegador que se abre, inicia sesión o crea una cuenta de Tailscale y confirma la conexión del ordenador. Debe aparecer en la lista de dispositivos.
Habilitar la dirección segura
- Abre la sección DNS de Tailscale.
- En MagicDNS, pulsa Enable MagicDNS si está desactivado. Así el ordenador tendrá un nombre para su dirección.
- En HTTPS Certificates, pulsa Enable HTTPS y acepta el aviso mostrado. Esto habilita direcciones seguras; consulta las instrucciones de Tailscale.
- El primer comando del siguiente paso puede mostrar un enlace para activar Funnel, la función de acceso público. Ábrelo, entra con la misma cuenta y confirma la activación. Tailscale prepara automáticamente el certificado y el permiso. Si no tienes acceso, un administrador puede abrir Access controls → Funnel → Add Funnel to policy: instrucciones de Funnel.
2. Obtener la dirección e iniciar la conexión
Elige tu sistema operativo y abre dos ventanas de terminal. Pega el primer bloque en la ventana 1: mostrará una dirección como https://ordenador.red.ts.net. Si primero muestra un enlace de autorización, completa el punto 4 anterior y vuelve aquí.
Pega el segundo bloque en la ventana 2 e introduce la dirección HTTPS cuando la pida, sin /mcp. Conserva :8443 si aparece. Deja ambas ventanas abiertas. Los permisos del perfil deciden lo que puede hacer el agente; cómo elegir los permisos se explica abajo.
Windows · PowerShell
Instala la app Tailscale e inicia sesión desde su icono en la bandeja. Tras instalar Node.js,
el CLI y Tailscale, abre ventanas nuevas de PowerShell para actualizar PATH. Usa .cmd para
los comandos npm y evitar errores de la política de ejecución. Configuración inicial:
tg.cmd personal setup --agent none o max.cmd personal setup --agent none.
Ejecuta la ventana 1 como Administrador para Funnel. & gestiona el espacio de la ruta
predeterminada; cambia la ruta si instalaste Tailscale en otro lugar.
Ejecuta la ventana 2 con tu usuario habitual, que inició sesión en el servicio de mensajería.
& "$env:ProgramFiles\Tailscale\tailscale.exe" funnel 8765$mcpPublicUrl = Read-Host 'HTTPS origin from Funnel (no /mcp)'
tg.cmd personal mcp serve --http --port 8765 --public-url $mcpPublicUrlPara MAX, cambia tg.cmd por max.cmd en la ventana 2. Ejecuta ambos procesos en Windows.
WSL tiene rutas y red loopback propias; no mezcles su servidor con esta configuración de Windows.
El servidor escucha en 127.0.0.1:8765 e imprime un código de acceso de un solo uso.
El perfil precede al comando: tg work mcp serve o, en Windows, tg.cmd work mcp serve.
Solo el servidor con --http tiene este acceso. Nunca dirijas un túnel a tg <perfil> mcp serve o max <perfil> mcp serve iniciado sin --http: esa conexión no tiene ningún acceso protegido.
3. Añadir la conexión a tu chat de IA
Añade /mcp a la dirección HTTPS. Por ejemplo, https://ordenador.red.ts.net pasa a ser https://ordenador.red.ts.net/mcp. Es la dirección de la conexión, no la web de Telegram o MAX. Crea una conexión distinta para cada servicio de mensajería.
ChatGPT
- Abre Plugins → + Add custom MCP server, ponle un nombre como «Mi Telegram» y pega la dirección con
/mcp. - Elige OAuth, no un token copiado a mano. Si se ofrece, selecciona el registro automático (DCR): el servidor admite DCR y la comprobación S256 que piden los requisitos OAuth de OpenAI. Usa el código de un solo uso de la ventana 2 para entrar.
- Instala el plugin, abre un chat Work y selecciónalo con
@. Después escribe peticiones normales. Instrucciones oficiales de OpenAI.
Los mismos pasos añaden la conexión para Codex en la web. El config.toml local de Codex configura solo el cliente local de Codex, no esta conexión.
Claude
- En claude.ai, abre Customize → Connectors → + Add → Add custom connector. Introduce el nombre y la dirección con
/mcp, y pulsa Continue. - Elige iniciar sesión y Register automatically, si se ofrece. Termina de añadir el conector y conecta con el código de la ventana 2.
- En el chat, pulsa + → Connectors para activarlo. También funciona en Claude móvil. En una cuenta de trabajo puede tener que añadirlo primero el administrador: instrucciones oficiales de Claude.
Gemini
- En gemini.google.com, abre Settings → Connected Apps. Si no aparece, mira en Personal Intelligence → Connected Apps.
- En Custom apps, pulsa Add a custom app, pega la dirección terminada en
/mcpy pulsa Next. - Conecta con el código de un solo uso de la ventana 2. Escribe
@en el chat y selecciona la conexión. Después también puedes usarla en Gemini móvil.
Si no aparece Custom apps: Google exige actualmente una cuenta personal, tener al menos 18 años, estar en EE. UU., activar Keep Activity y usar inglés. Requisitos e instrucciones de Google.
DeepSeek
DeepSeek ofrece Harness, un cliente aparte con interfaz web y soporte MCP. Se configura de forma distinta al chat habitual de chat.deepseek.com.
Para usar un modelo DeepSeek, elige un cliente compatible con ese modelo y MCP. En el ordenador donde se ejecuta tg o max, añade una conexión local con la guía MCP; no necesitas dirección pública, así que omite los pasos 1 y 2 de esta página. Harness tiene instrucciones MCP.
Antes de introducir el código, comprueba que la página de acceso nombra la aplicación que conectas. El código funciona una vez y caduca a los 10 minutos; el servidor imprime un código nuevo después de cada acceso. Tras cinco códigos incorrectos, el acceso queda bloqueado hasta que reinicies el servidor.
Probar primero la lectura
Con el plugin o conector activado en el chat, pide:
Muéstrame mis cinco chats recientes de Telegram y sus recuentos de mensajes sin leer.Después pide un borrador o, cuando quieras enviar, indica el destinatario y el texto exacto. Cómo escribir peticiones explica cómo pedir una revisión antes de enviar.
Elegir qué puede hacer el agente
El servidor puede hacer lo que permiten los permisos guardados del perfil. Para restringirlos solo en este proceso,
añade --permission messages.send=deny o --permission messages=readonly al comando de inicio; la opción
solo endurece, y una anulación que aflojaría el perfil se rechaza al iniciar. Para permitir el envío, cambia los
permisos del perfil. La app controla sus aprobaciones. Por MCP, ask no fuerza una confirmación del servidor. Para
solo leer, elige un perfil de solo lectura.
Los ajustes de aprobación de la aplicación y las comprobaciones de permisos del servidor son controles separados. Si permites una herramienta en la aplicación y el servidor autoriza el envío, otra llamada puede enviar sin volver a preguntar. Pide un borrador para revisar el texto antes. Siguen activos los destinatarios permitidos y el límite por hora. Consulta los ejemplos de permisos.
Antes funcionaba y ahora no conecta
La conexión del navegador requiere el ordenador con la herramienta de línea de comandos, su servidor MCP y el túnel HTTPS en ejecución. Después de suspender o reiniciar, sigue este orden:
- Activa el ordenador y comprueba la cuenta en un terminal con
tg personal account showomax personal account show. En PowerShell usatg.cmdomax.cmd. Si falla, sigue la guía de acceso de Telegram o MAX. - Reinicia el túnel y el servidor en las dos ventanas indicadas arriba. Usa el mismo perfil y comprueba que la dirección HTTPS coincide con la del conector. Si cambió, actualiza la dirección pública del servidor y la del conector.
- Repite la petición de cinco chats. Si la aplicación pide conectar de nuevo, usa el nuevo código de un solo uso que muestra el servidor en ejecución.
La conexión funciona cuando el agente muestra los chats de la cuenta esperada. Si sigue fallando, las comprobaciones de abajo distinguen problemas de cuenta, túnel o aplicación. Los archivos requieren otro paso: una ruta en este ordenador no entrega el archivo al agente del navegador. Consulta la transferencia para Telegram o MAX.
Ambos servicios de mensajería a la vez
Usa puertos locales y direcciones HTTPS públicas distintos. Por ejemplo: Telegram en local
8765 y público 443; MAX en local 8766 y público 8443. Para el segundo túnel, usa el
comando Tailscale de tu SO con funnel --https=8443 8766 y añade --port 8766 a MAX.
Copia su origen HTTPS con :8443 al comando de MAX y añade /mcp para el conector.
Funnel admite los puertos públicos 443, 8443 y 10000
(referencia).
Detener, reiniciar o revocar
- Detener: Ctrl-C en ambas ventanas de primer plano detiene ese servidor y túnel.
- En segundo plano:
tg personal mcp server start --public-url "$mcpPublicUrl"ejecuta el mismo servidor sin ventana.tg personal mcp server statuslo muestra con su código de acceso;tg personal mcp server stoplo detiene. - Reiniciar: repite los comandos con el mismo perfil y URL. Las sesiones de las apps sobreviven a reinicios normales; caducan tras 30 días sin renovación.
- Funnel en segundo plano: con
--bg, Ctrl-C no lo desactiva. Consultatailscale funnel statusy desactiva solo esa ruta contailscale funnel --https=443 off(o8443para el segundo servidor). Usa la ruta y elevación de tu SO arriba. Evitafunnel resetsi tienes otra ruta: las borra todas. - Revocar acceso de apps:
tg personal mcp revokeomax personal mcp revoke; en PowerShell, usatg.cmd/max.cmd. Las apps deben volver a entrar; la sesión del servicio de mensajería se mantiene.
Si algo falla
- No conecta: abre el origen con
/.well-known/oauth-protected-resource/mcpañadido. Debe mostrar JSON. Si no, comprueba Funnel, su autorización y el puerto local. - Lee pero no envía tras aprobar en la app: comprueba los permisos de inicio y el permiso
efectivo.
denyyreadonlyimpiden cambios en el servidor; revisa también las aprobaciones de la app. - PowerShell rechaza scripts: usa
tg.cmdomax.cmd. Si no encuentra el comando, abre una ventana nueva y comprueba la instalación del CLI; no cambies la política de ejecución de todo el sistema. - Sin herramientas:
tg personal mcp checkomax personal mcp checkverifica el handshake local, no el túnel ni el acceso al servicio de mensajería. Unaccount showexplícito verifica esa cuenta. - Puerto ocupado: cambia el puerto local y apunta Funnel al mismo número. Para dos servidores, asigna también puertos HTTPS públicos distintos, como arriba.
Cómo funciona la conexión
Conectar sin mantener encendido el portátil
Puedes instalar tg o max en un servidor que esté siempre en marcha y conectar tu chat de IA a su dirección. Así podrás usar tu servicio de mensajería desde el chat aunque el portátil esté apagado.
Instala la herramienta en el servidor, inicia sesión en la cuenta elegida, arranca la conexión MCP y proporciona una dirección HTTPS pública. Configura el inicio automático tras un reinicio: tanto el servidor MCP de la herramienta de línea de comandos como su túnel HTTPS deben seguir funcionando. El servidor necesita su propio inicio de sesión; la instalación del portátil no lo conecta automáticamente.
Prueba esta opción después de que funcione en tu ordenador. Consulta la conexión remota para Telegram y MAX. Repite la petición de cinco chats: si funciona con el portátil apagado, el servidor mantiene la conexión.
Servidor Linux: mantener la conexión tras salir y reiniciar
- Usa el mismo usuario normal de Linux para instalar, entrar en el servicio de mensajería y ejecutar el servicio. Instala Node.js, CLI y Tailscale e inicia sesión con ese usuario. Comprueba primero la petición de cinco chats con el arranque normal de arriba.
- Ejecuta
tg personal mcp configomax personal mcp config. Usa la ruta absoluta de Node decommandy la entrada del CLI deargs; conserva el nombre del perfil antes demcp: el servidor solo atiende el perfil que nombra. No guardes contraseñas ni tokens del bot en el servicio. - Crea
~/.config/systemd/user/wirecat-mcp.service. Sustituye rutas y dirección pública por valores reales. Los directorios de configuración y estado deben coincidir con los del acceso comprobado:
[Unit]
Description=WireCat messenger connection
[Service]
Type=simple
WorkingDirectory=%h
ExecStart=/absolute/path/to/node /absolute/path/to/cli-entry.js personal mcp serve --http --port 8765 --public-url https://server.tailnet.ts.net
Restart=on-failure
RestartSec=10
[Install]
WantedBy=default.target- Activa el servicio con los comandos siguientes. Un administrador también debe permitir servicios sin sesión activa, por ejemplo con
loginctl enable-linger wirecat. Consulta servicios systemd y lingering.
systemctl --user daemon-reload
systemctl --user enable --now wirecat-mcp.service
systemctl --user status wirecat-mcp.service- Ejecuta
tailscale funnel --bg 8765en el servidor, con los permisos necesarios. La referencia de Funnel explica cómo vuelve tras reiniciar. Su puerto debe coincidir con el servicio MCP. - Comprueba el acceso del servicio a la misma sesión y al almacén de claves desbloqueado. Un endpoint HTTP activo no prueba el acceso a la cuenta. Si falla tras reiniciar, restablece el acceso al almacén de claves; no copies credenciales al archivo.
- Cierra SSH, apaga el portátil y repite la petición desde la aplicación. Repítela tras reiniciar el servidor. Cuenta y dirección pública deben funcionar sin arrancar manualmente un terminal.
Para parar o desactivar el inicio automático:
systemctl --user stop wirecat-mcp.service
systemctl --user disable wirecat-mcp.servicejournalctl --user -u wirecat-mcp.service -n 30 ayuda a diagnosticar. Puede mostrar el código de conexión de un solo uso: úsalo para entrar y no publiques el registro completo. Otras plataformas usan su gestor de servicios con las mismas comprobaciones de cuenta y rutas.