Servidor MCP de Telegram para agentes de IA
Metricgram convierte la Telegram Bot API en un servidor MCP alojado para que tu agente de IA lea, publique, modere y administre tus grupos de Telegram con claves con permisos acotados y sin código de bot que mantener.
- Más de 70 métodos de la Telegram Bot API como herramientas MCP
- Funciona con Claude, ChatGPT, Cursor y Codex
- Cada llamada se limita a tus propios grupos
- Analíticas, miembros y suscriptores en el mismo servidor
Sin tarjeta de crédito
Configúralo en 2 minutos
Cómo funciona
1
Añade el bot y conecta tus grupos
Añade el bot de Metricgram (o tu propio bot personalizado) como administrador de tus grupos de Telegram. Sin servidores, webhooks ni polling que mantener.
2
Crea una clave de API con permisos
Genera una clave de API Elite y elige exactamente qué puede hacer el agente, desde acceso de solo lectura a Telegram hasta publicar, moderar o cambiar la configuración del chat.
3
Conéctalo a tu cliente de IA
Pega un bloque de configuración en Claude, Cursor, Codex o cualquier cliente MCP. Tu agente verá cada acción de Telegram permitida como una herramienta.
Un prompt, acciones reales en Telegram
Tu agente elige las llamadas correctas a la Bot API, Metricgram las ejecuta en el grupo adecuado y devuelve resultados estructurados.
metricgram · mcp
Tú pides
Publica el anuncio del AMA de esta semana en Crypto Talk, fíjalo sin notificar, abre un tema «Preguntas AMA» y dame un enlace de invitación que caduque el viernes.
El agente llama a
- send_telegram_message(group_id: 42, text: "…", buttons: [{ url: "…" }])
- pin_telegram_message(group_id: 42, action: "pin", disable_notification: true)
- manage_forum_topic(group_id: 42, action: "create", name: "…")
- create_telegram_invite_link(group_id: 42, expire_date: "2026-10-23T23:59:00Z")
Conecta cualquier cliente MCP
Usa el endpoint alojado con tu clave de API. Si usas Claude Desktop, puedes conectarlo mediante mcp-remote.
{
"mcpServers": {
"metricgram": {
"url": "https://metricgram.com/api/v1/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Herramientas que recibe tu agente
Mensajes y multimedia
send_telegram_message
send_telegram_media
send_telegram_poll
edit_telegram_message
delete_telegram_messages
forward_telegram_message
react_to_telegram_message
Mensajes fijados y temas de foro
pin_telegram_message
manage_forum_topic
createForumTopic
closeGeneralForumTopic
unpinAllForumTopicMessages
Moderación y solicitudes de acceso
ban_member
restrict_member
promote_member
handle_telegram_join_request
banChatSenderChat
setChatAdministratorCustomTitle
Configuración del chat y enlaces de invitación
update_telegram_chat_settings
create_telegram_invite_link
revokeChatInviteLink
setChatPermissions
setChatStickerSet
Analíticas y datos de la comunidad
analytics_overview
active_users
list_members
list_messages
gamification_rankings
get_subscriber_health
Cualquier método compatible de la Bot API
telegram_api_methods
telegram_bot_api
get_telegram_chat
get_telegram_chat_member
La Telegram Bot API, preparada para agentes de IA
Integrar Telegram en un agente suele implicar alojar un bot, gestionar webhooks, guardar tokens y escribir una herramienta para cada endpoint. Metricgram ya tiene el bot funcionando dentro de tus grupos, así que tu agente recibe la Bot API como herramientas MCP listas para usar desde un único endpoint alojado.
Herramientas tipadas y una pasarela completa a la Bot API
Las tareas habituales, como enviar mensajes, multimedia, encuestas, fijar mensajes, crear temas o enlaces de invitación, tienen herramientas propias y bien descritas. Todo lo demás pasa por telegram_bot_api, que acepta los nombres y parámetros oficiales de la Bot API, de modo que nada del catálogo compatible queda fuera de alcance.
Limitado a tus propios grupos
El agente nunca elige un chat_id. Metricgram lo obtiene del grupo que te pertenece, comprueba los mensajes reenviados y citados contra tus otros grupos y rechaza cualquier cosa que pueda llegar a otro chat.
Permisos para cada nivel de confianza
Concede telegram:read a agentes de investigación, telegram:write para publicar y crear temas, telegram:moderate para expulsiones y solicitudes de acceso, y telegram:admin para títulos, permisos y enlaces de invitación. Puedes revocar las claves en cualquier momento.
Reintentos seguros y errores claros
Las herramientas de escritura aceptan una clave de idempotencia, así que una llamada repetida nunca publica dos veces. Los errores y límites de Telegram se devuelven como resultados estructurados con retry_after, que el agente puede gestionar por su cuenta.
Contexto que un bot simple no tiene
El mismo servidor expone las analíticas de Metricgram, el historial de miembros, los mensajes capturados, la gamificación, los resúmenes con IA y la salud de los suscriptores de Stripe, para que tu agente decida qué hacer antes de actuar.
Metricgram vs. Gestión manual
| Metricgram | Manual | |
|---|---|---|
| Endpoint MCP alojado, sin servidor de bot que mantener | ||
| Más de 70 métodos de la Telegram Bot API como herramientas | ||
| chat_id limitado a tus propios grupos | ||
| Claves de API por permiso que puedes revocar | ||
| Reintentos idempotentes en herramientas de escritura | ||
| Analíticas e historial de miembros como contexto | ||
| Datos del chat en vivo, administradores y permisos | ||
| Funciona con tu propio bot personalizado |
Preguntas frecuentes
¿Qué es un servidor MCP de Telegram?
Es un servidor Model Context Protocol que expone acciones de Telegram como herramientas que un agente de IA puede invocar. Metricgram aloja uno por ti, respaldado por el bot que ya gestiona tus grupos.
¿Con qué clientes de IA funciona?
Con cualquier cliente que hable MCP sobre HTTP, como Claude Code, Claude Desktop (mediante mcp-remote), Cursor, Codex y agentes propios creados con los SDK de OpenAI o Anthropic.
¿Cubre toda la Telegram Bot API?
Cubre más de 70 métodos relacionados con grupos, incluidos mensajes, multimedia, encuestas, ediciones, reacciones, mensajes fijados, temas de foro, moderación, solicitudes de acceso, configuración del chat y enlaces de invitación. Los métodos que afectarían a otros chats o al propio bot, como webhooks, pagos o salir de un grupo, se excluyen a propósito.
¿Puede un agente publicar en grupos que no son míos?
No. Cada llamada está vinculada a uno de tus grupos conectados. Metricgram fija el chat_id, y los reenvíos o respuestas solo pueden hacer referencia a tus propios grupos.
¿Es la API de usuario de Telegram (MTProto)?
No. Usa la Bot API oficial a través del bot de tu grupo, así que el agente actúa como el bot y nunca como tu cuenta personal de Telegram.
¿Qué plan incluye el servidor MCP?
El acceso a MCP y a la API forma parte del plan Elite. La prueba gratuita de 14 días incluye acceso de nivel Elite, así que puedes conectar un agente antes de pagar.
¿Puedo limitar lo que el agente puede hacer?
Sí. Cada clave de API tiene sus propios permisos, y puedes crear claves distintas para investigación de solo lectura, publicación, moderación y administración.
Sigue explorando
Encuentra una guía práctica, explora comunidades activas o descubre más formas de usar Metricgram.
Guías
Blog
Lee guías prácticas sobre crecimiento, monetización, moderación y gestión de comunidades en Telegram.
ExplorarDirectorio de comunidades
Directorio de comunidades de Telegram
Explora comunidades activas de Telegram por categoría, idioma y posicionamiento.
ExplorarHub de sección
Soluciones
Consulta todas las páginas de esta sección de un vistazo.
ExplorarExplora más
Herramienta de gestión de grupos de Telegram
Analíticas y métricas para grupos de Telegram
Bot de Telegram para gestión de grupos
Automatiza tu grupo de Telegram
Bot de membresía de Telegram para comunidades de pago
Bot de pagos de Telegram para grupos y canales
Bot de suscripciones de Telegram para ingresos recurrentes
Monetización de canales de Telegram de forma sencilla
Crea y gestiona un grupo VIP de Telegram
Convierte el soporte por Telegram en inteligencia de cuentas
MCP
API
Chatbots IA Asistentes