MCTL for Telegram

Tu cuenta de Telegram autorizada, dentro de tu asistente de IA

Instala desde el Directorio de Apps de ChatGPT o conéctate a través de Configuración → Apps. Resume chats, busca mensajes y redacta respuestas desde ChatGPT, Claude o cualquier cliente MCP, después de iniciar sesión con OAuth en la cuenta de Telegram que posees y controlas.

Política de privacidad · Modelo de seguridad · [email protected] · ¿Quieres la sesión en tu propia máquina? Local Bridge

Lo que puedes hacer

Resumir chats no leídos

Pregunta a tu asistente qué te perdiste mientras estabas ausente. Obtén un resumen de cualquier chat, grupo o canal sin abrir Telegram.

Redactar y revisar mensajes

Deja que tu asistente escriba o revise una respuesta antes de que la envíes. Revisa el tono, detecta errores o traduce, y luego envía cuando estés listo.

Buscar en conversaciones

Encuentra cualquier cosa que hayas dicho o recibido, al instante. Busca por tema, persona o fecha en todo tu historial.

Clasificar tu bandeja de entrada

Enumera cada chat y destaca lo que aún necesita respuesta, para que puedas despejar un acumulado de conversaciones no leídas de una sola pasada.

Traducir sobre la marcha

Lee chats en idiomas extranjeros en tu propio idioma, o redacta una respuesta en el de ellos, sin salir de la conversación.

Fijar lo importante

Pide a tu asistente que fije un mensaje clave en un chat (requiere derechos de administrador en grupos) para que lo importante permanezca arriba donde todos lo vean.

Cómo funciona

Tu cliente de IA Claude, ChatGPT…

Servidor MCP mctl-telegram

API MTProto de Telegram

1. Te autorizas con el inicio de sesión de Telegram. mctl-telegram almacena una sesión MTProto cifrada en tu nombre.
2. Cuando le das una instrucción a tu asistente, este llama a las herramientas MCP en este servidor a través de una conexión autenticada con OAuth.
3. mctl-telegram realiza llamadas MTProto a Telegram, formatea el resultado y lo devuelve a tu asistente.

Instalar en ChatGPT

1. Abre ChatGPT → Configuración → Apps y selecciona tu app en borrador (o instala desde el Directorio de Apps una vez publicada).
2. Establece la URL del servidor MCP en https://tg.mctl.ai/mcp.
3. Autenticación: OAuth. ChatGPT descubre este servidor a través de https://tg.mctl.ai/.well-known/oauth-protected-resource y https://tg.mctl.ai/.well-known/oauth-authorization-server.
4. Completa el flujo de inicio de sesión de Telegram en tu navegador cuando se te solicite.
5. Prueba con una herramienta de solo lectura (list_dialogs o get_unread_messages) antes de habilitar envíos reales. En tg.mctl.ai, los envíos reales permanecen bloqueados hasta que todas las puertas de aceptación estén habilitadas (consulta send-gate).
6. Revisa nuestra política de privacidad y modelo de seguridad antes de conectar tu cuenta.

Otros clientes MCP

1. Cualquier cliente: copia la URL MCP https://tg.mctl.ai/mcp y agrégala como conector personalizado. La autenticación es OAuth: inicias sesión con Telegram una vez durante la configuración.
2. Claude: abre Configuración de conectores, elige Agregar conector personalizado y pega la URL MCP.
3. ChatGPT (fuera del flujo del Directorio de Apps anterior): abre Configuración → Conectores, agrega un conector personalizado y pega la URL MCP. Requiere un plan con conectores personalizados habilitados; consulta la Guía de apps MCP y Modo Desarrollador de OpenAI.
4. Cursor, Windsurf y otros: pega la URL MCP en la configuración del conector MCP remoto de tu cliente. Consulta /docs para las URL de descubrimiento OAuth y un comando de prueba rápida.

Datos de un vistazo

• Almacenado en este servidor: un blob de sesión de Telegram cifrado con AES-256-GCM por cuenta y metadatos de auditoría sin texto de mensajes. Cuando Communication Agent está habilitado, el contenido relevante de mensajes/eventos entrantes y las cargas útiles de acciones propuestas también se almacenan cifrados en reposo.
• No almacenado en registros ni historial de auditoría: cuerpos de mensajes, números de teléfono, contraseñas 2FA o tokens OAuth.
• A través de ChatGPT: tus instrucciones, argumentos de herramientas y resultados de herramientas pasan por el cliente de ChatGPT para llegar a este servidor; las prácticas de datos propias de ChatGPT se aplican a ese tráfico.
• Tus controles: desconecta o elimina tu cuenta en cualquier momento mediante las herramientas MCP o la API HTTP. Inventario completo en nuestra política de privacidad.

Nuestro modelo de confianza

mctl-telegram mantiene una sesión de Telegram del lado del servidor en tu nombre. Esto es exactamente lo que significa:

• Las sesiones están cifradas en reposo con AES-256-GCM con claves por usuario derivadas mediante HKDF-SHA256.
• El texto de los mensajes nunca se escribe en registros ni historial de auditoría. El contenido de mensajes y acciones de Communication Agent está cifrado en reposo y se conserva según la política en /privacy.
• Puedes desconectar (revocación suave) o eliminar (borrado definitivo) tu sesión en cualquier momento usando las herramientas MCP o la API.

Punto final MCP: https://tg.mctl.ai/mcp
Documento de recurso protegido OAuth: https://tg.mctl.ai/.well-known/oauth-protected-resource

Modelo de seguridad completo Retención de datos Referencia para desarrolladores

Mantén la sesión en tu máquina

Local Bridge (beta) es la ruta de autoservicio donde la sesión de Telegram permanece en una máquina que tú controlas y tg.mctl.ai actúa solo como relevo. No es la ruta de instalación de la App de ChatGPT. Necesitas una máquina que permanezca encendida. La activación es de autoservicio.

1. init, luego login --phone +…
2. activate --server https://tg.mctl.ai y aprueba el dispositivo en un navegador. Después de login, --telegram-id es opcional.
3. daemon: la primera credencial es de solo lectura. Activa el envío tú mismo con set_send_consent o la página de administración.

Inicio rápido Descripción general Controles del propietario Soporte y recuperación

Preguntas frecuentes

¿Con qué asistentes de IA funciona esto?

Con cualquier cliente que admita conectores MCP remotos: Claude, ChatGPT, Cursor, Windsurf y otros. Es un servidor MCP estándar autenticado con OAuth, por lo que no está vinculado a un solo proveedor.

¿Es esta una aplicación oficial de Telegram?

No. mctl-telegram es un proyecto independiente, no afiliado ni respaldado por Telegram u OpenAI. Opera solo en la cuenta de Telegram que conectas explícitamente, y sigues siendo responsable de cumplir los términos de Telegram.

¿Puede enviar mensajes en mi nombre?

Solo si te suscribes explícitamente. En tg.mctl.ai, el valor predeterminado efectivo es de prueba: ALLOW_SEND=false bloquea los envíos reales, por lo que send_message devuelve una vista previa (sent=false) en su lugar. Los envíos reales además requieren el indicador send_enabled de tu cuenta (lo activas con set_send_consent o la página de administración) y el alcance telegram:messages:send: no hay argumento de modo para omitir la puerta.

¿Qué datos ve ChatGPT?

Tus instrucciones de conversación, los argumentos de herramientas que ChatGPT envía (por ejemplo, peer, texto de mensaje para borradores) y los resultados de herramientas que este servidor devuelve. Ese tráfico se maneja bajo las políticas de OpenAI. Para llamadas MCP ordinarias, este servidor almacena un blob de sesión cifrado y metadatos de auditoría. Las cuentas con Communication Agent habilitado y listener adicionalmente almacenan contenido de mensajes y acciones cifrado como se describe en /privacy.

¿Qué datos almacena mctl-telegram?

Un blob de sesión cifrado y metadatos se almacenan por cuenta. Cuando Communication Agent está habilitado, los mensajes/eventos entrantes relevantes y las cargas útiles de acciones propuestas se almacenan cifrados en reposo; los registros y el historial de auditoría aún excluyen los cuerpos de mensajes. Consulta /privacy para detalles de retención.

¿Cómo revoco el acceso?

Llama a la herramienta MCP disconnect_telegram_account (revocación suave, conserva la fila) o delete_telegram_account (borrado definitivo, elimina todos tus datos). También puedes revocar desde el lado de Telegram: Configuración → Dispositivos.

¿Es de código abierto?

Sí. El código fuente completo está en github.com/mctlhq/mctl-telegram. Puedes auditar el código, ejecutar tu propio despliegue o contribuir.

¿Qué es Local Bridge?

Un modo autohospedado opcional (beta) donde la sesión de Telegram permanece en tu propia máquina y tg.mctl.ai actúa solo como relevo. No es parte de la ruta estándar de instalación de la App de ChatGPT, y necesita una máquina que permanezca encendida, pero activarlo es de autoservicio: init, login, activate, daemon. Migrar una cuenta alojada existente a este modo aún usa set_account_mode (un paso de operador, no de incorporación). Comienza en el inicio rápido.