# Telegram y MAX en ChatGPT, Claude o Gemini desde la web (/es/docs/browser-apps)

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 (Una dirección de internet desde la que la aplicación de IA llega al programa de tu ordenador. El servidor de la herramienta sigue exigiendo autenticación; conocer la dirección no da acceso a la cuenta.). MCP (Una forma de conectar herramientas a un agente de IA. Después, el agente puede solicitar chats o mensajes mediante esa conexión. Sirve para clientes como Claude Desktop, donde el agente no ejecuta comandos de terminal directamente.) 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:**

1. [Antes de empezar](#antes-de-empezar)
2. [1. Preparar una dirección pública](#1-preparar-una-dirección-pública)
3. [2. Obtener la dirección e iniciar la conexión](#2-obtener-la-dirección-e-iniciar-la-conexión)
4. [3. Añadir la conexión a tu chat de IA](#3-añadir-la-conexión-a-tu-chat-de-ia)
5. [Probar primero la lectura](#probar-primero-la-lectura)
6. [Elegir qué puede hacer el agente](#elegir-qué-puede-hacer-el-agente)
7. [Antes funcionaba y ahora no conecta](#antes-funcionaba-y-ahora-no-conecta)
8. [Ambos servicios de mensajería a la vez](#ambos-servicios-de-mensajería-a-la-vez)
9. [Detener, reiniciar o revocar](#detener-reiniciar-o-revocar)
10. [Si algo falla](#si-algo-falla)
11. [Cómo funciona la conexión](#cómo-funciona-la-conexión)
12. [Conectar sin mantener encendido el portátil](#conectar-sin-mantener-encendido-el-portátil)

## Antes de empezar [#antes-de-empezar]

- Instala la [herramienta de línea de comandos de Telegram o MAX](/llms.mdx/docs/es/installation/content.md) e inicia sesión en tu cuenta. No necesitas un agente local para usar el navegador: `tg personal setup --agent none` o `max 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](https://developers.openai.com/plugins/quickstart) y de [Claude](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp) 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 [#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](/llms.mdx/docs/es/desktop/tailscale-funnel/content.md) tiene los pasos para [macOS](/llms.mdx/docs/es/desktop/tailscale-funnel/content.md#macos), [Windows](/llms.mdx/docs/es/desktop/tailscale-funnel/content.md#windows) y [Linux](/llms.mdx/docs/es/desktop/tailscale-funnel/content.md#linux).

### Instalar Tailscale e iniciar sesión [#instalar-tailscale-e-iniciar-sesión]

1. Abre la [página de descarga](https://tailscale.com/download) y elige Windows, macOS o Linux.
2. 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](https://tailscale.com/download/linux).
3. 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](https://console.tailscale.com/admin/machines).

### Habilitar la dirección segura [#habilitar-la-dirección-segura]

1. Abre la [sección DNS de Tailscale](https://console.tailscale.com/admin/dns).
2. En **MagicDNS**, pulsa **Enable MagicDNS** si está desactivado. Así el ordenador tendrá un nombre para su dirección.
3. En **HTTPS Certificates**, pulsa **Enable HTTPS** y acepta el aviso mostrado. Esto habilita direcciones seguras; consulta las [instrucciones de Tailscale](https://tailscale.com/docs/how-to/set-up-https-certificates).
4. 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](https://tailscale.com/docs/features/tailscale-funnel).

## 2. Obtener la dirección e iniciar la conexión [#2-obtener-la-dirección-e-iniciar-la-conexión]

Elige tu sistema operativo y abre dos ventanas de terminal (Una aplicación donde pegas comandos de texto y ves el resultado. En Windows usa PowerShell; en macOS, Terminal; en Linux, tu aplicación 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](#elegir-qué-puede-hacer-el-asistente) se explica abajo.

**Windows**

**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.

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

```powershell
$mcpPublicUrl = Read-Host 'HTTPS origin from Funnel (no /mcp)'
tg.cmd personal mcp serve --http --port 8765 --public-url $mcpPublicUrl
```

Para 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.

**macOS**

**macOS · Terminal (zsh o bash)**

Instala la app Tailscale e inicia sesión. Su [CLI integrado](https://tailscale.com/docs/reference/tailscale-cli?tab=macos)
funciona aunque `tailscale` no esté en PATH. Usa dos ventanas normales de Terminal.

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

```sh
printf 'HTTPS origin from Funnel (no /mcp): '
IFS= read -r mcpPublicUrl
tg personal mcp serve --http --port 8765 --public-url "$mcpPublicUrl"
```

Para MAX, cambia `tg` por `max` en la ventana 2.

**Linux**

**Linux · Terminal (bash o zsh)**

Instala Tailscale según las [instrucciones de Linux](https://tailscale.com/download/linux)
e inicia sesión con `sudo tailscale up`. Solo el túnel de la ventana 1 necesita `sudo`.
La ventana 2 debe usar tu usuario habitual para encontrar la sesión configurada.

```sh
sudo tailscale funnel 8765
```

```sh
printf 'HTTPS origin from Funnel (no /mcp): '
IFS= read -r mcpPublicUrl
tg personal mcp serve --http --port 8765 --public-url "$mcpPublicUrl"
```

Para MAX, cambia `tg` por `max` en la ventana 2. No ejecutes el servidor del servicio de mensajería con `sudo`.

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 [#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**

### ChatGPT [#chatgpt]

1. Abre **Plugins → + Add custom MCP server**, ponle un nombre como «Mi Telegram» y pega la dirección con `/mcp`.
2. Elige OAuth (Una forma de autenticar la conexión y autorizar a la aplicación de IA indicada. Aquí usas el código de un solo uso del servidor, no el código de acceso de Telegram o MAX.), 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](https://developers.openai.com/plugins/build/auth). Usa el código de un solo uso de la ventana 2 para entrar.
3. Instala el plugin, abre un chat **Work** y selecciónalo con `@`. Después escribe peticiones normales. [Instrucciones oficiales de OpenAI](https://developers.openai.com/plugins/quickstart).

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**

### Claude [#claude]

1. En claude.ai, abre **Customize → Connectors → + Add → Add custom connector**. Introduce el nombre y la dirección con `/mcp`, y pulsa **Continue**.
2. 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.
3. 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](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp).

**Gemini**

### Gemini [#gemini]

1. En [gemini.google.com](https://gemini.google.com), abre **Settings → Connected Apps**. Si no aparece, mira en **Personal Intelligence → Connected Apps**.
2. En **Custom apps**, pulsa **Add a custom app**, pega la dirección terminada en `/mcp` y pulsa **Next**.
3. 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](https://support.google.com/gemini/answer/17209137?hl=en).

**DeepSeek**

### DeepSeek [#deepseek]

DeepSeek ofrece [Harness](https://www.deepseek.com/en/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](/llms.mdx/docs/es/agents/content.md#mcp-y-skills); no necesitas dirección pública, así que omite los pasos 1 y 2 de esta página. Harness tiene [instrucciones MCP](https://github.com/deepseek-ai/deepseek-harness/blob/master/packages/mcp/mcp-client/README.md).

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 [#probar-primero-la-lectura]

Con el plugin o conector activado en el chat, pide:

```text prompt
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](/llms.mdx/docs/es/prompting/content.md) explica cómo pedir una revisión antes de enviar.

## Elegir qué puede hacer el agente [#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](/llms.mdx/docs/es/configuration/content.md#permisos).

## Antes funcionaba y ahora no conecta [#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:

1. Activa el ordenador y comprueba la cuenta en un terminal con `tg personal account show` o `max personal account show`. En PowerShell usa `tg.cmd` o `max.cmd`. Si falla, sigue la guía de acceso de [Telegram](/llms.mdx/docs/es/tg/sessions/content.md) o [MAX](/llms.mdx/docs/es/max/sessions/content.md).
2. 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.
3. 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](/llms.mdx/docs/es/tg/remote/content.md) o [MAX](/llms.mdx/docs/es/max/remote/content.md).

## Ambos servicios de mensajería a la vez [#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](https://tailscale.com/docs/reference/tailscale-cli/funnel)).

## Detener, reiniciar o revocar [#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 status` lo muestra con su código de acceso; `tg personal mcp server stop` lo 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. Consulta `tailscale funnel status`
  y desactiva solo esa ruta con `tailscale funnel --https=443 off` (o `8443` para el segundo servidor).
  Usa la ruta y elevación de tu SO arriba. Evita `funnel reset` si tienes otra ruta: las borra todas.
- **Revocar acceso de apps:** `tg personal mcp revoke` o `max personal mcp revoke`; en PowerShell, usa
  `tg.cmd` / `max.cmd`. Las apps deben volver a entrar; la sesión del servicio de mensajería se mantiene.

## Si algo falla [#si-algo-falla]

- **No conecta:** abre el origen con `/.well-known/oauth-protected-resource/mcp` añ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. `deny` y `readonly` impiden cambios en el servidor; revisa también las aprobaciones de la app.
- **PowerShell rechaza scripts:** usa `tg.cmd` o `max.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 check` o `max personal mcp check` verifica el handshake local, no el
  túnel ni el acceso al servicio de mensajería. Un `account show` explí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 [#cómo-funciona-la-conexión]

**De ChatGPT o Claude a tus mensajes**

1. **ChatGPT · Claude** — en tu navegador; la petición la hacen sus servidores
2. **Tailscale Funnel** — una dirección https pública para un puerto de tu ordenador
3. **tg / max mcp serve --http** — en tu ordenador; pide el código de acceso y un formulario antes de cada cambio
4. **Telegram · MAX** — tu propia cuenta

## Conectar sin mantener encendido el portátil [#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](/llms.mdx/docs/es/tg/remote/content.md) y [MAX](/llms.mdx/docs/es/max/remote/content.md). Repite la petición de cinco chats: si funciona con el portátil apagado, el servidor mantiene la conexión.

<details>
<summary>Servidor Linux: mantener la conexión tras salir y reiniciar</summary>

1. 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.
2. Ejecuta `tg personal mcp config` o `max personal mcp config`. Usa la ruta absoluta de Node de `command` y la entrada del CLI de `args`; conserva el nombre del perfil antes de `mcp`: el servidor solo atiende el perfil que nombra. No guardes contraseñas ni tokens del bot en el servicio.
3. 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:

```ini
[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
```

4. 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](https://www.freedesktop.org/software/systemd/man/latest/systemd.service.html) y [lingering](https://www.freedesktop.org/software/systemd/man/latest/loginctl.html).

```sh
systemctl --user daemon-reload
systemctl --user enable --now wirecat-mcp.service
systemctl --user status wirecat-mcp.service
```

5. Ejecuta `tailscale funnel --bg 8765` en el servidor, con los permisos necesarios. La [referencia de Funnel](https://tailscale.com/docs/reference/tailscale-cli/funnel#effects-of-rebooting-and-restarting) explica cómo vuelve tras reiniciar. Su puerto debe coincidir con el servicio MCP.
6. 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.
7. 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:

```sh
systemctl --user stop wirecat-mcp.service
systemctl --user disable wirecat-mcp.service
```

`journalctl --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.

</details>
