← Todos los conectores MCP de Telegram

Cursor, Zed y Windsurf

Conecta Telegram a Cursor e IDEs

Añade Entergram como servidor MCP en Cursor, Zed o Windsurf y accede a tu cuenta real de Telegram desde tu editor: revisa los mensajes que se te pasaron y los clientes que te esperan sin romper tu concentración.

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

Cursor, Zed y Windsurf admiten servidores MCP mediante una configuración mcp.json. Entergram expone tu cuenta personal de Telegram como un servidor MCP alojado, de modo que la IA de tu editor actúa sobre tus chats reales con seguridad OAuth, sin bots y sin claves de API.

Configuración lista para pegar

mcp.json (Cursor / Zed / Windsurf)
{
  "mcpServers": {
    "entergram": {
      "url": "https://mcp.entergram.com/mcp"
    }
  }
}

Pregúntale a tu editor sobre tu Telegram

Con tu cuenta personal conectada, la IA de tu IDE puede consultar Telegram sin que cambies de app. Prueba con:

  • «¿Se me pasó algún mensaje de cliente mientras estaba metido de lleno programando?»
  • «¿A qué conversaciones se me está olvidando responder?»
  • «¿Cuántas oportunidades se enfriaron esta semana?»
  • «Resume las opiniones de clientes de hoy.»
  • «Redacta una respuesta al último mensaje sin contestar y muéstramela.»

Conecta tu editor en 3 pasos

Funciona con Cursor, Zed y Windsurf.

  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 el servidor a mcp.json

    En la configuración MCP de tu editor (mcp.json), registra la URL del MCP de Entergram: https://mcp.entergram.com/mcp.

  3. 03

    Autoriza y úsalo

    Haz clic en Conectar, inicia sesión con tu cuenta de Entergram y haz clic en Permitir acceso. El asistente de IA de tu editor ya puede consultar y actuar sobre tu cuenta de Telegram.

Tres editores, tres archivos de configuración

Cursor — ~/.cursor/mcp.json

Cursor carga los servidores desde ~/.cursor/mcp.json para todos los proyectos que abras, o desde un .cursor/mcp.json versionado dentro de un repo cuando solo quieres el servidor disponible en ese código. La ruta por menú es Cursor Settings → MCP & Integrations → New MCP server, que escribe ese mismo archivo por ti. Una entrada de proyecto pide confianza la primera vez que el agente la usa, así que un compañero que clone el repo sigue tomando una decisión consciente.

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

Zed — ~/.config/zed/settings.json

Zed guarda los servidores MCP en un bloque context_servers dentro de su archivo de ajustes principal y no en un bloque mcpServers, y esa única palabra arruina la mayoría de los primeros intentos: pega el fragmento de Cursor tal cual y no carga nada, sin ningún error que lo explique. La pantalla de ajustes del Agent Panel tiene un botón Add Custom Server que escribe la forma correcta si prefieres no editar JSON a mano.

{
  "context_servers": {
    "entergram": {
      "source": "custom",
      "url": "https://mcp.entergram.com/mcp"
    }
  }
}

Windsurf — ~/.codeium/windsurf/mcp_config.json

Windsurf lee un archivo dedicado bajo ~/.codeium en lugar de los ajustes del editor que cabría esperar, y Cascade lo reexamina bajo demanda: después de guardar, abre el panel MCP en Cascade y pulsa refrescar, o las herramientas seguirán invisibles hasta el siguiente reinicio. La forma del JSON coincide con la de Cursor, así que la entrada es portable entre ambos.

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

De la traza de error a la persona que la envió

Tu editor ya tiene el código. Lo que nunca ha tenido es la otra mitad de un fallo: quién lo sufrió, cuántos son y qué les prometió soporte. Cada pregunta de abajo se resuelve en una cadena corta de llamadas con nombre que van pasando por el panel del agente mientras tú sigues leyendo el archivo.

Tú preguntas

«Alguien nos mandó un TypeError de la página de facturación. Encuentra el mensaje y dime quién lo reportó.»

Herramientas llamadas

entergram_list_messagesentergram_get_contactentergram_list_chat_tickets

Obtienes

El agente rastrea el historial reciente buscando el texto del error, resuelve al remitente en una ficha de contacto y comprueba si esa conversación ya generó un ticket. Obtienes el nombre de quien lo reportó, sus palabras exactas y un sí o un no sobre si soporte lo registró, antes de abrir un solo archivo del repositorio.

Tú preguntas

«¿Merece la pena arreglarlo hoy? Cuenta cuánta gente ha reportado lo mismo.»

Herramientas llamadas

entergram_list_workspace_chatsentergram_list_messagesentergram_get_chat

Obtienes

Priorizar con recuentos en vez de con intuición. Barre la vista compartida del espacio de trabajo en lugar de un solo hilo, cruza con el síntoma que describiste e informa de cuántas conversaciones distintas lo mencionan y cuándo llegó la primera. Dos reportes en un mes se leen muy distinto de nueve en dos días.

Tú preguntas

«Trae el log que pegó el cliente para que pueda reproducirlo en local.»

Herramientas llamadas

entergram_list_chatsentergram_list_messagesentergram_get_message

Obtienes

El agente localiza el hilo, retrocede hasta el mensaje que lleva la carga útil y lo recupera entero, no la vista previa recortada. Desde ahí puedes pedirle que convierta el log en un test que falle dentro del archivo que ya tienes abierto, que es la parte genuinamente más rápida que leer Telegram en una segunda pantalla.

Tú preguntas

«Pega estos pasos de reproducción en el ticket de este fallo.»

Herramientas llamadas

entergram_list_ticketsentergram_get_ticketentergram_create_ticket_comment

Obtienes

Tus notas aterrizan donde el equipo de soporte las va a buscar, escritas mientras el contexto sigue en tu cabeza. El comentario va pegado al ticket y no se envía al cliente, así que un ingeniero puede ser directo sobre la causa sin que nadie tenga que redactar antes una versión diplomática.

Tú preguntas

«¿En qué plan está quien reportó esto y qué le hemos dicho ya?»

Herramientas llamadas

entergram_list_custom_columnsentergram_get_chat_custom_fieldsentergram_list_chat_comments

Obtienes

Lee el esquema de columnas, recupera los valores puestos en ese chat y después lee las notas internas que dejaron tus compañeros. La respuesta llega en un párrafo: su nivel de plan, su estado de renovación si lo registras, y el compromiso que alguien adquirió en una llamada la semana pasada del que nunca te enteraste.

Tú preguntas

«El arreglo está fusionado. Avisa a las dos personas que lo reportaron y cierra el ticket.»

Herramientas llamadas

entergram_list_accountsentergram_send_messageentergram_update_ticket

Obtienes

El paso que todo el mundo se salta. Resuelve qué cuenta conectada es dueña de cada conversación, envía una nota breve por persona para que tú la apruebes, y mueve el ticket a cerrado cuando han salido. El bucle entre publicar el arreglo y contárselo al cliente afectado pasa de ser un pendiente a ser una instrucción.

Qué puede hacer tu editor con Telegram

  • Consultar chats de Telegram desde el editor
  • Detectar mensajes que se te pasaron mientras trabajas
  • Consultar contactos y campos del CRM al instante
  • Enviar mensajes y respuestas con tu aprobación
  • Cuantificar oportunidades perdidas y opiniones
  • Crear herramientas internas sobre datos reales de Telegram

Las 70 herramientas que recoge tu editor

Cursor, Zed y Windsurf reciben la misma lista (nueve grupos, setenta funciones con nombre) y todos imprimen las llamadas según el agente las hace, así que puedes ver cómo una pregunta se convierte en una secuencia e interrumpirla pronto. Cuáles de las setenta funcionan de verdad depende del nivel de acceso que haya detrás de la concesión, descrito más abajo.

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

Qué vive en el archivo de configuración y qué no

La entrada que pegas en mcp.json contiene exactamente una cosa: una dirección. Ni token, ni número de teléfono, ni clave de API, y por eso un .cursor/mcp.json de proyecto se puede versionar junto al código al que sirve. La concesión en sí se hace en un navegador, te pertenece a ti y no al repositorio, y la guarda el editor. Para retirarla, revoca la conexión desde la pantalla de MCP en Settings → Workspace → Connectors dentro de Entergram; el token que tiene el editor deja de funcionar en su siguiente llamada. Existen dos niveles de acceso y no son intercambiables.

Agente personal
Cualquier miembro puede emitirse uno, y en un portátil de desarrollo suele ser el techo correcto. Lee el espacio de trabajo, las cuentas, los contactos, los chats, los mensajes y los tickets, y solo escribe los campos personalizados de los chats que pertenecen a tus propias cuentas conectadas. Un agente con esto puede investigar un fallo hasta el fondo y no puede escribirle a quien lo reportó.
Conector del espacio de trabajo
Reservado a propietarios y administradores. Lleva el conjunto completo de permisos (enviar, escribir campos personalizados en cualquier chat, administrar grupos) y se comparte con el equipo en vez de pertenecer a un desarrollador. Úsalo cuando el editor trabaje en nombre de la empresa y no en el tuyo.
Revocación
Funciona desde cualquiera de los dos extremos y surte efecto al instante. Borrar el servidor de mcp.json hace que el editor deje de preguntar; revocar en Entergram hace que deje de recibir respuesta. La segunda es la que importa cuando el portátil ya no está en tus manos.

Dónde se detiene la integración con el editor

Conviene saberlo antes de construirte una rutina alrededor.

  • El acceso MCP está en el plan Pro, y nada del lado del editor cambia eso: un espacio de trabajo por debajo puede registrar el servidor, completar el inicio de sesión y aun así no recibir nada útil de una llamada.
  • No llega nada por sí solo. El editor consulta Entergram únicamente dentro de un turno que hayas iniciado tú, así que un mensaje que entra mientras estás en mitad de una refactorización espera en silencio hasta que preguntes por él.
  • La configuración es por máquina. mcp.json no viaja con tu cuenta del editor, y la concesión OAuth tampoco: un segundo portátil significa un segundo archivo y una segunda pantalla de consentimiento.
  • La salida de las herramientas se queda en la conversación. El agente puede citar el log de un cliente en un comentario o en un fixture, pero solo escribe en tus archivos cuando se lo pides, y nunca en sentido contrario.
  • Cada envío nombra una cuenta. account_id es un argumento obligatorio y no un valor por defecto, así que un agente que se equivoque de rama tampoco puede improvisar un mensaje a toda tu lista de contactos.
  • El conector ve exactamente lo que ve tu cuenta de Telegram. Un grupo en el que nunca te añadieron sigue siendo invisible desde el editor, se formule como se formule la pregunta.

Cuando el editor no ve Entergram

El servidor aparece con un punto rojo en el panel MCP de Cursor
Cursor cachea la lista de herramientas del último intercambio correcto. Desactiva y vuelve a activar el servidor en Cursor Settings → MCP & Integrations, y si el punto sigue rojo recarga la ventana: el agente lee la lista al arrancar la ventana, no cuando editas el archivo.
Zed ignora la entrada por completo
Casi seguro que escribiste mcpServers. La clave de Zed es context_servers, y una clave de primer nivel no reconocida se descarta en silencio en lugar de reportarse como error. Corrige el nombre de la clave, guarda y reinicia Zed.
Windsurf no muestra herramientas de Entergram tras guardar
Confirma que editaste ~/.codeium/windsurf/mcp_config.json y no la interfaz de ajustes, y después abre el panel MCP en Cascade y refréscalo. Windsurf relee ese archivo cuando se lo pides y no antes.
La pantalla de consentimiento se abre pero el editor sigue desconectado
La autorización termina en el navegador que abra tu sistema operativo por defecto. Completa ahí el inicio de sesión con la sesión de Entergram abierta en ese mismo perfil, vuelve al editor y lanza la acción de conectar una vez más.
El agente responde sobre Telegram sin llamar a nada
Hay demasiados servidores registrados y la lista de herramientas se está recortando antes de que el modelo la vea. Desactiva los servidores MCP que no uses para esta tarea y nombra Entergram en la instrucción para que la elección no tenga ambigüedad.
Las llamadas devuelven 403
Comprueba dos cosas y en este orden. Tu rol: un conector del espacio de trabajo exige propietario o administrador, y un agente personal cubre a todos los demás. Después tu plan: el acceso MCP vive en Pro, y un nivel inferior falla aquí y no al conectar.

Preguntas frecuentes sobre Cursor / Zed / Windsurf + Telegram

¿Qué editores son compatibles?
Cualquier editor que admita MCP mediante mcp.json, incluidos Cursor, Zed y Windsurf. Registra la URL del MCP de Entergram 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.
¿Puede decirme qué se me pasó mientras programaba?
Sí. Pregúntale a la IA de tu editor y leerá tus chats, contará los mensajes sin responder y señalará los que vienen de clientes.
¿Es seguro?
Sí. OAuth 2.0 con permisos acotados; tus credenciales nunca llegan al proveedor del editor y el acceso es revocable.

Conecta Telegram a Cursor e IDEs