Acceso API & MCP

Acceso API & MCP

Metricgram incluye una API pública y un servidor MCP para conectar tus propias herramientas, dashboards, automatizaciones o clientes de IA con los datos y operaciones disponibles en tu cuenta.

El servidor MCP está disponible en todos los planes de pago y durante la prueba gratuita de 14 días. Los clientes de IA pueden conectarse con OAuth (pegando la URL del servidor y aprobando el acceso) o con una clave de API. La API REST requiere acceso Elite. Si tu cuenta no la incluye, la sección API puede aparecer bloqueada o mostrar un aviso para mejorar el plan.

Dónde encontrarlo

Abre Integraciones > MCP o Integraciones > API en el panel de gestión. Desde ahí, las cuentas con acceso pueden crear tokens de API, revisar tokens activos, revocarlos y ver la referencia técnica disponible para su plan.

Cómo funcionan los tokens

• Los tokens pertenecen a tu cuenta de usuario de Metricgram, no a un grupo concreto.
• Un token puede acceder a los grupos y recursos que tu cuenta puede gestionar.
• Los tokens incluyen permisos para áreas como grupos, miembros, mensajes, automatizaciones, suscriptores, analítica, tickets de soporte, referidos y MCP.
• Algunos endpoints solo consultan datos; otros pueden crear, actualizar, moderar o lanzar acciones según los permisos del token.
• El valor del token solo se muestra una vez al crearlo. Guárdalo en un lugar seguro.

Telegram Bot API a través de MCP

El servidor MCP también expone una Telegram Bot API limitada a tus grupos, para que los agentes de IA actúen en ellos a través del bot de Metricgram o de tu bot personalizado.

• Usa telegram_api_methods para ver los métodos que tu token puede llamar y telegram_bot_api para llamar a cualquiera de ellos con los parámetros oficiales de la Bot API.
• Las herramientas tipadas cubren el trabajo diario: send_telegram_message, send_telegram_media, send_telegram_poll, pin_telegram_message, manage_forum_topic, create_telegram_invite_link y más.
• El chat siempre es uno de tus propios grupos. Nunca envías un chat_id; Metricgram lo obtiene a partir del group_id.
• Las acciones de Telegram usan sus propios permisos: telegram:read, telegram:write, telegram:moderate y telegram:admin. Los tokens creados antes de que existieran estos permisos deben volver a crearse para poder usarlos.
• Los archivos multimedia deben ser una URL HTTPS pública o un file_id de Telegram, y los botones inline solo pueden abrir URL o copiar texto.
• Las herramientas de escritura aceptan una idempotency_key opcional, para que una llamada repetida no actúe dos veces.

Autenticación y límites

Las peticiones usan la cabecera Authorization: Bearer mg_.... El límite por defecto es de 600 peticiones por minuto por token, y el formulario permite elegir un valor dentro del mínimo y máximo permitidos por la app.

Si revocas un token, la cuenta pierde acceso a la API o el plan deja de incluir API & MCP, las peticiones con ese token serán rechazadas.

Buenas prácticas

• Crea tokens separados para cada herramienta externa.
• Usa nombres claros para identificar dónde se usa cada token.
• Revoca los tokens que ya no necesites.
• No compartas tokens en chats, capturas, tickets ni repositorios públicos.