GramClaw espone lo stesso motore Telegram in due modi: una REST API per le automazioni personalizzate e un server MCP (Model Context Protocol) remoto per gli agenti AI. Entrambi si autenticano con una chiave API che crei nelle Impostazioni, entrambi rispettano la stessa cadenza per account che mantiene in salute i tuoi account Telegram, ed entrambi richiedono un abbonamento attivo o una prova in corso.
In pratica: la REST API è per il codice — sincronizzare i contatti dal tuo prodotto, avviare una campagna quando un utente si registra, riversare le conversazioni nel tuo data warehouse. Il server MCP è per gli agenti — Claude Desktop, Claude Code, Cursor o il tuo agente ricevono strumenti per elencare le chat, leggere i messaggi, inviare risposte, eseguire broadcast e gestire la pipeline, senza scrivere una riga di codice.
Crea una chiave API
- 1
Apri Impostazioni → Chiavi API
Genera una chiave e scegli i suoi scope: read per elencare e leggere i dati, send per tutto ciò che scrive o invia messaggi. Limita ogni chiave al minimo indispensabile.
- 2
Copiala una sola volta
La chiave completa (gc_live_…) viene mostrata solo alla creazione: conservala in un gestore di segreti. Se trapela, eliminala nelle Impostazioni e smette di funzionare immediatamente.
- 3
Autenticati
REST: inviala come header Authorization: Bearer. MCP: inseriscila nell'URL del server come parametro key.
La REST API in un minuto
L'API copre l'intera superficie della piattaforma: account, chat, messaggi, contatti, campagne, broadcast, colonne della pipeline e analytics. Le richieste sono semplice JSON su HTTPS. La documentazione completa degli endpoint — ogni rotta, i suoi scope ed esempi di richiesta/risposta — vive nella pagina della documentazione API, e una specifica OpenAPI leggibile dalle macchine è disponibile su /openapi.json per la generazione di codice o da dare in pasto a un LLM.
Collega il server MCP
- 1
Copia l'URL del server
https://gramclaw.com/api/mcp?key=gc_live_… — la chiave ti identifica e ti autorizza allo stesso tempo, limitata agli account su cui può agire.
- 2
Aggiungilo al tuo client MCP
Claude Desktop, Claude Code, Cursor o qualsiasi client compatibile con MCP accetta l'URL di un server remoto. Nessuna installazione locale, nessun proxy.
- 3
Chiedigli lavoro vero
Una volta collegato, il tuo agente può cercare nelle chat, preparare e inviare risposte, lanciare campagne, controllare lo stato delle campagne e spostare le trattative lungo la pipeline — ogni invio è soggetto alla stessa cadenza per account del resto di GramClaw.
Buone pratiche
- Una chiave per ogni integrazione, con un nome corrispondente, così revocarne una non rompe mai le altre.
- Preferisci scope di sola lettura per dashboard e processi di analytics.
- Ruota le chiavi quando qualcuno lascia il team ed elimina quelle che non usi più: la revoca è immediata.
- Ricorda che gli invii via API e MCP sono veri messaggi Telegram dai tuoi veri account: vale lo stesso buon senso su consenso e volumi che vale nell'app.