GramClaw expone el mismo motor de Telegram de dos maneras: una API REST para automatización a medida y un servidor MCP (Model Context Protocol) remoto para agentes de IA. Ambos se autentican con una clave de API que creas en Ajustes, ambos respetan la misma dosificación por cuenta que mantiene sanas tus cuentas de Telegram y ambos requieren una suscripción o una prueba activa.
En la práctica: la API REST es para código — sincroniza contactos desde tu producto, dispara una campaña cuando un usuario se registra, vuelca conversaciones a tu almacén de datos. El servidor MCP es para agentes — Claude Desktop, Claude Code, Cursor o tu propio agente obtiene herramientas para listar chats, leer mensajes, enviar respuestas, ejecutar difusiones y gestionar el pipeline, sin escribir código.
Crea una clave de API
- 1
Abre Ajustes → Claves de API
Genera una clave y elige sus permisos: lectura para listar y leer datos, envío para todo lo que escribe o manda mensajes. Limita cada clave al mínimo que necesite.
- 2
Cópiala una sola vez
La clave completa (gc_live_…) se muestra únicamente al crearla — guárdala en un gestor de secretos. Si se filtra, elimínala en Ajustes y deja de funcionar de inmediato.
- 3
Autentícate
REST: envíala como cabecera Authorization: Bearer. MCP: colócala en la URL del servidor como el parámetro key.
La API REST en un minuto
La API cubre toda la superficie de la plataforma: cuentas, chats, mensajes, contactos, campañas, difusiones, columnas del pipeline y analíticas. Las solicitudes son JSON simple sobre HTTPS. La documentación completa de endpoints —cada ruta, sus permisos y ejemplos de solicitud y respuesta— vive en la página de documentación de la API, y hay una especificación OpenAPI legible por máquina disponible en /openapi.json para generar código o para entregársela a un LLM.
Conecta el servidor MCP
- 1
Copia la URL del servidor
https://gramclaw.com/api/mcp?key=gc_live_… — la clave te identifica y te autoriza a la vez, limitada a las cuentas sobre las que puede actuar.
- 2
Añádela a tu cliente MCP
Claude Desktop, Claude Code, Cursor o cualquier cliente compatible con MCP acepta una URL de servidor remoto. Sin instalación local, sin proxy.
- 3
Pídele trabajo de verdad
Una vez conectado, tu agente puede buscar chats, redactar y enviar respuestas, lanzar campañas, comprobar el estado de las campañas y mover negociaciones por el pipeline — cada envío sujeto a la misma dosificación por cuenta que el resto de GramClaw.
Buenas prácticas
- Una clave por integración, con su nombre correspondiente, para que revocar una cosa nunca rompa otra.
- Prefiere permisos de solo lectura para paneles y trabajos de analítica.
- Rota las claves cuando alguien deje el equipo y elimina las claves que ya no uses: la revocación es instantánea.
- Recuerda que los envíos por API y MCP son mensajes reales de Telegram desde tus cuentas reales: se aplica el mismo criterio de consentimiento y volumen que en la app.