Vai al contenuto principale
Tutti i connettori Telegram MCP

Gemini · Google

Gemini Telegram MCP - per Gemini e la CLI

Usa Entergram come server Telegram MCP per Google Gemini e la Gemini CLI: dai a Gemini un accesso sicuro e limitato da OAuth alle tue vere chat Telegram, così può far emergere messaggi persi, clienti in attesa e lead raffreddati.

URL del server MCP https://mcp.entergram.com/mcp

Collega Gemini in 3 passaggi

Funziona con la Gemini CLI e con i client Gemini compatibili con MCP.

URL del server MCP https://mcp.entergram.com/mcp
  1. Parti da Entergram: in Settings → Workspace → Connectors → MCP trovi l'URL del tuo server. Copialo negli appunti, perché la Gemini CLI lo legge da un file di configurazione e non da un campo di testo.

  2. Aggiungi Entergram alla configurazione MCP della Gemini CLI con l'URL: https://mcp.entergram.com/mcp.

  3. Avvia di nuovo la CLI perché rilevi il nuovo server, accedi a Entergram nel browser che si apre e concedi un accesso limitato al tuo workspace.

Chiedi a Gemini ciò che Telegram non sa dirti

Con il tuo account personale collegato, Gemini analizza tutte le chat insieme. Prova prompt come questi:

  1. “Quali chat hanno domande senza risposta negli ultimi tre giorni?”

  2. “Elenca i contatti del mio gruppo clienti che non sono nel gruppo della community.”

  3. “Pubblica il contenuto di build.log nel canale dei rilasci.”

  4. “Crea un canale chiamato Launch Updates e invita il team principale.”

  5. “Correggi il refuso nel mio ultimo messaggio nella conversazione con Acme.”

  6. “Esporta i ticket di questo mese in TSV così li incollo in un foglio di calcolo.”

Cosa può fare Gemini con il tuo Telegram

Sia la Gemini CLI sia i client Gemini compatibili con MCP possono registrare server MCP esterni. Aggiungi l'URL di Entergram e Gemini ottiene un accesso limitato e protetto da OAuth al tuo vero account Telegram personale: nessun bot da mantenere, nulla da programmare, nessuna chiave API da conservare.

  1. Interrogare le tue chat senza uscire dal terminale

  2. Confrontare un elenco clienti con i membri di una community

  3. Pubblicare l'output di una build o un file direttamente in una chat

  4. Creare un canale e popolarlo con i membri giusti

  5. Correggere un messaggio sul posto invece di reinviarlo

  6. Esportare i dati dei ticket come testo separato da tabulazioni per un foglio di calcolo

Lavori da terminale che vale la pena collegare

Nella CLI sono invocazioni di una riga che puoi mettere dietro un alias della shell o un git hook. Ogni richiesta in linguaggio naturale si espande in una sequenza di chiamate, e la CLI stampa quali ha eseguito, così vedi il meccanismo prima di affidargli una scrittura. Tutto ciò che segue presuppone che il server sia registrato e autorizzato una volta; dopo, basta scrivere.

Scopri di più

Chiedi

“Pubblica nel canale beta le note di rilascio da CHANGELOG.md.”

Strumenti chiamati

entergram_list_accountsentergram_list_groupsentergram_send_message

Ottieni

Il passaggio post-deploy che nessuno ricorda. Gemini ha già il changelog in contesto dal repo, sceglie l'account che amministra il canale, trova il canale per nome e pubblica. Agganciato a una build riuscita, l'annuncio smette di dipendere dalla memoria di qualcuno.

Chiedi

“Chi c'è nel canale beta che non abbiamo mai segnato come cliente pagante?”

Strumenti chiamati

entergram_list_group_membersentergram_list_contactsentergram_get_chat_custom_fields

Ottieni

Una differenza tra insiemi su due sistemi che di solito vivono in schede diverse del browser. Elenca i membri del canale, li confronta con i tuoi contatti, poi legge i campi CRM per vedere chi ha il contrassegno di cliente. Ottieni, nome per nome, la metà della tua community che non si è ancora convertita.

Chiedi

“Manda l'output del test che fallisce alla conversazione con Acme, con una breve spiegazione.”

Strumenti chiamati

entergram_list_chatsentergram_send_media_message

Ottieni

Il file è già sul disco accanto a te, quindi salti tutta la trafila del caricamento. Gemini allega il file e scrive da solo la riga di accompagnamento: è la differenza tra un cliente che vede un muro di stack trace e un cliente che vede cosa si è rotto e quando sarà risolto.

Chiedi

“Crea un canale per il lancio, dagli un nome come si deve e aggiungi il team di rilascio.”

Strumenti chiamati

entergram_create_channelentergram_update_chat_infoentergram_invite_chat_members

Ottieni

Tre passaggi nell'interfaccia di Telegram diventano una frase. Il canale viene creato, titolo e descrizione vengono impostati da ciò che hai descritto e l'elenco degli invitati viene ricavato dai tuoi contatti. Serve un connettore del workspace: l'amministrazione dei gruppi non rientra negli ambiti dell'agente personale.

Chiedi

“Ho sbagliato il numero di versione in quell'annuncio, correggilo.”

Strumenti chiamati

entergram_list_messagesentergram_edit_message

Ottieni

Rilegge la cronologia recente per individuare il messaggio che intendi, poi lo modifica sul posto invece di pubblicare una correzione sotto. Telegram lascia il messaggio dov'era, quindi chi l'ha già letto non riceve un'altra notifica e la cronologia del canale resta pulita.

Chiedi

“Dammi in TSV il numero di ticket di questa settimana per assegnatario.”

Strumenti chiamati

entergram_list_ticketsentergram_list_ticket_custom_columnsentergram_list_members

Ottieni

La formattazione dell'output è dove un client da terminale si ripaga. Recupera la coda, traduce le colonne di categoria e gravità nei loro valori reali, associa gli ID degli assegnatari ai nomi delle persone e stampa righe separate da tabulazioni da passare direttamente a un foglio di calcolo o a uno script di grafici. Report al volo, senza che nessuno debba prima costruire un report.

Caso d'uso · Revenue operations

Una riconciliazione settimanale della pipeline da Telegram a HubSpot

Lo stesso prompt può girare su ogni identità Telegram, ma il risultato deve conservare la provenienza: quale account ha tenuto la conversazione, a quale record HubSpot corrisponde e cosa è cambiato dall'esecuzione precedente.

Scopri di più

La revisione della pipeline del venerdì include le trattative che esistevano solo su Telegram

I commerciali usano account Telegram diversi per regioni e brand. Il venerdì il CRM riflette riunioni ed email, ma manca delle discussioni sui prezzi, delle obiezioni e dei passi successivi concordati su Telegram.

L'istruzione

Per ogni account Telegram collegato, esamina le chat aggiornate questa settimana. Abbina i contatti commerciali a HubSpot tramite telefono verificato, email o un ID esterno già esistente, mai solo tramite il nome visualizzato. Produci una tabella di riconciliazione. Per le trattative abbinate, proponi una nota con nome dell'account, ultima decisione e prossima azione. Metti i lead qualificati non abbinati in un elenco di revisione separato. Pubblica il riepilogo finale su Slack e non creare né unire contatti senza approvazione.

Cosa ottiene il team

Il team revenue operations vede quali conversazioni Telegram sono avanzate, si sono bloccate o non sono mai arrivate in HubSpot. Ogni nota CRM riporta l'account di origine e l'intervallo di date, così un manager può ricondurre il riepilogo alla conversazione reale.

Cadenza

Settimanale tramite cron o un job pianificato della Gemini CLI

  1. Gemini ricava i valori di account_id e legge le variazioni degli ultimi sette giorni di ogni account.

  2. Uno script di contorno interroga HubSpot, applica chiavi di abbinamento deterministiche e chiede a Gemini di riassumere solo le chat pertinenti.

  3. Le note approvate vengono scritte in HubSpot; i totali su tutti gli account e l'elenco dei non abbinati vanno su Slack.

Verifica con la realtà

La Gemini CLI fornisce il ragionamento e gli strumenti MCP di Entergram; HubSpot e Slack richiedono proprie credenziali API o connettori MCP. Per le esecuzioni non presidiate usa uno scheduler che controlli tu, conserva il timestamp dell'ultima esecuzione e richiedi una revisione prima di creare o unire record CRM.

Dove registrare il server

Scopri di più

Gemini CLI, ambito utente

Il percorso principale, quello che quasi tutti intendono con Gemini MCP. Aggiungi il server in ~/.gemini/settings.json sotto mcpServers, con httpUrl che punta all'endpoint in hosting, riavvia la CLI e gli strumenti sono disponibili in ogni progetto su quella macchina. Trattandosi di HTTPS remoto, non c'è alcun wrapper npx né ponte stdio da tenere attivo.

{ "mcpServers": { "entergram": { "httpUrl": "https://mcp.entergram.com/mcp" } } }

Gemini CLI, ambito progetto

Lo stesso blocco inserito in .gemini/settings.json dentro un repository vale solo per quel checkout. Utile quando un repo è la pipeline di deploy che annuncia i rilasci in un canale Telegram e il resto del tuo lavoro non ha motivo di toccare le chat. In più tiene la configurazione sotto controllo di versione, dove un collega può leggerla.

mkdir -p .gemini && $EDITOR .gemini/settings.json

Qualsiasi client che usa un modello Gemini

L'endpoint non dipende dal modello. Un agente IDE, uno script o uno strumento interno che usa Gemini registra Entergram come prevede la sua configurazione MCP e riceve lo stesso identico elenco di strumenti. La schermata di consenso appartiene a Entergram, quindi chi esegue il client si autorizza con la propria identità invece di ereditare il permesso di qualcun altro.

La superficie degli strumenti nella CLI

Dopo la connessione, elenca i server MCP registrati: tutti i 78 strumenti compaiono sotto entergram, raggruppati come qui sotto. I nomi degli strumenti sono identificatori letterali, e in un terminale questo conta più che in una finestra di chat: puoi nominare una chiamata direttamente nel prompt quando vuoi un comportamento deterministico invece di lasciare al modello la scelta del percorso. La CLI stampa ogni chiamata con i suoi argomenti mentre procede, quindi un elenco di strumenti sconosciuto si impara in fretta.

Scopri di più

Consenso, macchina per macchina

In settings.json non c'è alcuna credenziale. Il file dice solo alla CLI dove si trova il server; l'accesso deriva da un login OAuth che completi in un browser, e il token risultante appartiene a te e non al checkout. Google non riceve mai credenziali Telegram: numero di telefono e sessione restano dentro Entergram. Esistono due set di ambiti, e quale ti serve dipende dal fatto che la CLI debba scrivere o no.

Scopri di più
Ambiti dell'agente personale
Qualsiasi membro può crearne uno senza chiedere a un amministratore. Copre la lettura di workspace, account collegati, contatti, chat, messaggi e ticket, più la scrittura dei valori dei campi personalizzati sulle tue chat. Basta per ogni lavoro di analisi ed esportazione di questa pagina; non basta per inviare un messaggio.
Ambiti del connettore del workspace
Riservato a proprietari e amministratori, ed è quello di cui un'automazione ha davvero bisogno. Aggiunge invio, media, modifiche, scrittura dei ticket, scrittura dei campi personalizzati in tutto il workspace e amministrazione dei gruppi Telegram. Poiché è condiviso e non personale, tratta con la stessa cura la macchina su cui lo autorizzi.
Interrompere la connessione
Eliminare la voce in mcpServers impedisce alla CLI di chiamare il server, ma non invalida nulla. Per togliere davvero l'accesso, revoca il client dal lato Entergram in Settings → Workspace → Connectors → MCP: l'effetto è immediato, su ogni macchina che lo stava usando.

Vincoli di cui tenere conto nella progettazione

La maggior parte si fa sentire solo quando provi a far girare la CLI senza supervisione.

Scopri di più
  • Registrare il server non equivale ad autorizzarlo. Ogni macchina passa per la schermata di consenso da sola la prima volta, quindi un portatile nuovo o un container ricostruito ha bisogno di un browser almeno una volta.
  • Il workspace Entergram deve essere sul piano Pro. Con un livello inferiore la CLI elenca il server senza problemi e poi raccoglie rifiuti da ogni chiamata: sembra una configurazione rotta, ma non lo è.
  • Non esiste un account implicito. Gli strumenti di messaggistica richiedono un account_id esplicito, quindi ogni script deve prima ricavare l'elenco degli account. In una chat quasi non te ne accorgi, in una pipeline è una cosa in più da ricordare: ricavalo una volta all'inizio dello script e passalo avanti.
  • Un agente personale non può inviare né amministrare gruppi. Le automazioni che pubblicano note di rilascio o creano canali richiedono un connettore del workspace autorizzato da un proprietario o da un amministratore.
  • Il protocollo è domanda e risposta, non un abbonamento. Nulla arriva nel terminale senza essere richiesto; Gemini viene a sapere di un nuovo messaggio solo quando qualcosa gli dice di guardare. Qualsiasi forma di monitoraggio deve essere un job pianificato che gestisci tu.
  • La CLI non eleva alcun privilegio. Vede esattamente le chat che vede il tuo account Telegram, e un gruppo che hai lasciato è un gruppo che non può leggere.

Problemi della CLI e le loro cause

Scopri di più

Il server non compare mai nell'elenco MCP

Quasi sempre è JSON non valido: una sola virgola finale fa scartare in silenzio l'intero file di impostazioni. Validalo, verifica che per un server HTTPS remoto la chiave sia httpUrl e non una voce stdio con command e args, e controlla che la voce stia davvero dentro mcpServers.

Le modifiche a settings.json sembrano non avere effetto

La configurazione viene letta all'avvio. Esci completamente dalla sessione e riavviala: un processo in esecuzione continua a servire l'elenco di strumenti costruito all'avvio, quindi il file può essere corretto e sembrare comunque ignorato.

OAuth non si completa su una macchina senza interfaccia grafica

La schermata di consenso richiede un browser. Autorizza da una workstation con schermo, oppure inoltra la porta di callback via SSH: un agente di build senza display non può completare l'handshake da solo.

Funziona in una cartella e non in un'altra

Hai due file di impostazioni. Quello in ~/.gemini vale ovunque, quello in .gemini dentro un repository vale solo lì. Controlla quale dei due contiene davvero la voce entergram prima di modificare altro.

Ogni chiamata restituisce 403

Controlla prima il piano, poi il ruolo. L'accesso MCP richiede Pro, e tutto ciò che va oltre gli ambiti dell'agente personale richiede diritti da proprietario o amministratore sul workspace Entergram.

Le letture funzionano ma gli invii vengono rifiutati

È il confine dell'agente personale, non un errore temporaneo. L'invio è del tutto assente dai suoi ambiti, quindi riprovare non serve: un proprietario o un amministratore deve autorizzare un connettore del workspace e devi ripetere il flusso di consenso su quello.

FAQ Gemini + Telegram

Funziona con la Gemini CLI?
Sì. La Gemini CLI supporta i server MCP: registra l'URL MCP di Entergram nella tua configurazione MCP e autorizza tramite OAuth.
È un bot Telegram?
No. Entergram collega il tuo vero account Telegram personale tramite un server MCP in hosting, quindi Gemini lavora sulle tue chat reali.
Gemini può dirmi cosa mi sono perso?
Sì. Può leggere tutte le chat collegate, contare i messaggi non letti e senza risposta ed evidenziare quelli di clienti e lead.
È sicuro?
Sì. La connessione usa OAuth 2.0 con permessi limitati: decidi tu a cosa può accedere Gemini e puoi revocare l'accesso in qualsiasi momento.

Gemini Telegram MCP - per Gemini e la CLI