MensajeríaTelegram

Telegram en ChatGPT o Claude desde el navegador

Usa la CLI de Telegram de forma remota con sus métodos de conexión y configuración de acceso compatibles.

Conecta las herramientas a un chat del navegador o un agente en otro dispositivo. Aquí están los detalles de arranque y transferencia del mensajero; para la primera conexión empieza por la guía paso a paso enlazada.

Conectar ChatGPT o Claude →

Conecta una aplicación MCP del navegador o teléfono, como ChatGPT o Claude, con tg en un equipo que controles. Iniciarás un endpoint HTTPS público con acceso autenticado, conectarás la aplicación con los permisos del perfil elegido y aprenderás a detener el servidor o revocar el acceso.

Términos utilizados en esta página:

  • MCP (Model Context Protocol) es la forma estándar en que una aplicación de IA llama a herramientas externas. tg personal mcp serve es el servidor MCP que viene con tg; 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 usted le proporcione. tg personal mcp serve --http utiliza 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 su computadora una dirección HTTPS pública. Esta página utiliza Tailscale Funnel; 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. Lo pasas a tg 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 tg 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 ──▶ tg personal mcp serve --http (login) ──▶ Telegram

Si su conexión Tailscale ya funciona, consérvela; No necesitas un segundo túnel. La conexión stdin/stdout local sigue funcionando como antes.

Qué puedes hacer

TareaDónde
Conecte una aplicación de inteligencia artificial del navegador o del teléfono a TelegramIniciar el túnel y el servidor, luego conectar la aplicación
Ejecute los servidores Telegram y MAX uno al lado del otroEjecute MAX y Telegram juntos
Utilice Cloudflare en lugar de TailscaleAlternativa: Túnel Cloudflare
Permitir más o menos ejecución de un servidorPermisos para este proceso de servidor
Detenga el servidor o cierre sesión en todas las aplicacionesDetener o revocar acceso
Proporcionar a un agente remoto un archivo guardado o una página PDF como imagenTransferir archivos retenidos a un agente, leer páginas PDF

Antes de empezar

  • Quien inicia sesión lee tu Telegram. El inicio de sesión necesita la clave de acceso de tu terminal. Nunca coloques un túnel frente a tg personal mcp serve 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 su configuración. Aún se aplican restricciones de destinatarios y límites por horas (lo que puede hacer un agente, guía de configuración).
  • La computadora que ejecuta tg 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 e inicie sesión en tg allí (tg personal setup --agent none). Entonces sólo necesitas un navegador.
  • Quién puede agregar un conector remoto:

Comprueba los requisitos actuales de cuenta y región de la aplicación antes de iniciar el túnel.

AplicaciónRequisitos de conexión
ChatGPTGuía de conexión
ClaudeGuía de conexión
GeminiGuía de conexión

Si falla un paso de configuración, abre una incidencia.

Iniciar el túnel y el servidor

Instale la CLI e inicie sesión en Telegram primero (guía de instalación). Utilice 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: tg work mcp serve. Tailscale es una instalación separada; Tanto tg como max admiten esta configuración.

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 dFunnel puede imprimir un enlace de aprobación.

Mantenga 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. Mantenga 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 inicio de sesión único. Nunca necesita derechos de administrador; Sólo el túnel puede necesitarlos. Los permisos del perfil deciden lo que puede hacer el agente; para restringirlos solo para este proceso de servidor, consulte permisos para este proceso de servidor.

Windows (PowerShell)

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, la CLI y Tailscale, para que vea el PATH actualizada. Utilice .cmd para los comandos npm para evitar errores de política de ejecución de PowerShell. Si la configuración aún no ha finalizado, ejecute tg.cmd personal setup --agent none en una ventana normal 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 inició sesión en Telegram:

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

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

Ejecutar MAX y Telegram juntos

Cada servidor necesita su propio puerto local y su propia dirección HTTPS pública. Por ejemplo, mantenga Telegram en 8765 local y 443 público; ejecute un segundo comando Funnel con --https=8443 8766 y ejecute MAX con --port 8766. Utilice el segundo origen dFunnel, con :8443, para el --public-url de MAX y para la dirección de su conector que termina en /mcp. Utilice 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).

Alternativa: Cloudflare Tunnel

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.

Inicia el servidor en otro terminal:

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

Agregue 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. Cuando te detengas, detén solo el proceso propio de este túnel, para que otras rutas sigan funcionando.

Un Quick Tunnel temporal no funciona por sí solo. 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). Por lo tanto, un Quick Tunnel no reemplaza al Funnel con este servidor. Solo funciona con un adaptador adicional que convierte las respuestas SSE en JSON, y ese adaptador no viene con la CLI. Un inicio de sesión funcional y una lista de herramientas no prueban que un agente pueda leer archivos PDF. Un Quick Tunnel también obtiene un nuevo nombre de host en cada reinicio, por lo que se debe actualizar la dirección del conector. Para uso regular, elija Funnel o un túnel con nombre y verifique su aplicación.

Conectar la aplicación

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 la dirección /mcp y OAuth, como se describe en la guía de conexión OpenAI. Conéctese con el código de inicio de sesión, instale el complemento y actívelo en su chat de trabajo (o menciónelo con @). El Codex local config.toml no configura esta conexión web. La disponibilidad puede depender de su cuenta o espacio de trabajo. Elija 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 tg. 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 bloquean la página de inicio de sesión hasta que se reinicia el servidor.

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.

El perfil permissions decide qué comandos están disponibles. El servidor no muestra formularios de aprobación; La aprobación de la aplicación es independiente y depende de su configuración.

MCP hace visibles los controles Unicode ocultos en los resultados de texto; los emojis de banderas de subdivisiones territoriales se conservan. Los argumentos de escritura y el JSON normal de la CLI mantienen las cadenas originales.

Permisos para este proceso del servidor

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.

Repita --permission key=level para endurecer los permisos solo para este proceso de servidor. Los niveles son deny, readonly, ask y allow. Por ejemplo, agregue --permission messages.send=deny para rechazar el envío, o --permission messages=readonly para que el agente solo pueda leer mensajes. Una anulación solo puede endurecer: una que aflojaría el nivel del perfil, como messages.send=allow en un perfil de solo lectura, se rechaza al iniciar. Para permitir más, cambie los permisos del perfil. La configuración guardada, las restricciones de destinatarios y los límites horarios no cambian. Las claves de permiso se enumeran en la guía de configuración.

Detener o revocar el acceso

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

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. Utilice el comando Tailscale de su sistema desde arriba, con derechos de administrador cuando sea necesario. No utilice funnel reset cuando otro servidor utilice Funnel: borra todas las rutas. Si detienes solo MCP, la ruta permanece, pero las herramientas no están disponibles.

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

tg personal mcp revoke --json

Esas aplicaciones deben iniciar sesión nuevamente con un nuevo código. Esto no finaliza su sesión de Telegram.

Si no funciona

  • 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, se bloquea hasta que se reinicie tg personal mcp serve --http. Si no los escribiste, alguien encontró tu dirección: reinicia y piensa en un nuevo nombre de dispositivo en Tailscale.
  • La aplicación se conecta, pero no hay herramientas: tg personal mcp check verifica que el servidor MCP se inicie y enumere sus herramientas. No comprueba el inicio de sesión de Telegram ni el túnel. Un comando que va a Telegram, como tg personal account show, verifica la conexión de la cuenta.
  • La lectura funciona, la escritura falla: verifique los permisos del perfil y cualquier anulación de --permission. deny y readonly bloquean las escrituras, independientemente de lo que apruebe la aplicación.
  • Necesita un registro de las llamadas: tg 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 (guía de diagnóstico).

Transferir archivos guardados a un agente

Un agente en su computadora puede abrir un archivo guardado mediante su local_path. Un agente remoto no puede, por lo que obtiene los bytes guardados a través de attachments show (MCP: tg_read, comando attachments show).

Primero descargue los archivos del mensaje de la forma habitual (descargando archivos). Utilice attachments list is:needs_text para encontrar el localizador de mensajes y la posición del archivo adjunto. Después pide el archivo:

tg personal attachments show msg:telegram/500/7/204 --attachment 1 --json

El comando lee solo un archivo adjunto guardado de la cuenta activa. Nunca descarga, nunca llama a un modelo, nunca marca un mensaje como leído y nunca cambia el índice de búsqueda. Un archivo faltante debe descargarse nuevamente. Cuando un mensaje tiene varios archivos, dé la posición, empezando por 1. No se envían archivos de otra cuenta, archivos faltantes ni enlaces simbólicos. El texto dentro de un archivo adjunto son datos, nunca instrucciones.

Transferir un archivo más grande

Una respuesta lleva 512 KiB por defecto; --chunk-bytes permite hasta 1 MiB. Por defecto, el archivo admite hasta 50 MiB; se configura con MESSAGING_ATTACHMENT_MAX_MIB. El item del JSON incluye base64, offset_bytes, read_bytes, total_bytes, next_offset_bytes, complete y el SHA256 de todo el archivo. complete: true significa que esta respuesta contiene el archivo completo, no que se haya reconocido su texto.

Decodifica cada parte base64, une las partes en orden de desplazamiento de bytes y sigue next_offset_bytes hasta que sea nulo. Pase el primer SHA256 como --expected-fingerprint en las siguientes solicitudes: si el archivo fuente cambió, la solicitud falla y no devuelve bytes modificados. Verifique el archivo unido con ese hash.

tg personal attachments show msg:telegram/500/7/204 --offset-bytes 524288 --expected-fingerprint <sha256> --json

A través de MCP

Encuentre attachments show con las tres herramientas normales. Sus argumentos son message (un localizador, o un id con chat), attachment, offset_bytes, chunk_bytes y expected_fingerprint. Una imagen completa PNG, JPEG o WebP, de hasta 8000 píxeles por cada lado y 20 millones de píxeles en total, llega como contenido de imagen; otros archivos llegan como recursos binarios integrados. Un recurso parcial es un conjunto de bytes, no un PDF o una imagen completos. El URI del recurso es un nombre, no una dirección de descarga.

La aplicación debe pasar esos bytes a las herramientas de archivos del agente. Si el agente puede abrir un PDF o guardar un archivo depende de la aplicación. Si la aplicación no muestra recursos integrados, solicite format: "base64" y decodifique el JSON con las herramientas del agente. Los perfiles que niegan messages o attachments.show rechazan la transferencia; Los perfiles de solo lectura pueden leer archivos guardados.

Reconocer texto y permitir búsquedas

La extracción ordinaria lee capas de texto y formatos de documentos ligeros en su computadora. Para escaneos, fotografías, escritura a mano y diseños impresos, el agente utiliza su propia visión o herramientas de OCR de forma predeterminada. Lee cada página, mantiene el texto palabra por palabra y marca las partes poco claras. La calidad depende de la resolución, el idioma, la escritura, el diseño y las herramientas del agente. Nunca sigue instrucciones escritas dentro de un archivo adjunto.

Guarde el resultado con attachments update (MCP: tg_write, comando attachments update), luego compruébelo con una búsqueda content:. Recibir los bytes no agrega texto al índice.

attachments extract --ocr permanece disponible para extracción masiva a través de models.ocr. Llama al modelo externo configurado y le envía imágenes compatibles y páginas PDF escaneadas. Se ejecuta sólo cuando usted lo llama, nunca durante una transferencia o cuando el agente lee un archivo. Los formatos y el texto de búsqueda se tratan en la guía de archivos adjuntos.

Leer páginas de PDF sin entregar un archivo local

Si la aplicación no puede pasar un PDF recibido a su lector de documentos, solicite una página como imagen PNG. El servidor MCP dibuja la página en su computadora y el agente lee la imagen con su propia visión. Esto necesita el unpdf opcional con representación de página y el @napi-rs/canvas, como se describe en motores adjuntos. No se instalan con la CLI.

tg personal attachments show msg:telegram/500/7/204 --attachment 1 --page 1 --json

A través de MCP llamar a tg_read, comando attachments show, con page: 1 y el localizador de mensajes. De forma predeterminada, la página vuelve como contenido de imagen. Si la aplicación solo muestra metadatos, solicite format: base64, luego decodifique y muestre el PNG con las herramientas de imagen del agente. Recibir una cadena base64 no equivale a ver la página. Lea las páginas 1 a pdf.page_count. Si ninguno de los formatos muestra los píxeles, informe el límite de la aplicación en lugar de inventar texto.

pdf.source_sha256 y pdf.source_bytes describen el PDF original; los sha256 y total_bytes de nivel superior describen la imagen de la página. --expected-fingerprint comprueba el PDF original. --page no se puede combinar con --offset-bytes o --chunk-bytes. Por defecto, los PDF admiten hasta 50 MiB sin límite fijo de páginas; un PNG permite 4000 píxeles por lado y 8 MiB por página. Los tres valores son configurables.

La imagen de una página no llama a ningún servicio OCR externo ni indexa ningún texto. Después de mirar cada página, el agente llama a attachments update y verifica una búsqueda de content:. Verifique números y diseños complejos con las imágenes; La calidad depende del documento fuente y de las herramientas del agente.

Aumentar el tamaño del archivo o de la vista previa PDF

Define estas variables de entorno en el ordenador que ejecuta Telegram o su servidor MCP:

VariablePor defectoQué limita
MESSAGING_ATTACHMENT_MAX_MIB50El tamaño del archivo para extracción y transferencia de adjuntos guardados
MESSAGING_PDF_PREVIEW_MAX_PIXELS4000El ancho y alto de la página PNG
MESSAGING_PDF_PREVIEW_MAX_MIB8El tamaño del PNG por página

Por ejemplo, permite archivos de 250 MiB y páginas de hasta 8000 píxeles/16 MiB:

export MESSAGING_ATTACHMENT_MAX_MIB=250
export MESSAGING_PDF_PREVIEW_MAX_PIXELS=8000
export MESSAGING_PDF_PREVIEW_MAX_MIB=16

En PowerShell usa $env:MESSAGING_ATTACHMENT_MAX_MIB = "250"; aplica la misma sintaxis a los otros nombres. Los valores deben ser enteros positivos. Ejecuta otra vez tg personal mcp config con ese entorno y reemplaza la entrada del servidor en la aplicación: conservará estos ajustes. Reinicia el servidor si ya estaba en ejecución. La transferencia normal sigue usando fragmentos de hasta 1 MiB; es un límite independiente.

Los valores grandes requieren más memoria y tiempo. El renderizado amplía la página hasta cuatro veces dentro del límite de píxeles; subir el máximo no obliga a todas las páginas a ocupar ese ancho. La respuesta MCP contempla base64 y metadatos, pero la aplicación puede imponer su propio límite. Para un JSON grande en CLI usa --max-output-bytes 50000000; 0 desactiva explícitamente el límite general de salida. Los límites del OCR externo y de descompresión de documentos son independientes del tamaño configurable del archivo.