Skip to main content
← 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

Configuración lista para pegar
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "entergram": {
      "type": "remote",
      "url": "https://mcp.entergram.com/mcp",
      "enabled": true
    }
  }
}

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"

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?»

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

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