GramClaw expose le même moteur Telegram de deux manières : une API REST pour l'automatisation sur mesure, et un serveur MCP (Model Context Protocol) distant pour les agents IA. Les deux s'authentifient avec une clé API créée dans les Paramètres, les deux respectent le même cadencement par compte qui garde vos comptes Telegram en bonne santé, et les deux nécessitent un abonnement ou un essai actif.
En pratique : l'API REST est pour le code — synchroniser des contacts depuis votre produit, déclencher une campagne à l'inscription d'un utilisateur, alimenter votre entrepôt de données avec vos conversations. Le serveur MCP est pour les agents — Claude Desktop, Claude Code, Cursor ou votre propre agent reçoit des outils pour lister les discussions, lire les messages, envoyer des réponses, lancer des diffusions et gérer le pipeline, sans écrire une ligne de code.
Créer une clé API
- 1
Ouvrez Paramètres → Clés API
Générez une clé et choisissez ses portées — read pour lister et lire les données, send pour tout ce qui écrit ou envoie des messages. Limitez chaque clé au strict nécessaire.
- 2
Copiez-la une seule fois
La clé complète (gc_live_…) ne s'affiche qu'à la création — stockez-la dans un gestionnaire de secrets. En cas de fuite, supprimez-la dans les Paramètres et elle cesse de fonctionner immédiatement.
- 3
Authentifiez-vous
REST : envoyez-la dans un en-tête Authorization: Bearer. MCP : placez-la dans l'URL du serveur en tant que paramètre key.
L'API REST en une minute
L'API couvre toute la surface de la plateforme : comptes, discussions, messages, contacts, campagnes, diffusions, colonnes de pipeline et analytique. Les requêtes sont du simple JSON sur HTTPS. La documentation complète des points de terminaison — chaque route, ses portées et des exemples de requête/réponse — se trouve sur la page de documentation de l'API, et une spécification OpenAPI lisible par machine est disponible à /openapi.json pour la génération de code ou pour être confiée à un LLM.
Connecter le serveur MCP
- 1
Copiez l'URL du serveur
https://gramclaw.com/api/mcp?key=gc_live_… — la clé vous identifie et vous autorise à la fois, avec une portée limitée aux comptes sur lesquels elle peut agir.
- 2
Ajoutez-la à votre client MCP
Claude Desktop, Claude Code, Cursor ou tout client compatible MCP accepte une URL de serveur distant. Aucune installation locale, aucun proxy.
- 3
Demandez du vrai travail
Une fois connecté, votre agent peut rechercher des discussions, rédiger et envoyer des réponses, lancer des campagnes, vérifier l'état des campagnes et faire avancer des affaires dans le pipeline — chaque envoi étant soumis au même cadencement par compte que le reste de GramClaw.
Bonnes pratiques
- Une clé par intégration, nommée en conséquence, pour que révoquer une chose n'en casse jamais une autre.
- Préférez les portées en lecture seule pour les tableaux de bord et les tâches d'analytique.
- Faites tourner les clés quand des collègues quittent l'équipe et supprimez les clés que vous n'utilisez plus — la révocation est instantanée.
- N'oubliez pas que les envois via l'API et le MCP sont de vrais messages Telegram depuis vos vrais comptes : le même discernement sur le consentement et le volume s'applique que dans l'application.