Telegram MCP Solución de problemas: ¿Conectado, pero sin herramientas ni chats?

Si Telegram MCP dice que está conectado pero tu asistente no puede encontrar herramientas ni chats, comprueba la conexión en este orden: instalación → autorización del navegador → identidad → una lectura limitada. Un indicador de conexión del servidor por sí solo no prueba que el asistente pueda recuperar mensajes de la Telegram cuenta prevista.

Chiho proporciona conversaciones de cuenta existentes autorizadas de Telegram a un cliente de IA como Codex, Claude o ChatGPT. Un bot de Telegram o un Canal de Claude que entrega instrucciones a un agente en ejecución cumple un propósito distinto; esa conexión por sí sola no establece acceso a tu archivo personal de conversaciones. El acceso real depende de la identidad de la cuenta, de los permisos concedidos, de cualquier permiso de Telegram Business, de la cobertura del historial y de las herramientas disponibles. La guía de arquitectura explica cómo elegir la ruta de acceso correcta.

Publicado por Chiho. Esta guía se basa en la fuente de Chiho y en la documentación actual del cliente verificada en 6 octubre 2026. Es un procedimiento de diagnóstico, no un informe de pruebas exitosas en una cuenta de cliente. Los ejemplos son sintéticos; la disponibilidad de herramientas depende del producto conectado y de la versión del recurso. La imagen de encabezado existente muestra el contexto general de la interfaz de Chiho, no un resultado de solución de problemas.

Empieza por la primera pieza de evidencia que falta

Recorre esta lista y detente en la primera comprobación fallida:

1. No hay conexión de Chiho en este cliente: verifica la instalación en esta aplicación y espacio de trabajo exactos.
2. La conexión existe, pero se requiere inicio de sesión: completa la autorización del navegador para esa conexión.
3. Las herramientas no están disponibles: inspecciona el conjunto de herramientas descubierto por el cliente, el recurso seleccionado y las restricciones.
4. La identidad es incorrecta o no aparece ninguna cuenta saludable de Telegram: verifica la conexión Chiho y la cuenta Telegram dentro de ella.
5. Una lectura tiene éxito pero no devuelve nada útil: comprueba el chat seleccionado, el intervalo de tiempo, la paginación y la cobertura.
6. Una lectura informa de una espera o un error: gestiona ese resultado antes de reintentar o ampliar la solicitud.

No resuelvas todos los síntomas borrando y reinstalando todas las conexiones. Conserva las conexiones que funcionan mientras identificas qué capa falló.

Comprueba la instalación en el cliente que realmente estás usando

Empieza desde la página de configuración mantenida de Chiho MCP. Registra la aplicación, la etiqueta de conexión seleccionada y la URL del recurso configurado sin credenciales. Chiho CRM y el producto de cliente Telegram separado no prometen herramientas idénticas; los recursos versionados también conservan contratos distintos. Compara con las instrucciones de configuración del producto instalado, no con un recuento de herramientas recordado.

Para Codex, verifica que esta superficie en ejecución pueda ver la configuración prevista de MCP. Para un servidor OAuth configurado manualmente, codex mcp login <server-name> inicia su inicio de sesión en el navegador; usa el nombre configurado existente. Instalar un complemento en otra aplicación no prueba que esté disponible aquí. Consulta la referencia de Codex MCP y la guía de Chiho ChatGPT/Codex.

Para Claude Code, usa /mcp para inspeccionar la conexión y autenticar un servidor OAuth remoto cuando se te solicite. Un conector configurado en otra superficie de Claude aún debe estar disponible en la superficie que estás usando. Sigue la referencia de Claude Code MCP y la guía de Chiho Claude.

Para ChatGPT, inspecciona el complemento instalado y su cuenta conectada en el espacio de trabajo actual. La disponibilidad puede depender de la superficie compatible y de la política del espacio de trabajo. Sigue las instrucciones de conexión de cuenta de OpenAI, y luego comprueba la conexión seleccionada para esta conversación.

Un Canal de Claude que te permite enviar mensajes a un agente a través de Telegram no es prueba de que el agente tenga un conector de historial de cuenta. Identifica la integración antes de cambiar su configuración.

Separa la autorización del navegador de la salud de la cuenta de Telegram

Completa el flujo de consentimiento del navegador de Chiho y vuelve al mismo cliente. Comprueba la cuenta de Chiho prevista, el ámbito personal o de equipo y los permisos solicitados. La configuración interactiva no requiere copiar un token de servicio en un prompt o ticket de soporte.

Cuando el conjunto de herramientas conectado lo exponga, ejecuta auth_status y luego account_whoami:

• auth_status informa del ámbito autenticado, los ámbitos de capacidad, el modo de aprobación y el recuento de cuentas de Telegram saludables y accesibles.
• account_whoami informa de las cuentas de Telegram accesibles y de los indicadores de conexión o de nueva autorización. Revisa los detalles identificativos de forma privada.

Una conexión autenticada de Chiho sin ninguna cuenta de Telegram saludable es un resultado distinto de una autorización de MCP fallida. Reconecta Telegram a través de Chiho cuando el estado de su cuenta requiera nueva autorización; repetir solo el inicio de sesión OAuth del cliente de IA no demuestra que la sesión de Telegram se haya recuperado.

En las conexiones CRM v9 que exponen get_profile, úsalo para verificar la identidad y el ámbito de Chiho antes de seleccionar una cuenta de Telegram. Los recursos antiguos y el producto de cliente separado de Telegram conservan sus propios contratos, por lo que la ausencia de esta herramienta por sí sola no es un fallo. get_profile no lee mensajes de Telegram. Un accountId selecciona una cuenta de Telegram dentro de una conexión autorizada; no puede cambiar a una conexión de Chiho diferente.

Si existen dos conexiones con nombre, pide al asistente que use solo la intención prevista y que se detenga ante una discordancia de identidad. Comprueba una tarea programada por separado de un chat interactivo: una selección correcta en una conversación no prueba que la tarea vaya a usar la misma conexión.

Cuando la conexión existe pero faltan herramientas

Pide al asistente que inspeccione las herramientas realmente disponibles en esta conversación. No le permitas inventar una llamada a partir de un nombre de herramienta encontrado en una guía antigua. Los clientes pueden descubrir herramientas bajo demanda, y los nombres pueden presentarse de forma diferente entre superficies del producto.

Compara tres cosas: el recurso y la versión configurados, el ámbito autenticado de la cuenta/equipo y las herramientas permitidas del cliente. Chiho filtra su lista de herramientas autenticadas por ámbito y capacidades. Por lo tanto, una conexión personal y una conexión con ámbito de equipo no tienen por qué exponer operaciones idénticas.

Si la autorización caducó o el permiso fue revocado, usa el flujo de reconexión del cliente y repite la comprobación de identidad. Los tokens están vinculados a su recurso y entorno; copiar una credencial de producción a un endpoint de staging, o cambiar una URL de recurso conservando su permiso antiguo, no es una reparación. Un recurso nuevo requiere su propia autorización. No debilites los controles del espacio de trabajo ni habilites escrituras solo para diagnosticar una herramienta de lectura faltante.

Después de corregir la configuración, actualiza la conexión usando los controles compatibles del cliente. Confirma de nuevo el descubrimiento antes de intentar una solicitud de historial. Si el descubrimiento sigue fallando, captura el error saneado y deja de alternar entre inicios de sesión.

Cuando las herramientas funcionan pero parece que faltan chats o mensajes

Elige una conversación conocida y autorizada, y un período corto con un mensaje que puedas reconocer por ti mismo. Mantén esta primera prueba pequeña. Una solicitud de diagnóstico sugerida es:

Usa solo la conexión Chiho prevista. Verifica primero su identidad y la cuenta Telegram. Lee hasta cinco mensajes del único chat autorizado que yo especifique. Devuelve el período real cubierto, las referencias de los mensajes y un breve resumen factual. Indica cualquier cobertura parcial o error. No envíes mensajes, importes chats, cambies registros ni crees tareas. Detente si la identidad es ambigua.

Trata la evidencia resultante con cuidado:

• El historial de Telegram y el inventario de CRM difieren. Una fila guardada de CRM que falta no prueba que la conversación no exista en Telegram. Una fila listada no prueba que se haya recuperado su historial completo de mensajes. Consulta contactos, diálogos y recuentos de CRM.
• El alcance importa. Las lecturas del equipo requieren conversaciones visibles para el equipo. No cambies a un contexto personal más amplio solo para eludir una restricción del equipo.
• Los criterios de búsqueda importan. La implementación alojada de búsqueda de mensajes de CRM admite búsqueda Telegram; los filtros locales, por etiqueta y por empresa no se admiten allí. La búsqueda de mensajes con alcance de equipo requiere un chat seleccionado. Usa el esquema actual de la herramienta en lugar de copiar filtros no admitidos.
• Una página no es el archivo completo. Indica la cuenta, la conversación, el período devuelto y cualquier continuación o resultado parcial. Sigue solo la paginación admitida por la herramienta.
• Vacío es una observación acotada. Que no haya coincidencias para una frase o período no demuestra que un compromiso nunca existiera. Vuelve a comprobar el alcance y un mensaje conocido antes de hacer una afirmación más amplia.

Por ejemplo, una prueba sintética podría devolver cinco mensajes recientes mientras la decisión conocida tiene un mes de antigüedad. Eso demuestra que se leyó una página reciente; no demuestra que la búsqueda esté rota ni que la decisión esté ausente. Una segunda solicitud acotada para el período adecuado puede distinguir esos casos sin solicitar el archivo completo de la cuenta.

Respeta las respuestas de espera y separa las lecturas de las reparaciones que escriben

Si chat_read devuelve rate_limited, espera retryAfterSeconds devuelto antes de volver a leer esa cuenta. No inicies lecturas paralelas contra la misma cuenta ni sigas reintentando durante la espera. La fuente de Chiho aplica un retroceso de Telegram a nivel de cuenta; las suposiciones estáticas sobre la tasa de solicitudes no sustituyen la respuesta en tiempo de ejecución.

Si ya estás inspeccionando una sincronización de inventario, waiting_for_telegram y resumeAt describen una espera en ese trabajo. No significan que el trabajo se haya completado. Iniciar una nueva sincronización es una acción aparte que puede actualizar el inventario almacenado; no es necesario solo para demostrar la autorización de MCP.

Que la petición HTTP tenga éxito tampoco demuestra que la herramienta haya tenido éxito. Revisa el indicador de error y el resultado de la herramienta, y luego comprueba si realmente se devolvieron los mensajes solicitados. Ante un tiempo de espera agotado, conserva la solicitud acotada y el estado informado; no la amplíes de inmediato a múltiples lecturas.

Revisa los permisos de la herramienta antes de intentar una reparación que cambie algo. Chiho aplica alcance, capacidades y salvaguardas de ejecución, pero no toda escritura de un agente espera una aprobación separada de Chiho. Algunos envíos y cambios de CRM/tareas pueden ejecutarse después de los controles del lado del cliente. Mantén este diagnóstico solo en modo lectura; usa la lista de verificación de seguridad antes de habilitar deliberadamente un flujo de trabajo más amplio.

Envía un registro de soporte pequeño y saneado si la comprobación sigue fallando

Un registro útil identifica la capa que falló sin exponer la conversación:

• Hora UTC, nombre/versión del cliente y si se trató de un chat interactivo o de una tarea programada.
• URL del producto/recurso sin tokens ni credenciales de consulta; reemplaza las etiquetas de conexión privadas por etiquetas neutrales.
• Último paso correcto: instalado, autorizado, identidad verificada, herramientas detectadas o lectura acotada completada.
• Nombre de la herramienta que falló, código de error seguro, ID de solicitud si se expone y duración de espera devuelta.
• Comportamiento esperado frente al observado, usando una etiqueta de chat ficticia e indicando si el resultado fue vacío, parcial o un error.

No adjuntes tokens de acceso, URLs de devolución de llamada OAuth, códigos de inicio de sesión Telegram, cadenas de sesión, cargas útiles brutas de la herramienta, historial de mensajes ni capturas que contengan detalles de la cuenta. Puedes decir “se esperaba la conexión A, se observó la conexión B” sin enviar identificadores de perfil ni nombres de cuenta.

Un resumen sintético de soporte podría decir: “Claude Code; chat interactivo; identidad verificada; la lectura de un solo chat devolvió un código de límite de velocidad y una duración de espera; no se intentaron reintentos paralelos.” Le da a soporte un límite concreto sin copiar contenido del cliente.

Finaliza con una única lectura verificada respaldada por la fuente

La recuperación está completa para esta prueba cuando se confirma la conexión prevista y la cuenta de Telegram, la herramienta necesaria está disponible y una solicitud acotada devuelve los mensajes de origen esperados con cobertura clara. Un indicador de conexión en verde o una respuesta fluida sin evidencia recuperada es insuficiente.

Vuelve a la guía de configuración de Chiho, completa la instalación y la autorización del navegador, verifica la identidad y lee una conversación autorizada. Cuando eso funcione, usa el flujo de trabajo del resumen de la bandeja de entrada para ampliar de forma deliberada. Mantén la primera lectura exitosa como tu comprobación de aceptación antes de habilitar revisiones o escrituras programadas.