Servidor MCP de Telegram: da a tus agentes de IA toda la Telegram Bot API, con seguridad

Por qué los agentes de IA necesitan una capa para Telegram

Los agentes de IA cada vez manejan mejor herramientas reales. Pueden leer un panel, decidir qué importa y dar el siguiente paso. Pero para actuar dentro de Telegram necesitan un puente: algo que convierta una frase como "fija el anuncio del AMA y abre un tema de preguntas" en las llamadas correctas a la API de Telegram.

Ese puente es un servidor MCP de Telegram.

El Model Context Protocol (MCP) es un estándar abierto que permite a clientes de IA como Claude, ChatGPT, Cursor y Codex descubrir herramientas e invocarlas. Un servidor MCP de Telegram expone acciones de Telegram como esas herramientas, con descripciones claras y esquemas de entrada que el modelo puede seguir.

Metricgram ya tiene uno funcionando para ti, respaldado por el bot que gestiona tus grupos.

Lo que implica realmente adaptar la Telegram Bot API

Sobre el papel, preparar la Bot API para un agente parece sencillo. En la práctica tienes que:

• Alojar un bot, mantener su token en secreto y que siga funcionando.
• Recibir actualizaciones mediante webhooks o polling.
• Escribir la definición de una herramienta para cada endpoint que quieras que use el agente.
• Impedir que el agente publique en chats que nunca debería tocar.
• Gestionar límites de frecuencia, supergrupos migrados y mensajes de error de Telegram.
• Hacer que los reintentos sean seguros, para que un fallo de red puntual no publique el mismo mensaje dos veces.
• Registrar lo que hizo el agente, por si luego tienes que explicarlo.

La mayoría de equipos se queda en "enviar un mensaje" porque todo lo demás es mucha fontanería. El resultado es un agente que sabe hablar, pero que no puede gestionar de verdad una comunidad.

Cómo funciona el servidor MCP de Telegram de Metricgram

Metricgram ya está dentro de tus grupos de Telegram como bot administrador (o como tu propio bot personalizado). El servidor MCP simplemente permite que tu cliente de IA use ese bot a través de un endpoint alojado:

1. Conecta tus grupos a Metricgram y da permisos de administrador al bot.
2. Añade el endpoint https://metricgram.com/api/v1/mcp a tu cliente de IA, por ejemplo como conector personalizado en Claude.
3. Inicia sesión y aprueba el acceso con OAuth. Y listo: sin servidores, webhooks ni tokens que gestionar. Los clientes sin OAuth pueden usar una clave de API con la configuración de abajo.

{
  "mcpServers": {
    "metricgram": {
      "url": "https://metricgram.com/api/v1/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Si usas Claude Desktop, puedes conectar el mismo endpoint con mcp-remote. Los fragmentos exactos para cada cliente están en la página MCP de tu Manager.

Más de 70 métodos de la Bot API, dos formas de usarlos

El servidor expone la Telegram Bot API en dos capas.

Herramientas tipadas para el día a día

Las tareas habituales tienen herramientas propias con parámetros descriptivos, lo que facilita que los modelos las usen correctamente:

• send_telegram_message con temas, respuestas y botones con URL
• send_telegram_media para fotos, vídeos, GIF, documentos, audio y stickers
• send_telegram_poll para encuestas y cuestionarios
• edit_telegram_message, delete_telegram_messages, react_to_telegram_message
• pin_telegram_message y forward_telegram_message
• manage_forum_topic para crear, renombrar, cerrar, reabrir o eliminar temas
• get_telegram_chat y get_telegram_chat_member para datos del chat en vivo
• handle_telegram_join_request, create_telegram_invite_link y update_telegram_chat_settings

Una pasarela completa a la Bot API

Todo lo demás pasa por telegram_bot_api. El agente envía el nombre oficial de un método de la Bot API y sus parámetros, por ejemplo setChatPermissions, banChatSenderChat, editMessageMedia, hideGeneralForumTopic o revokeChatInviteLink. La herramienta complementaria telegram_api_methods lista todos los métodos que puede usar la clave actual, así que el agente siempre sabe qué tiene disponible.

Seguridad: por qué el agente nunca elige un chat_id

La decisión de diseño más importante es lo que el agente no puede hacer.

• El chat está bloqueado. El agente envía un group_id de Metricgram. El servidor obtiene el chat_id de Telegram a partir de un grupo que te pertenece y rechaza cualquier otro chat.
• Se comprueban reenvíos y citas. Un mensaje solo se puede reenviar, copiar o citar desde tus propios grupos.
• Se excluyen las acciones globales del bot. Webhooks, pagos, cambios en el perfil del bot y salir de un grupo no están expuestos.
• Los botones son seguros. Los botones inline pueden abrir URL o copiar texto, pero no pueden disparar callbacks hacia el bot.
• Los permisos se ajustan a la confianza. telegram:read, telegram:write, telegram:moderate y telegram:admin son independientes, y puedes tener varias claves con distintos poderes.
• Los reintentos son idempotentes. Las herramientas de escritura aceptan una idempotency_key, así que una llamada repetida devuelve el primer resultado en lugar de actuar dos veces.
• Cada llamada queda registrada con la herramienta y el método de la Bot API utilizados.

El agente actúa como el bot a través de la Bot API oficial, nunca como tu cuenta personal de Telegram.

Contexto que un bot simple no tiene

Un simple envoltorio de la Bot API puede actuar, pero ve muy poco. El servidor MCP de Metricgram también expone inteligencia de comunidad:

• Resumen de analíticas y series temporales de actividad
• Miembros activos, historial de miembros y mensajes capturados
• Rankings y recompensas de gamificación
• Resúmenes con IA de lo que ha pasado en el grupo
• Salud de los suscriptores de Stripe y renovaciones en riesgo

Eso significa que un agente puede responder "¿quién dejó de participar este mes?" y después enviarles un mensaje cuidado, todo en la misma conversación.

Ejemplos de flujos de trabajo

Anuncio semanal. "Publica el anuncio semanal del AMA en Crypto Talk, fíjalo sin notificar a todos, abre un tema de preguntas para el AMA y crea un enlace de invitación que caduque el viernes."

Limpieza de moderación. "Revisa los últimos 200 mensajes en busca de enlaces de spam, elimínalos y restringe a quienes los enviaron durante 24 horas."

Informe de la comunidad. "Compara la actividad de esta semana con la de la anterior, lista los cinco miembros más activos y publica un breve mensaje de agradecimiento en el tema General."

Gestión de solicitudes de acceso. "Aprueba las solicitudes de acceso pendientes de usuarios que sean suscriptores activos y rechaza el resto."

Para quién es

• Propietarios de comunidades que quieren un asistente que se encargue del trabajo administrativo rutinario.
• Agencias que gestionan muchos grupos de clientes y quieren un solo agente para todos.
• Equipos de soporte y customer success que llevan comunidades de clientes en Telegram.
• Desarrolladores que quieren Telegram dentro de su stack de agentes sin mantener infraestructura de bots.

Cómo empezar

El servidor MCP está incluido en todos los planes de Metricgram y en la prueba gratuita de 14 días, así que puedes conectar un agente antes de pagar. La mayoría de los clientes se conectan con OAuth: pega la URL del servidor, inicia sesión y aprueba el acceso. Las claves de API siguen disponibles para los clientes sin OAuth.

Descubre más en la página del servidor MCP de Telegram y en el resumen de funciones MCP, y después crea tu primera clave desde el Manager.