Come collegare Google Gemini alle tue chat Telegram

Colleghi Google Gemini alle tue chat Telegram registrando il server MCP ospitato di Entergram, https://mcp.entergram.com/mcp, nella Gemini CLI ed effettuando una sola volta l'accesso a Entergram dal browser. Da quel momento Gemini può leggere le tue chat, i tuoi contatti e i dati del CRM attraverso il tuo vero account Telegram personale, e agire su di essi entro i permessi che hai concesso. La configurazione richiede tre passaggi e un piccolo blocco JSON, che trovi qui sotto.

La Gemini CLI è il percorso documentato per intero nella pagina Gemini Telegram MCP. Qualsiasi altro client compatibile con MCP che esegue un modello Gemini può usare lo stesso URL, registrandolo nel modo previsto da quel client.

• Un workspace Pro. API e MCP sono una funzionalità del piano Pro. Con un piano inferiore la CLI mostrerà comunque il server, ma ogni chiamata verrà rifiutata: sembra una configurazione rotta, ma non lo è.
• Almeno un account Telegram connesso alla tua postazione. Un connettore personale può usare solo gli account Telegram elencati in Settings → Accounts (Impostazioni → Account) per il tuo profilo di membro.
• Un browser sulla macchina per il primo accesso. La schermata di consenso ne ha bisogno, quindi un server headless va autorizzato prima da una workstation.

Passaggio 1: copia il tuo URL MCP in Entergram

Vai in Settings → Workspace → Connectors → MCP (Impostazioni → Workspace → Connettori → MCP) e copia l'URL del server MCP. È lo stesso per tutti i client:

https://mcp.entergram.com/mcp

Passaggio 2: registra il server nella Gemini CLI

Aggiungi Entergram sotto mcpServers in ~/.gemini/settings.json. Poiché il server è remoto su HTTPS, la chiave è httpUrl e non una voce con comando e argomenti:

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

Il file nella tua cartella home vale per tutti i progetti su quella macchina. Per limitare l'accesso a Telegram a un solo repository, metti lo stesso blocco in .gemini/settings.json all'interno di quel repository.

Passaggio 3: riavvia la CLI e autorizza

La CLI legge la configurazione all'avvio, quindi chiudi completamente la sessione e riaprila. Accedi a Entergram nella finestra del browser che si apre e concedi i permessi che vuoi dare a Gemini. Niente in settings.json è una credenziale: il file indica solo dove si trova il server, e l'accesso deriva da quel login OAuth.

Una volta autorizzato, elenca i server MCP registrati nella CLI: gli strumenti di Entergram compaiono sotto entergram.

Quello che Gemini può fare dipende dal tipo di client che autorizzi, come descritto nella pagina di aiuto sui connettori MCP:

Un agente personale non può inviare messaggi Telegram. Se le letture funzionano ma gli invii vengono rifiutati, è il limite dei permessi, non un errore. Un proprietario o un amministratore deve autorizzare un connettore di workspace, e tu ripeti la procedura di consenso su quel connettore. In ogni caso, concedi l'insieme minimo di permessi necessario per il lavoro: messages.write permette a un agente di inviare messaggi a tuo nome.

Per revocare l'accesso, rimuovi il client in Entergram da Settings → Workspace → Connectors → MCP. Eliminare la voce in mcpServers impedisce solo alla CLI di chiamare il server: non invalida l'autorizzazione.

Il server MCP di Entergram si collega al tuo account Telegram personale, non a un bot, quindi Gemini lavora sulle stesse chat che vedi tu. Richieste che funzionano bene nella CLI:

• "Quali chat hanno domande senza risposta degli ultimi tre giorni?"
• "Elenca i contatti del mio gruppo clienti che non sono nel gruppo della community."
• "Pubblica le note di rilascio da CHANGELOG.md nel canale beta." (richiede un connettore di workspace)
• "Ho sbagliato a scrivere il numero di versione in quell'annuncio, correggilo." (richiede un connettore di workspace)
• "Dammi il numero di ticket di questa settimana per assegnatario in formato TSV."

La CLI mostra ogni chiamata agli strumenti che esegue, così puoi osservare il meccanismo su un'operazione di sola lettura prima di affidarle una scrittura.

• Gli strumenti per i messaggi richiedono un account esplicito. Non esiste un account predefinito implicito, quindi uno script deve prima recuperare l'elenco degli account e poi passare l'id dell'account.
• Niente arriva senza una richiesta. MCP funziona a richiesta e risposta. Gemini viene a sapere di un nuovo messaggio solo quando tu, o un job pianificato che gestisci, gli chiedete di controllare.
• Nessun accesso privilegiato. Gemini vede esattamente ciò che vedono i tuoi account Telegram connessi. Un gruppo che hai lasciato è un gruppo che non può leggere, e le chat che escludi in Accounts → Exclude chats (Account → Escludi chat) restano fuori dai risultati MCP.

• Il server non compare mai nell'elenco MCP. Di solito è un JSON malformato: basta una virgola finale perché la CLI scarti l'intero file di impostazioni. Controlla che la voce usi httpUrl e si trovi dentro mcpServers.
• Le modifiche a settings.json sembrano non avere effetto. Chiudi completamente la sessione e riavviala. Un processo in esecuzione mantiene l'elenco di strumenti creato all'avvio.
• Funziona in una cartella e non in un'altra. Hai due file di impostazioni. Controlla se la voce entergram si trova in ~/.gemini o nella cartella .gemini di un repository.
• Ogni chiamata restituisce 403. Controlla prima il piano (MCP richiede Pro), poi il ruolo: tutto ciò che va oltre i permessi dell'agente personale richiede un proprietario o un amministratore.

Il server MCP di Entergram è lo stesso per tutti i client. Lo configuri una volta e puoi collegare il client di AI che preferisci, o anche più di uno:

• Collega Claude a Telegram tramite Entergram
• Collega ChatGPT a Telegram tramite Entergram
• Collega qualsiasi strumento di AI a Telegram MCP

Per l'elenco completo degli strumenti di Gemini, gli esempi a livello di progetto e i job pianificati, consulta la pagina Gemini Telegram MCP. Per sapere cosa fa il server con tutti i client, parti dalla pagina del server MCP per Telegram.