← Todos los conectores MCP de Telegram

opencode · SST

Conecta Telegram a opencode

Añade Entergram como servidor MCP en opencode, el agente de IA de terminal de código abierto de SST, 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 desde la línea de comandos.

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

opencode carga los servidores MCP desde su archivo de configuración. Registra el de Entergram como servidor MCP remoto y el agente de código abierto de SST podrá trabajar con tu cuenta personal real de Telegram en la terminal, con permisos acotados por OAuth, sin cuenta de bot y sin claves de API.

Configuración lista para pegar

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "entergram": {
      "type": "remote",
      "url": "https://mcp.entergram.com/mcp",
      "enabled": true
    }
  }
}

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

Con tu cuenta personal conectada, opencode puede actuar sobre todos tus chats desde la terminal. Prueba con instrucciones como:

  • «Abre un canal de incidencia y mete a quien esté de guardia.»
  • «Publica el resumen del despliegue en el canal de novedades para clientes.»
  • «¿Cuántos tickets siguen abiertos antes de que corte la versión?»
  • «Busca los chats que mencionan la migración y resume las dudas.»
  • «Añade una nota a ese hilo con el plan de reversión.»
  • «¿Quién del grupo beta no ha respondido al aviso de actualización?»

Conecta opencode en 3 pasos

Funciona con la TUI y la CLI de opencode.

  1. 01

    Copia tu URL del MCP en Entergram

    En Entergram, abre Settings → Workspace → Connectors → MCP y copia tu URL del servidor MCP. opencode la lee de opencode.json, así que la pegarás en un archivo y no en un formulario.

  2. 02

    Añade el servidor en opencode.json

    En tu opencode.json, añade Entergram bajo "mcp" como servidor remoto apuntando a la URL del MCP de Entergram: https://mcp.entergram.com/mcp.

  3. 03

    Autoriza y ejecuta

    Arranca opencode, inicia sesión con tu cuenta de Entergram y haz clic en Permitir acceso para conceder un acceso acotado. opencode podrá entonces leer y actuar sobre tu cuenta de Telegram en sus sesiones.

Global, por proyecto o sin interfaz

Global — ~/.config/opencode/opencode.json

Una entrada que te sigue a todos los repositorios que abras. Es el sitio correcto para una concesión personal: el servidor está disponible tanto en un proyecto de trabajo como en uno de fin de semana, y autorizas una sola vez en lugar de una por checkout.

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "entergram": {
      "type": "remote",
      "url": "https://mcp.entergram.com/mcp",
      "enabled": true
    }
  }
}

Por proyecto — opencode.json en la raíz del repo

Versionado junto al código, de modo que quien clone el repositorio recibe el servidor declarado sin que nadie se lo cuente. No se comparte nada secreto: el archivo nombra un endpoint y nada más, y cada compañero completa su propio inicio de sesión con sus propios permisos. La configuración de proyecto se superpone al archivo global, así que mantén una sola definición y no dos compitiendo.

Sin interfaz — opencode run

El motivo por el que este conector encaja con un agente de terminal. Una única invocación no interactiva cabe en un script de despliegue, en un objetivo de Makefile o en un paso de CI, que es como una notificación de versión deja de depender de que alguien se acuerde de enviarla.

opencode run "post the release summary for v2.14 in the customer channel"

Publicar versiones desde el mismo shell

Un agente de terminal se usa justo en los momentos en los que abrir una app de chat rompería la concentración: recién terminado un despliegue, en mitad de una incidencia, o al final del día cuando quieres saber qué queda abierto. Estas ejecuciones asumen ese contexto: instrucciones cortas, solo teclado, y el conector haciendo la parte que si no aplazarías hasta que dejara de importar. Cada una se corresponde con un puñado de llamadas con nombre que se imprimen en el registro de la sesión, lo que también las hace seguras de llevar tal cual a un script una vez las has visto funcionar a mano.

Tú preguntas

«El despliegue ha terminado. Publica la versión y el enlace al changelog en el canal de releases.»

Herramientas llamadas

entergram_list_accountsentergram_list_groupsentergram_send_message

Obtienes

El anuncio sale desde el mismo shell que ejecutó el despliegue, segundos después de que saliera bien y no una hora más tarde. El agente resuelve qué cuenta conectada puede publicar, encuentra el canal por su nombre para que el id no tenga que vivir en tu script, y envía. Engánchalo al objetivo de despliegue y el paso deja de ser opcional.

Tú preguntas

«Puse mal el número de build en ese anuncio: corrígelo en su sitio.»

Herramientas llamadas

entergram_list_messagesentergram_get_messageentergram_edit_message

Obtienes

Corregir el original es mejor que publicar una corrección debajo. El agente retrocede por el historial reciente para identificar el mensaje, confirma el contenido antes de tocarlo y lo edita, de modo que quien pase por ahí mañana lea el número correcto en vez de un hilo de enmiendas.

Tú preguntas

«Abre una sala de incidencia para esto y mete a quien esté de guardia.»

Herramientas llamadas

entergram_create_group_chatentergram_list_membersentergram_invite_chat_members

Obtienes

Treinta segundos de preparativos que nadie quiere hacer con un sistema caído. Se crea un grupo, se lee el listado del espacio de trabajo para resolver a las personas que nombraste y salen las invitaciones. Vuelves a los logs con la coordinación ya resuelta en vez de a medias.

Tú preguntas

«Reenvía el aviso de mantenimiento del viernes a todos los grupos de clientes que no lo hayan visto.»

Herramientas llamadas

entergram_list_groupsentergram_list_messagesentergram_forward_messages

Obtienes

Reenviar el original hace que todos los grupos lean exactamente la misma redacción, que es justo lo que quieres para una ventana de mantenimiento y justo lo que destroza reescribirlo. El agente comprueba qué grupos ya lo recibieron antes de repartir, así que nadie recibe el mismo aviso dos veces.

Tú preguntas

«Esta persona que reporta está en algunas de nuestras comunidades: ¿en cuáles, y quién más de nuestra lista está en ellas?»

Herramientas llamadas

entergram_list_contactsentergram_get_contactentergram_list_contact_shared_groups

Obtienes

La búsqueda de grupos compartidos responde a algo que Telegram no responde: dónde está realmente tu solapamiento con alguien. Útil cuando un reporte de fallo necesita contexto sobre cuánto ruido va a hacer quien lo envía, y útil otra vez cuando decides si un apaño se puede publicar una vez en una comunidad compartida en lugar de repetirlo a mano en diez hilos privados.

Tú preguntas

«Antes de cortar la versión, ¿cuántos tickets abiertos están etiquetados para este hito?»

Herramientas llamadas

entergram_list_ticket_custom_columnsentergram_list_ticketsentergram_get_ticket

Obtienes

Una comprobación de si la versión está lista que ocupa una línea y no necesita ningún panel. El agente lee tu esquema de tickets para encontrar la columna de hito, filtra los tickets abiertos por ella e informa del recuento con los títulos. Ejecútalo como primer paso de tu script de release y un ticket bloqueante detendrá la etiqueta en vez de aparecer después.

Qué puede hacer opencode con tu Telegram

  • Manejar Telegram enteramente desde el teclado
  • Anunciar un despliegue en un canal de clientes al terminar
  • Abrir un canal de incidencia e invitar a quien responde
  • Contar los tickets abiertos antes de cortar una versión
  • Configurarse global o por proyecto mediante opencode.json
  • Ejecutarse de forma no interactiva para tareas programadas

Setenta herramientas, sin instalar nada en local

El servidor lo aloja Entergram, así que opencode recoge nueve grupos de herramientas sin añadir una sola dependencia a tu máquina ni a tu imagen de CI: ni proceso puente, ni entorno de Python, ni credenciales en el repositorio. Todo lo de abajo está al alcance en cuanto existe la concesión, dentro del nivel de acceso que hayas elegido, y la lista es la misma para una sesión interactiva que para una ejecución de un solo disparo.

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

La seguridad del lado de la terminal, en un párrafo

En tus dotfiles no acaba nada sensible. opencode.json lleva una URL y un indicador; la credencial en sí queda en el almacén de autenticación del propio opencode tras un inicio de sesión en el navegador, y tu sesión de Telegram se queda dentro de Entergram, donde ni SST ni el proveedor del modelo llegan a verla. Si desaparece una máquina o se retira un runner de CI, mata la concesión desde Entergram en Settings → Workspace → Connectors → MCP y todas las sesiones de esa máquina perderán el acceso en su siguiente llamada.

Agente personal
El valor por defecto para la terminal de un desarrollador, disponible para cualquier miembro sin paso de aprobación. La lectura cubre la ficha del espacio de trabajo, tus cuentas conectadas, los contactos, los chats, el historial de mensajes y la cola de tickets; la escritura se limita a los campos personalizados de los chats que pertenecen a tus propias cuentas. Suficiente para triar, hacer resúmenes y comprobar si una versión está lista, y deliberadamente corto de todo lo que le hable a un cliente.
Conector del espacio de trabajo
Lo crea un propietario o un administrador y tiene todos los permisos que define el servidor: enviar, editar, reenviar, escribir tickets, escribir campos personalizados en cualquier punto del espacio de trabajo y administrar grupos. Es el nivel que necesita un script de despliegue si va a publicar en un canal de clientes sin una persona en el bucle.
Revocación
Inmediata, y unilateral a propósito. No necesitas acceso a la máquina que ejecuta opencode para cortarle el paso: revocar en Entergram invalida la concesión esté donde esté guardada, que es justo el objetivo cuando el ejecutor es una máquina de CI y no un portátil en tu mesa.

Restricciones de un conector nativo de terminal

Casi todas tienen que ver con la distancia entre una sesión interactiva y una automatizada, que es precisamente la distancia que un agente de terminal se pasa la vida cubriendo. Ninguna es un impedimento; todas salen más baratas aprendidas aquí que en un pipeline.

  • La primera autorización necesita un navegador. Una invocación por script no puede completar una pantalla de consentimiento, así que autoriza una vez en una sesión interactiva y deja que la concesión guardada sostenga las ejecuciones siguientes.
  • Un opencode.json versionado comparte la dirección, no el acceso. Los compañeros que clonen el repo pasan cada uno por su propio inicio de sesión, y su token lleva sus permisos y no los tuyos.
  • De nuestro lado no hay planificador. opencode termina cuando acaba la ejecución, así que cualquier cosa recurrente (un resumen nocturno, un aviso posterior al despliegue) es tu entrada de cron o tu paso de pipeline, nunca algo que Entergram dispare por su cuenta.
  • MCP forma parte del plan Pro. En cualquier plan inferior el servidor sigue respondiendo al intercambio inicial, lo que hace que el fallo parezca un error de configuración cuando en realidad es de facturación.
  • Las escrituras necesitan que la columna exista antes. El agente puede rellenar un campo de seguimiento de versiones en un chat, pero crear ese campo es una acción de conector del espacio de trabajo y una concesión personal no lo hará.
  • El direccionamiento por cuenta es obligatorio. Las costumbres de terminal esperan un valor por defecto sensato y aquí no lo hay, así que nombra la cuenta en la instrucción o el agente la resolverá él mismo desde la lista de cuentas.

Problemas habituales del conector de opencode

opencode arranca pero no lista herramientas de Entergram
Comprueba que la entrada está dentro del bloque mcp, con type puesto en remote y enabled en true: una entrada a la que le falte cualquiera de los dos se interpreta y se descarta sin comentarios. La configuración se lee al arrancar, así que reinicia la sesión después de editarla.
opencode se niega a arrancar tras la edición
Mantén la línea $schema y pasa el archivo por un parser de JSON. Una coma sobrante es la causa habitual, y el error de arranque suele nombrar el archivo en vez de la línea culpable.
Una ejecución por script se queda colgada en la autorización
Las ejecuciones no interactivas no pueden abrir una pantalla de consentimiento. Arranca opencode de forma interactiva una vez, completa el inicio de sesión de Entergram y la concesión guardada sostendrá las ejecuciones por script a partir de entonces.
Está en vigor la configuración equivocada
Un opencode.json de proyecto se superpone al archivo global de ~/.config/opencode/. Si un compañero versionó una entrada, la suya es la que se está usando: reconcilia las dos en vez de añadir un segundo servidor con otro nombre.
Los mensajes llegan al sitio equivocado
Nombra en la instrucción tanto la cuenta como el chat de destino. entergram_list_accounts resuelve lo primero, pero nada en una sesión de terminal implica un valor por defecto, y una ejecución de un solo disparo no se va a detener a preguntarte.
Las llamadas empezaron a fallar al cabo de unos días
Los tokens caducan. Ejecuta opencode de forma interactiva y aprueba el acceso otra vez: el archivo de configuración no cambia, solo la concesión que hay detrás.

Preguntas frecuentes sobre opencode + Telegram

¿Cómo se conecta opencode a servidores MCP?
opencode lee los servidores MCP de su archivo de configuración. Añade Entergram como servidor remoto con la URL del MCP y autoriza mediante OAuth.
¿Es un bot de Telegram?
No. En este montaje no hay ningún token de bot: el servidor MCP alojado actúa como tu propia cuenta de Telegram, y por eso puede leer historial que un bot nunca podría.
¿Es seguro?
Sí. OAuth 2.0 con permisos acotados; tú decides a qué puede acceder opencode y puedes revocarlo en cualquier momento.
¿Puede opencode ejecutar acciones de varios pasos en Telegram?
Sí. Como agente autónomo de terminal, opencode puede encadenar pasos en una sola ejecución (leer los chats sin responder, redactar respuestas y abrir tickets) deteniéndose a esperar tu aprobación antes de enviar nada.

Conecta Telegram a opencode