← Todos los conectores MCP de Telegram

Goose · Block

Conecta Telegram a Goose

Añade Entergram como extensión MCP en Goose, el agente de IA de código abierto de Block, y deja que gestione tu cuenta real de Telegram: detecta los mensajes que se te pasaron, persigue las oportunidades que se enfriaron y actúa sobre tus chats de forma autónoma.

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

Goose es un agente de IA extensible que se conecta a servidores MCP como extensiones. Entergram expone tu cuenta personal de Telegram como un servidor MCP alojado, de modo que Goose lee y actúa sobre tus chats reales con total seguridad OAuth, sin cuenta de bot y sin claves de API.

Configuración lista para pegar

~/.config/goose/config.yaml
extensions:
  entergram:
    type: streamable_http
    uri: https://mcp.entergram.com/mcp
    enabled: true

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

Con tu cuenta personal conectada, Goose puede actuar sobre todos tus chats. 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 de clientes de este mes.»
  • «Redacta respuestas para mis mensajes sin contestar más antiguos para que las revise.»

Conecta Goose en 3 pasos

Funciona con la app de escritorio y la CLI de Goose.

  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

    Añade la extensión en Goose

    En Goose, añade una nueva extensión de tipo Streamable HTTP que apunte a la URL del MCP de Entergram: 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. Goose podrá entonces leer y actuar sobre tu cuenta de Telegram en sus sesiones.

Tres formas de ejecutar la extensión de Entergram

Goose Desktop

Abre la lista de extensiones, añade una extensión personalizada, elige el tipo Streamable HTTP y pega la URL. La app de escritorio se encarga por ti de la ida y vuelta al navegador, así que la pantalla de consentimiento aparece una vez y todas las sesiones posteriores arrancan ya autorizadas.

Goose CLI

`goose configure` te guía para añadir una extensión remota sin tocar YAML: elige Add Extension y luego la opción remota Streamable HTTP. Editar ~/.config/goose/config.yaml a mano hace exactamente lo mismo y es más fácil de mantener en un repositorio de dotfiles junto al resto de la configuración de tu máquina.

goose configure

Ejecuciones desatendidas

Una vez autorizada la extensión, una invocación sin interfaz la hereda. Así es como un repaso de Telegram pasa de ser algo que te acuerdas de pedir a ser algo que tu máquina hace a las 8 de la mañana: combínalo con cron o launchd, porque Entergram no va a despertar al agente por su cuenta.

goose run -t "List every Entergram chat that has been waiting on a reply for more than a day"

Trabajos largos, ejecutados hasta el final

Goose está hecho para sostener un plan a lo largo de muchos pasos, y eso cambia lo que merece la pena pedirle. Son trabajos que de otro modo le encargarías a una persona durante una tarde. Cada uno es una sola instrucción; la secuencia de herramientas de debajo es lo que Goose deduce solo, y cada llamada queda en la transcripción de la sesión para que puedas auditar el camino que tomó.

La tarea

«Repasa todos los tickets abiertos desde hace más de tres días, lee el chat que hay detrás y redacta una actualización de estado para cada cliente. Enséñame los borradores antes de que salga nada.»

Herramientas llamadas

entergram_list_ticketsentergram_get_ticketentergram_list_messagesentergram_send_message

Goose devuelve

Una instrucción, cuatro tipos de herramienta y un bucle que dura lo que dure la cola. Goose filtra por antigüedad, abre cada ticket para encontrar la conversación de la que salió, lee suficiente historial para saber qué está esperando el cliente de verdad y escribe un borrador por ticket. Se detiene en el paso de aprobación: las llamadas de envío solo se disparan para los borradores que conserves.

La tarea

«Crea una columna Etapa de la operación con las opciones Descubrimiento, Prueba, Negociación y Cerrada, y después clasifica en una de ellas todos los chats con los que hablamos el trimestre pasado.»

Herramientas llamadas

entergram_create_custom_columnentergram_create_custom_column_optionentergram_list_workspace_chatsentergram_patch_chat_custom_fields

Goose devuelve

Esquema y relleno histórico en la misma ejecución, que es donde un agente se gana el sueldo: la columna tiene que existir antes de poder escribir un solo valor, y los valores de opción hay que releerlos para que el clasificador escriba ids de opción reales y no texto libre. Cuenta con que tarde un rato y con que te devuelva una lista por chat al final. Solo con conector del espacio de trabajo.

La tarea

«Audita nuestros tres grupos de partners: quién está en cada uno y cuáles de nuestros contactos aparecen en más de uno.»

Herramientas llamadas

entergram_list_groupsentergram_list_group_membersentergram_list_contact_shared_groups

Goose devuelve

Un cruce que no tiene interfaz en ninguna parte. Goose enumera los grupos, recorre cada lista de miembros, pregunta por contacto en qué comunidades coincidís y pliega las respuestas en una tabla de solapamiento. Lo que sale es la lista de personas que merecen un mensaje en vez de tres, y el hallazgo silencioso de que dos partners ya se conocen.

La tarea

«Busca a quien haya hecho la misma pregunta dos veces sin recibir respuesta, abre un ticket por cada caso y pega sus dos mensajes en el ticket como comentario.»

Herramientas llamadas

entergram_list_messagesentergram_create_ticketentergram_create_ticket_comment

Goose devuelve

El paso de detección es la parte difícil y es razonamiento puro: dos mensajes entrantes con la misma intención y ningún turno saliente entre medias. Todo lo posterior es mecánico. El comentario importa más que el ticket: quien coja la cola ve citada la redacción exacta que se ignoró, sin tener que reconstruir el hilo.

La tarea

«Nuestra columna de gravedad de tickets se ha desviado y ahora tres opciones significan lo mismo. Consolídalas en un conjunto canónico.»

Herramientas llamadas

entergram_list_ticket_custom_columnsentergram_list_ticket_custom_column_optionsentergram_update_ticket_custom_column_optionentergram_update_ticket

Goose devuelve

Mantenimiento que nadie programa nunca. Goose lee el esquema de tickets, agrupa las opciones casi duplicadas, renombra las supervivientes y mueve los tickets que aún estaban en valores retirados antes de descartar nada. Mira la transcripción la primera vez que lo ejecutes: es un plan cuyas tres primeras decisiones te dicen si el resto va a estar bien.

La tarea

«Envía las nuevas notas de versión a todos los grupos donde ya hayamos publicado notas de versión antes.»

Herramientas llamadas

entergram_list_groupsentergram_list_messagesentergram_list_accountsentergram_send_media_message

Goose devuelve

Goose deduce la lista de destinatarios a partir de evidencias y no de una lista que alguien mantiene: revisa el historial en busca de los grupos que han recibido este tipo de publicación, confirma que el patrón se sostiene, resuelve qué cuenta conectada es dueña de cada uno, adjunta el archivo y envía. La lista completa de grupos se te muestra antes del primer envío, así que una inferencia equivocada te cuesta un «no» y no una disculpa.

Qué puede hacer Goose 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
  • Ejecutar acciones de varios pasos sobre tus chats

La superficie completa de herramientas de la extensión

Habilitar la extensión registra 70 herramientas de 9 grupos en la sesión. Goose decide cuáles encadenar y en qué orden, así que la agrupación de abajo es menos un menú que un mapa de cómo se relacionan. Fíjate en dónde están los bordes destructivos (administración de grupos, borrado de esquemas, envíos salientes), porque son precisamente los que un agente personal no puede alcanzar en absoluto.

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

Permisos, y por qué un agente autónomo quiere tener menos

La autorización es un inicio de sesión OAuth normal en tu navegador: Goose abre la pantalla de consentimiento de Entergram, tú apruebas, y el token resultante se queda en tu configuración local de Goose y no en el servidor de nadie. La sesión de Telegram se queda detrás de Entergram: el número con el que te registraste y el inicio de sesión asociado no se le entregan nunca al agente de Block, ni al proveedor de modelo que tengas configurado. Como un agente actúa mientras tú miras hacia otro lado, el nivel de acceso que elijas aquí es el control de seguridad real, no la instrucción.

Agente personal
Abierto a cualquier miembro del espacio de trabajo. Puede leer el espacio de trabajo y sus miembros, las cuentas conectadas, tus contactos, la lista de chats, el historial de mensajes y la cola de tickets; lo único que escribe son campos personalizados en chats que pertenecen a cuentas que conectaste tú. Un agente con este token puede investigar e informar todo el día y aun así no puede decirle ni una palabra a un cliente, que suele ser el intercambio correcto para una ejecución que no estás mirando.
Conector del espacio de trabajo
Restringido a propietarios y administradores, y lleva el conjunto completo de permisos: mensajes salientes, escritura de campos personalizados en cualquier chat, cambios de tickets y de esquema, administración de grupos. Dáselo a una instancia de Goose solo cuando el plan tenga que actuar de verdad en nombre del espacio de trabajo, y mantenlo fuera de máquinas a las que se pueda sentar otra gente.
Cortar el acceso a mitad de ejecución
Dos interruptores que actúan a niveles distintos. Deshabilitar la extensión en Goose impide que el agente actual llegue a Entergram. Revocar el token en Settings → Workspace → Connectors → MCP lo invalida en todas partes a la vez, incluida una ejecución ya en marcha en otra máquina.

Dónde se topa con un muro una ejecución autónoma

Restricciones que conviene conocer antes de darle un plan a Goose y alejarte de la pantalla.

  • Las llamadas a herramientas requieren un espacio de trabajo Pro. MCP es una función del plan Pro de Entergram, así que el intercambio OAuth se completa en cualquier plan y luego falla la primera llamada del plan: un descubrimiento desagradable a los cuarenta minutos de ejecución.
  • Un agente personal no puede terminar un plan que acaba en un envío. Si el paso final es saliente, la ejecución necesita un conector del espacio de trabajo, y solo un propietario o administrador puede crearlo.
  • A Goose no lo programa nadie más que tú. Entergram no expone ningún disparador que despierte a un agente, así que el trabajo recurrente significa cron, launchd o el ejecutor que ya uses invocando Goose en el intervalo que quieras.
  • No existe una primitiva de difusión. Cada herramienta de mensajería resuelve un account_id y un chat, así que un agente que decida contactar con cuarenta personas hace cuarenta llamadas separadas: todas visibles en la transcripción y todas interrumpibles a medio camino.
  • El historial no es infinito. Las lecturas profundas de un grupo con mucho movimiento están limitadas por la retención y la paginación del propio Telegram, no por Entergram, así que un plan que dé por hecho que puede recorrer un año entero de un grupo grande volverá corto sin avisar demasiado alto.
  • Las lecturas largas cuestan tokens de modelo. Goose funciona con el proveedor que hayas configurado, y un plan que mete miles de mensajes en contexto se factura allí: acota por chat, por rango de fechas o por cola de tickets antes de soltarlo.

Cuando una ejecución de Goose se tuerce

La extensión aparece en la lista pero no hay herramientas
Goose lee su lista de extensiones cuando arranca una sesión, no mientras hay una abierta. Confirma que la entrada lleva `enabled: true` y después inicia una sesión nueva: una sesión reanudada conserva la lista de herramientas con la que se creó.
La CLI se queda colgada en el paso de autorización
La pantalla de consentimiento necesita un navegador, y una sesión SSH o un contenedor no tienen con qué abrirlo. Autoriza una vez desde una sesión de escritorio; las invocaciones sin interfaz posteriores reutilizan el token guardado.
Goose intenta lanzar un binario y falla
Se eligió el tipo de extensión equivocado. Entergram es un servidor alojado al que se llega por Streamable HTTP, no una extensión de línea de comandos: una entrada de tipo comando manda a Goose a buscar un ejecutable que nunca estuvo en tu máquina.
La ejecución se para a mitad con un error de permisos
El plan cruzó de leer a escribir. Un agente personal no puede enviar mensajes, editar los campos de chats de otras personas ni administrar grupos, así que o le pides a un propietario o administrador un conector del espacio de trabajo, o reescribes el plan para que se detenga en el borrador.
Actuó sobre la cuenta de Telegram equivocada
Con varias cuentas conectadas, una instrucción sin matizar deja la elección al modelo. Nombra la cuenta en la instrucción y exige una llamada a entergram_list_accounts al principio para que el account_id se resuelva a partir de datos y no de una suposición.
Los cambios en config.yaml parecen ignorarse
YAML es sensible a la indentación y un bloque extensions mal anidado se interpreta como nada en absoluto, sin decir palabra. Ejecuta `goose configure` y añade la extensión remota desde el menú: escribe el mismo archivo correctamente y luego puedes ver el diff.

Preguntas frecuentes sobre Goose + Telegram

¿Cómo se conecta Goose a servidores MCP?
Goose se conecta a servidores MCP como extensiones. Añade Entergram como extensión Streamable HTTP con la URL del 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.
¿Es seguro?
Sí. OAuth 2.0 con permisos acotados; tú decides a qué puede acceder Goose y puedes revocarlo en cualquier momento.