← Todos los conectores MCP de Telegram

Gemini · Google

Conecta Telegram a Gemini

Usa Entergram como servidor MCP de Telegram para Google Gemini y el Gemini CLI: dale a Gemini acceso seguro y acotado por OAuth a tus chats reales de Telegram para que detecte los mensajes que se te pasaron, los clientes que esperan y las oportunidades enfriadas.

URL del servidor MCP https://mcp.entergram.com/mcp

El Gemini CLI y las herramientas de Gemini compatibles con MCP pueden conectarse a servidores MCP externos. Entergram expone tu cuenta personal de Telegram como un servidor MCP alojado, de modo que Gemini lee y actúa sobre tus chats reales con seguridad OAuth, sin bots, sin código y sin claves de API.

Configuración lista para pegar

~/.gemini/settings.json
{
  "mcpServers": {
    "entergram": {
      "httpUrl": "https://mcp.entergram.com/mcp"
    }
  }
}

Pregúntale a Gemini cosas que nunca podrías preguntarle a Telegram

Con tu cuenta personal conectada, Gemini puede analizar todos tus chats a la vez. Prueba con instrucciones como:

  • «¿Cuántos mensajes se me pasaron esta semana y cuáles son de clientes?»
  • «¿A qué conversaciones se me está olvidando responder?»
  • «Cuantifica las oportunidades que se enfriaron por falta de seguimiento.»
  • «Resume las opiniones que me dieron los clientes durante el último mes.»
  • «Busca cada pregunta sin responder en todos mis chats.»
  • «Redacta respuestas para mis mensajes sin contestar más antiguos para que las revise.»

Conecta Gemini en 3 pasos

Funciona con el Gemini CLI y los clientes de Gemini compatibles con MCP.

  1. 01

    Copia tu URL del MCP en Entergram

    En Entergram, abre Settings → Workspace → Connectors → MCP y copia tu URL del servidor MCP.

  2. 02

    Registra el servidor MCP en Gemini

    Añade Entergram a la configuración MCP de tu Gemini CLI con la URL: https://mcp.entergram.com/mcp.

  3. 03

    Autoriza y ejecuta

    Haz clic en Conectar, inicia sesión con tu cuenta de Entergram y haz clic en Permitir acceso para conceder un acceso acotado. Gemini podrá entonces consultar y actuar sobre tu cuenta de Telegram.

Dónde registrar el servidor

Gemini CLI, ámbito de usuario

La vía principal, y lo que casi todo el mundo entiende por «Gemini MCP». Añade el servidor a ~/.gemini/settings.json bajo mcpServers, con httpUrl apuntando al endpoint alojado, reinicia la CLI y las herramientas estarán disponibles en todos los proyectos de esa máquina. Como es HTTPS remoto, no hay ningún envoltorio npx ni puente stdio que mantener vivo.

{ "mcpServers": { "entergram": { "httpUrl": "https://mcp.entergram.com/mcp" } } }

Gemini CLI, ámbito de proyecto

El mismo bloque colocado en .gemini/settings.json dentro de un repositorio se aplica solo a ese checkout. Es útil cuando un repo concreto es el pipeline de despliegue que anuncia versiones en un canal de Telegram y el resto de tu trabajo no tiene por qué tocar chats; además deja la configuración en el control de versiones, donde un compañero puede leerla.

mkdir -p .gemini && $EDITOR .gemini/settings.json

Cualquier cliente que use un modelo Gemini

El endpoint es agnóstico al modelo. Un agente de IDE, un arnés programado o una herramienta interna que ejecute Gemini por debajo registran Entergram como espere su propia configuración MCP y reciben la lista de herramientas idéntica. La pantalla de consentimiento es de Entergram, así que quien ejecute el cliente autoriza como él mismo en lugar de heredar la concesión de otra persona.

Trabajos de terminal que merece la pena montar

En la CLI son invocaciones de una línea que puedes dejar tras un alias del shell o un hook de git. Cada petición en lenguaje natural se expande en una secuencia de llamadas a herramientas, y la CLI imprime cuáles ha hecho, así que puedes ver la mecánica antes de confiarle una escritura. Todo lo de abajo da por hecho que el servidor está registrado y autorizado una vez; a partir de ahí es solo teclear.

Tú preguntas

«Publica las notas de versión de CHANGELOG.md en el canal beta.»

Herramientas llamadas

entergram_list_accountsentergram_list_groupsentergram_send_message

Obtienes

El paso posterior al despliegue que nadie recuerda. Gemini ya tiene el changelog en contexto desde el repositorio, elige la cuenta que administra el canal, encuentra el canal por su nombre y publica. Cuélgalo de una compilación correcta y el anuncio deja de depender de la memoria de nadie.

Tú preguntas

«¿Quién está en el canal beta y nunca hemos marcado como cliente de pago?»

Herramientas llamadas

entergram_list_group_membersentergram_list_contactsentergram_get_chat_custom_fields

Obtienes

Una diferencia de conjuntos entre dos sistemas que normalmente viven en pestañas distintas. Enumera el listado del canal, cruza esas personas con tu lista de contactos y luego lee los campos del CRM para ver quién lleva la marca de cliente. Lo que vuelve es la mitad no convertida de tu comunidad, con nombres y apellidos.

Tú preguntas

«Envía la salida de los tests que fallan al hilo de Acme con una explicación corta.»

Herramientas llamadas

entergram_list_chatsentergram_send_media_message

Obtienes

El archivo ya está en el disco, a tu lado, lo que se salta todo el baile de la subida. Gemini adjunta el artefacto y escribe él mismo la línea de acompañamiento: la diferencia entre un cliente que ve un muro de traza y un cliente que ve qué se rompió y cuándo estará arreglado.

Tú preguntas

«Crea un canal de lanzamiento, ponle un nombre decente y añade al equipo de release.»

Herramientas llamadas

entergram_create_channelentergram_update_chat_infoentergram_invite_chat_members

Obtienes

Tres pasos de la propia interfaz de Telegram condensados en una frase. Se crea el canal, se fijan el título y la descripción a partir de lo que describiste, y la lista de invitados sale de tus contactos. Esto necesita un conector del espacio de trabajo: la administración de grupos no está en el conjunto de permisos del agente personal.

Tú preguntas

«Me colé con el número de versión en ese anuncio, corrígelo.»

Herramientas llamadas

entergram_list_messagesentergram_edit_message

Obtienes

Lee el historial reciente para identificar el mensaje al que te refieres y lo edita en su sitio en vez de publicar una corrección debajo. Telegram mantiene el mensaje donde estaba, así que a quien ya lo leyó no le llega otra notificación y el historial del canal se queda limpio.

Tú preguntas

«Dame el recuento de tickets de esta semana por responsable, en TSV.»

Herramientas llamadas

entergram_list_ticketsentergram_list_ticket_custom_columnsentergram_list_members

Obtienes

El formato de salida es donde un cliente de terminal se gana el sueldo. Recupera la cola, resuelve las columnas de categoría y gravedad a sus valores de opción reales, convierte los identificadores de responsable en nombres humanos e imprime filas separadas por tabuladores que puedes canalizar directamente a una hoja de cálculo o a un script de gráficas. Informes improvisados, sin que nadie tenga que construir antes un informe.

Qué puede hacer Gemini con tu Telegram

  • Leer y resumir conversaciones de Telegram
  • Detectar mensajes que se te pasaron y respuestas vencidas
  • Consultar contactos y campos personalizados del CRM
  • Enviar mensajes y respuestas con tu aprobación
  • Cuantificar oportunidades perdidas y opiniones
  • Crear y actualizar tickets de soporte

La superficie de herramientas en la CLI

Lista los servidores MCP registrados después de conectar y aparecerán las 70 herramientas bajo entergram, agrupadas como se ve abajo. Los nombres de herramienta son identificadores literales, y eso pesa más en una terminal que en una ventana de chat: puedes nombrar una llamada directamente en tu instrucción cuando quieras un comportamiento determinista en lugar de dejar que el modelo elija su propia ruta. La CLI imprime cada llamada y sus argumentos sobre la marcha, lo que hace que una lista de herramientas desconocida se aprenda rápido.

Cuentas y espacio de trabajo

5 herramientas

Descubrimiento de identidad y alcance. Toda llamada de mensajería necesita antes un account_id obtenido de list_accounts: un cliente de IA que se salte este paso se dirigirá a la cuenta de Telegram equivocada.

  • entergram_get_me
  • entergram_list_accounts
  • entergram_get_workspace
  • entergram_get_member
  • entergram_list_members

Chats y descubrimiento

8 herramientas

Para encontrar conversaciones. Las vistas del espacio de trabajo traen el estado del CRM (tickets, comentarios, campos personalizados); las vistas en vivo traen el estado actual del transporte de Telegram y los contadores de mensajes sin leer.

  • entergram_list_chats
  • entergram_get_chat
  • entergram_list_live_chats
  • entergram_get_live_chat
  • entergram_list_workspace_chats
  • entergram_get_workspace_chat
  • entergram_update_workspace_chat
  • entergram_get_chat_management

Mensajes

9 herramientas

Lectura y escritura del historial de mensajes, incluidas ediciones, reenvíos y reacciones. El envío está acotado por cuenta, así que nada es global entre tus cuentas conectadas.

  • entergram_list_messages
  • entergram_get_message
  • entergram_send_message
  • entergram_send_media_message
  • entergram_edit_message
  • entergram_delete_message
  • entergram_forward_messages
  • entergram_get_message_reactions
  • entergram_set_message_reactions

Contactos

3 herramientas

Con quién estás hablando y en qué otros sitios coincides con esa persona. La consulta de grupos compartidos es lo que permite responder preguntas como «¿cuáles de mis oportunidades están en la misma comunidad?».

  • entergram_list_contacts
  • entergram_get_contact
  • entergram_list_contact_shared_groups

Tickets

10 herramientas

Control total de la mesa de soporte: abrir, asignar, priorizar, comentar y cerrar. Los tickets enlazan con el chat del que salieron, así que un cliente de IA puede pasar de la conversación a la cola en un solo paso.

  • entergram_list_tickets
  • entergram_get_ticket
  • entergram_create_ticket
  • entergram_update_ticket
  • entergram_delete_ticket
  • entergram_list_chat_tickets
  • entergram_list_ticket_comments
  • entergram_create_ticket_comment
  • entergram_update_ticket_comment
  • entergram_delete_ticket_comment

Campos personalizados del CRM

11 herramientas

El esquema de tu pipeline. Lee las columnas antes de escribir valores: las casillas aceptan booleanos, los campos de selección múltiple aceptan arrays de valores de opción y las fechas aceptan cadenas ISO 8601.

  • entergram_list_custom_columns
  • entergram_get_custom_column
  • entergram_create_custom_column
  • entergram_update_custom_column
  • entergram_delete_custom_column
  • entergram_list_custom_column_options
  • entergram_create_custom_column_option
  • entergram_update_custom_column_option
  • entergram_delete_custom_column_option
  • entergram_get_chat_custom_fields
  • entergram_patch_chat_custom_fields

Campos personalizados de tickets

9 herramientas

El mismo control de esquema en el lado de los tickets: categorías, niveles de gravedad, tramos de SLA y cualquier otra cosa que tu mesa de soporte registre más allá del estado y la prioridad.

  • entergram_list_ticket_custom_columns
  • entergram_get_ticket_custom_column
  • entergram_create_ticket_custom_column
  • entergram_update_ticket_custom_column
  • entergram_delete_ticket_custom_column
  • entergram_list_ticket_custom_column_options
  • entergram_create_ticket_custom_column_option
  • entergram_update_ticket_custom_column_option
  • entergram_delete_ticket_custom_column_option

Notas internas

4 herramientas

Comentarios sobre un chat que tu cliente nunca ve. Sirven para que un cliente de IA deje por escrito su razonamiento y un compañero humano lo retome después.

  • entergram_list_chat_comments
  • entergram_create_chat_comment
  • entergram_update_chat_comment
  • entergram_delete_chat_comment

Grupos y canales

11 herramientas

Crear y administrar grupos y canales de Telegram —miembros, permisos, privacidad e información— más una salida de emergencia con comandos en bruto para todo lo demás.

  • entergram_list_groups
  • entergram_get_group
  • entergram_list_group_members
  • entergram_create_group_chat
  • entergram_create_channel
  • entergram_invite_chat_members
  • entergram_remove_chat_member
  • entergram_update_chat_info
  • entergram_update_chat_permissions
  • entergram_update_chat_privacy
  • entergram_run_chat_command

Consentimiento, máquina por máquina

Nada de lo que hay en settings.json es una credencial. El archivo solo le dice a la CLI dónde vive el servidor; el acceso viene de un inicio de sesión OAuth que completas en un navegador, y el token resultante es tuyo, no del checkout. Google no recibe credenciales de Telegram en ningún momento: el número y la sesión se quedan dentro de Entergram. Existen dos conjuntos de permisos, y cuál necesitas depende de si esperas que la CLI escriba.

Permisos de agente personal
Cualquier miembro puede crear uno sin pedírselo a un administrador. Cubre la lectura del espacio de trabajo, las cuentas conectadas, los contactos, los chats, los mensajes y los tickets, más la escritura de valores de campos personalizados en tus propios chats. Suficiente para todos los trabajos de análisis y exportación de esta página; insuficiente para enviar un mensaje.
Permisos de conector del espacio de trabajo
Restringido a propietarios y administradores, y el que necesita de verdad una automatización. Añade el envío, el multimedia, las ediciones, la escritura de tickets, la escritura de campos personalizados en todo el espacio de trabajo y la administración de grupos de Telegram. Como es compartido y no personal, trata la máquina en la que lo autorices con el mismo cuidado.
Cortar la conexión
Borrar la entrada de mcpServers evita que la CLI llame al servidor, pero no invalida nada. Para cortar el acceso de verdad, revoca el cliente desde el lado de Entergram en Settings → Workspace → Connectors → MCP: eso surte efecto de inmediato y en todas las máquinas que lo estuvieran usando.

Restricciones con las que hay que diseñar

Casi todas solo muerden cuando intentas ejecutar la CLI sin supervisión.

  • Registrar el servidor no es lo mismo que autorizarlo. Cada máquina pasa por la pantalla de consentimiento la primera vez, así que un portátil nuevo o un contenedor recreado necesitan un navegador al menos una vez.
  • El espacio de trabajo de Entergram tiene que estar en Pro. La CLI listará el servidor tan tranquila y luego recibirá negativas en todas las llamadas si el plan es inferior, lo que parece una configuración rota sin serlo.
  • No hay cuenta implícita. Las herramientas de mensajería exigen un account_id explícito, así que cualquier script tiene que resolver primero la lista de cuentas: apenas se nota en un chat, es una cosa más que recordar en un pipeline. Resuélvelo una vez al principio del script y pásalo hacia abajo.
  • Un agente personal no puede enviar ni administrar grupos. Las automatizaciones que publican notas de versión o crean canales necesitan un conector del espacio de trabajo autorizado por un propietario o un administrador.
  • El protocolo es petición y respuesta, no una suscripción. A tu terminal no llega nada sin que lo pidas; Gemini se entera de un mensaje nuevo solo cuando algo le dice que mire. Cualquier cosa que se parezca a monitorización tiene que ser una tarea programada tuya.
  • La CLI no eleva privilegios. Ve exactamente los chats que ve tu propia cuenta de Telegram, y un grupo del que te saliste es un grupo que no puede leer.

Problemas de la CLI y sus causas

El servidor no aparece nunca en la lista MCP
Casi siempre es JSON mal formado: una sola coma sobrante hace que la CLI descarte el archivo de ajustes entero sin decir nada. Valídalo, confirma que la clave es httpUrl para un servidor HTTPS remoto y no una entrada stdio de comando y argumentos, y comprueba que la entrada está realmente dentro de mcpServers.
Los cambios en settings.json parecen no hacer nada
La configuración se lee al arrancar. Sal por completo de la sesión y vuelve a lanzarla; un proceso en marcha sigue sirviendo la lista de herramientas que construyó al arrancar, así que el archivo puede estar bien y parecer ignorado.
OAuth no puede completarse en una máquina sin interfaz
La pantalla de consentimiento necesita un navegador. Autoriza en un equipo donde puedas verla, o redirige el puerto de callback por SSH: un agente de compilación sin pantalla no puede terminar el intercambio por sí mismo.
Funciona en un directorio y en otro no
Tienes dos archivos de ajustes. El de ~/.gemini se aplica en todas partes; el de .gemini dentro de un repositorio, solo ahí. Comprueba cuál de los dos contiene realmente la entrada entergram antes de tocar nada más.
Todas las llamadas devuelven 403
Mira primero el plan y después el rol. El acceso MCP requiere Pro, y cualquier cosa más allá de los permisos del agente personal requiere derechos de propietario o administrador en el espacio de trabajo de Entergram.
Las lecturas funcionan pero los envíos se rechazan
Eso es el límite del agente personal asomando, no un error pasajero. El envío no está en su conjunto de permisos, así que reintentar no ayuda: un propietario o administrador tiene que autorizar un conector del espacio de trabajo y tú vuelves a pasar por el flujo de consentimiento contra él.

Preguntas frecuentes sobre Gemini + Telegram

¿Funciona con el Gemini CLI?
Sí. El Gemini CLI admite servidores MCP: registra la URL del MCP de Entergram en tu configuración MCP y autoriza mediante OAuth.
¿Es un bot de Telegram?
No. Entergram conecta tu cuenta personal real de Telegram a través de un servidor MCP alojado, así que Gemini trabaja con tus chats reales.
¿Puede Gemini decirme qué se me pasó?
Sí. Puede leer todos tus chats conectados, contar los mensajes sin responder y sin leer, y resaltar los que vienen de clientes y oportunidades.
¿Es seguro?
Sí. La conexión usa OAuth 2.0 con permisos acotados; tú decides a qué puede acceder Gemini y puedes revocarlo en cualquier momento.

Conecta Telegram a Gemini