mcp-telegram-cloud
Servidor MCP open-source que conecta una cuenta de Telegram con asistentes de IA (Claude.ai, ChatGPT) mediante OAuth + QR login. Proporciona herramientas de lectura y búsqueda: estados de conexión, listas de chats, mensajes paginados, búsqueda global y en chats, perfiles de usuarios, stickers, desca
Ficha actualizada 28 sept 2026, 19:53 · upstream 28 sept 2026, 19:48 · release v2.60.6
Qué es mcp-telegram-cloud
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
El servidor expone una cuenta de Telegram a clientes MCP conscientes (Claude.ai, ChatGPT Apps, hosts personalizados) mediante transporte HTTP streamable en /mcp. Utiliza OAuth 2.0 con registro dinámico de clientes y PKCE (RFC 8414 + 7591 + 7636), con login QR incrustado en la página de autorización. La conexión se mantiene con tokens de refresco durante 30 días.
El almacenamiento usa SQLite para sesiones, tokens OAuth y registros de uso. Cada usuario corre en un worker aislado vía IPC Master/Client, usando el cliente Telegram @overpod/mcp-telegram como base. Las páginas web están implementadas con Hono JSX (landing, autorización OAuth, privacidad, términos). La observabilidad envía logs estructurados a OTLP HTTP (SigNoz, Grafana Cloud) o stderr si no se configura SIGNOZ_ENDPOINT.
El despliegue es mediante Docker; la versión alojada corre en mcp-telegram.com. Para autoalojar, se requiere un proxy inverso HTTPS (Traefik, nginx + certbot, Caddy) porque OAuth exige HTTPS. La base de datos guarda cadenas de sesión MTProto en texto plano, por lo que debe consultarse el threat model antes de producción.
- Leer mensajes no leídos y buscar chats con asistentes de IA
- Buscar contenido global o dentro de chats específicos por nombre/descripción
- Descargar fotos y documentos desde Telegram
- Consultar perfiles de usuarios, contactos y solicitudes de contacto
- Marcar chats como leídos o silenciar notificaciones sin enviar mensajes
- OAuth 2.0 con PKCE S256 y registro dinámico de clientes (RFC 8414 + 7636)
- Login QR integrado en la página de autorización OAuth
- Transporte HTTP streamable compartido entre múltiples clientes MCP
- Almacenamiento SQLite ligero para sesiones, tokens y logs de uso
- Arquitectura multiusuario con workers aislados por cuenta
- Modo read-only por diseño: no envía ni elimina mensajes ni realiza acciones de admin
- La base de datos guarda sesiones MTProto en texto plano (requiere hardening)
- El endpoint /my/upload necesita HTTPS y token OAuth válido del cliente MCP
- Solo un desarrollador mantiene el servicio alojado; sin SLA ni soporte pagado
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Autoalojar con Docker requiere proxy inverso HTTPS (Traefik, nginx + certbot, Caddy). Configurar TELEGRAM_API_ID, TELEGRAM_API_HASH y ISSUER. ADMIN_TOKEN recomendado para operaciones admin en /api/* (stats, import de sesiones). Logs a OTLP HTTP o stderr. Consultar docs/self-hosting.md antes de producción.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.