Cómo conectar Google Gemini a tus chats de Telegram

Conectas Google Gemini a tus chats de Telegram registrando el servidor MCP alojado de Entergram, https://mcp.entergram.com/mcp, en Gemini CLI e iniciando sesión en Entergram una vez desde el navegador. A partir de ahí, Gemini puede leer tus chats, contactos y datos del CRM a través de tu cuenta personal real de Telegram, y actuar sobre ellos dentro de los permisos que concediste. La configuración son tres pasos y un pequeño bloque JSON, que verás a continuación.

Gemini CLI es la vía que la página Gemini Telegram MCP documenta al completo. Cualquier otro cliente compatible con MCP que ejecute un modelo de Gemini puede usar la misma URL, registrada como ese cliente espere.

• Un workspace Pro. API y MCP es una función del plan Pro. En un plan inferior, el CLI seguirá mostrando el servidor, pero rechazará todas las llamadas. Parece una configuración rota, pero no lo es.
• Al menos una cuenta de Telegram conectada en tu asiento. Un conector personal solo puede usar las cuentas de Telegram que aparecen en Settings → Accounts para tu propio miembro.
• Un navegador en la máquina para el primer inicio de sesión. La pantalla de consentimiento lo necesita, así que un servidor sin interfaz gráfica debe autorizarse primero desde una estación de trabajo.

Paso 1: Copia tu URL de MCP en Entergram

Ve a Settings → Workspace → Connectors → MCP y copia la URL del servidor MCP. Es la misma para todos los clientes:

https://mcp.entergram.com/mcp

Paso 2: Registra el servidor en Gemini CLI

Añade Entergram dentro de mcpServers en ~/.gemini/settings.json. Como el servidor es HTTPS remoto, la clave es httpUrl, no una entrada de comando y argumentos:

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

El archivo de tu directorio personal se aplica a todos los proyectos de esa máquina. Para limitar el acceso a Telegram a un solo repositorio, pon el mismo bloque en .gemini/settings.json dentro de ese repositorio.

Paso 3: Reinicia el CLI y autoriza

El CLI lee su configuración al arrancar, así que cierra la sesión por completo y vuelve a iniciarla. Inicia sesión en Entergram en la ventana del navegador que se abre y concede los permisos que quieres que tenga Gemini. Nada en settings.json es una credencial: el archivo solo indica dónde está el servidor, y el acceso proviene de ese inicio de sesión OAuth.

Una vez autorizado, lista los servidores MCP registrados en el CLI y las herramientas de Entergram aparecerán bajo entergram.

Lo que Gemini puede hacer depende del tipo de cliente que autorices, como se describe en la página de ayuda sobre conectores MCP:

Un agente personal no puede enviar mensajes de Telegram. Si las lecturas funcionan pero los envíos se rechazan, es el límite de permisos, no un error. Un propietario o administrador tiene que autorizar un conector de workspace, y vuelves a pasar por el flujo de consentimiento con él. En cualquier caso, concede el conjunto mínimo de permisos que requiera la tarea: messages.write permite a un agente enviar mensajes en tu nombre.

Para cortar el acceso, revoca el cliente en Entergram en Settings → Workspace → Connectors → MCP. Borrar la entrada de mcpServers solo impide que el CLI llame al servidor; no invalida la autorización.

El servidor MCP de Entergram se conecta a tu cuenta personal de Telegram, no a un bot, así que Gemini trabaja con los mismos chats que ves tú. Instrucciones que funcionan bien en el CLI:

• "¿Qué chats tienen preguntas sin responder de los últimos tres días?"
• "Lista los contactos de mi grupo de clientes que no están en el grupo de la comunidad."
• "Publica las notas de la versión de CHANGELOG.md en el canal beta." (requiere un conector de workspace)
• "Me equivoqué con el número de versión en ese anuncio, corrígelo." (requiere un conector de workspace)
• "Dame el recuento de tickets de esta semana por responsable en formato TSV."

El CLI muestra cada llamada a herramienta que hace, así que puedes observar la mecánica en una tarea de solo lectura antes de confiarle una escritura.

• Las herramientas de mensajes necesitan una cuenta explícita. No hay una cuenta predeterminada implícita, así que un script debe obtener primero la lista de cuentas y pasar el id de la cuenta.
• Nada llega sin que lo pidas. MCP funciona por petición y respuesta. Gemini solo se entera de un mensaje nuevo cuando tú, o una tarea programada tuya, le pide que mire.
• Sin acceso elevado. Gemini ve exactamente lo que ven tus cuentas de Telegram conectadas. Un grupo que abandonaste es un grupo que no puede leer, y los chats que excluyes en Accounts → Exclude chats quedan fuera de los resultados del MCP.

• El servidor nunca aparece en la lista de MCP. Normalmente es un JSON mal formado: una sola coma final hace que el CLI descarte todo el archivo de configuración. Comprueba que la entrada usa httpUrl y está dentro de mcpServers.
• Los cambios en settings.json parecen no hacer nada. Cierra la sesión por completo y vuelve a abrirla. Un proceso en ejecución conserva la lista de herramientas que creó al arrancar.
• Funciona en un directorio y no en otro. Tienes dos archivos de configuración. Comprueba si la entrada entergram está en ~/.gemini o en la carpeta .gemini de un repositorio.
• Todas las llamadas devuelven 403. Revisa primero el plan (MCP requiere Pro) y luego el rol: todo lo que supere los permisos del agente personal requiere un propietario o administrador.

El servidor MCP de Entergram es el mismo para todos los clientes. Configúralo una vez y podrás conectar el cliente de IA que prefieras, o varios:

• Conectar Claude a Telegram con Entergram
• Conectar ChatGPT a Telegram con Entergram
• Conectar cualquier herramienta de IA al MCP de Telegram

Para la lista completa de herramientas de Gemini, ejemplos por proyecto y tareas programadas, consulta la página Gemini Telegram MCP. Para ver lo que hace el servidor con cualquier cliente, empieza por la página del servidor MCP de Telegram.