Google Gemini koppelen aan je Telegram-chats: zo werkt het

Je koppelt Google Gemini aan je Telegram-chats door de gehoste MCP-server van Entergram, https://mcp.entergram.com/mcp, te registreren in de Gemini CLI en één keer in je browser bij Entergram in te loggen. Daarna kan Gemini je chats, contacten en CRM-data lezen via je echte persoonlijke Telegram-account, en ermee aan de slag binnen de scopes die je hebt toegekend. De installatie bestaat uit drie stappen en één klein JSON-blok, dat je hieronder vindt.

De Gemini CLI is de route die de pagina Gemini Telegram MCP volledig documenteert. Elke andere MCP-compatibele client met een Gemini-model kan dezelfde URL gebruiken, geregistreerd op de manier die die client verwacht.

• Een Pro-workspace. API & MCP is een Pro-functie. Op een lager abonnement toont de CLI de server nog wel, maar wordt elke aanroep geweigerd. Dat lijkt op een kapotte configuratie, maar is het niet.
• Minstens één gekoppeld Telegram-account op je seat. Een persoonlijke connector kan alleen de Telegram-accounts gebruiken die voor jouw eigen lidmaatschap onder Settings → Accounts (Instellingen → Accounts) staan.
• Een browser op de machine voor de eerste keer inloggen. Het toestemmingsscherm heeft er een nodig, dus een headless server moet eerst vanaf een werkstation worden geautoriseerd.

Stap 1: kopieer je MCP-URL in Entergram

Ga naar Settings → Workspace → Connectors → MCP (Instellingen → Workspace → Connectoren → MCP) en kopieer de URL van de MCP-server. Die is voor elke client hetzelfde:

https://mcp.entergram.com/mcp

Stap 2: registreer de server in de Gemini CLI

Voeg Entergram toe onder mcpServers in ~/.gemini/settings.json. Omdat het een externe HTTPS-server is, gebruik je de sleutel httpUrl en geen regel met command en args:

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

Het bestand in je homedirectory geldt voor elk project op die machine. Wil je de toegang tot Telegram tot één repository beperken, zet hetzelfde blok dan in .gemini/settings.json binnen die repository.

Stap 3: start de CLI opnieuw en autoriseer

De CLI leest de configuratie bij het opstarten, dus sluit de sessie helemaal af en start hem opnieuw. Log in bij Entergram in het browservenster dat opengaat en ken de scopes toe die Gemini mag hebben. Niets in settings.json is een inloggegeven: het bestand zegt alleen waar de server staat, en de toegang komt uit die OAuth-login.

Na autorisatie vraag je in de CLI de lijst met geregistreerde MCP-servers op, en verschijnen de tools van Entergram onder entergram.

Wat Gemini kan doen, hangt af van het soort client dat je autoriseert, zoals beschreven op de helppagina over MCP-connectoren:

Een persoonlijke agent kan geen Telegram-berichten versturen. Werkt lezen wel maar wordt versturen geweigerd, dan is dat de grens van de scope en geen fout. Een eigenaar of beheerder moet een workspace-connector autoriseren, en daarna doorloop je de toestemmingsflow opnieuw voor die connector. Ken in beide gevallen de kleinst mogelijke set scopes toe die voor de taak nodig is: met messages.write kan een agent berichten versturen alsof jij het bent.

Wil je de toegang intrekken, trek de client dan in Entergram in onder Settings → Workspace → Connectors → MCP. De regel onder mcpServers verwijderen zorgt er alleen voor dat de CLI de server niet meer aanroept; de toestemming zelf blijft dan geldig.

De MCP-server van Entergram koppelt aan je persoonlijke Telegram-account, niet aan een bot, dus Gemini werkt met dezelfde chats die jij ziet. Prompts die goed werken in de CLI:

• "Welke chats hebben onbeantwoorde vragen uit de afgelopen drie dagen?"
• "Geef de contacten in mijn klantengroep die niet in de communitygroep zitten."
• "Plaats de release notes uit CHANGELOG.md in het bètakanaal." (vereist een workspace-connector)
• "Ik heb een tikfout gemaakt in het versienummer van die aankondiging, verbeter het." (vereist een workspace-connector)
• "Geef me de ticketaantallen van deze week per toegewezen persoon als TSV."

De CLI toont elke toolaanroep die hij doet, dus je kunt de werking bekijken op een taak die alleen leest voordat je hem een schrijftaak toevertrouwt.

• Berichttools vragen om een expliciet account. Er is geen impliciete standaard, dus een script moet eerst de lijst met accounts ophalen en de account-id doorgeven.
• Er komt niets vanzelf binnen. MCP werkt met vraag en antwoord. Gemini weet pas van een nieuw bericht als jij, of een geplande taak van jou, het vraagt om te kijken.
• Geen verhoogde toegang. Gemini ziet precies wat je gekoppelde Telegram-accounts zien. Een groep die je hebt verlaten, kan het niet lezen, en chats die je uitsluit onder Accounts → Exclude chats (Accounts → Chats uitsluiten) blijven buiten de MCP-resultaten.

• De server verschijnt nooit in de MCP-lijst. Meestal is de JSON ongeldig: één komma te veel aan het eind en de CLI negeert het hele instellingenbestand. Controleer of de regel httpUrl gebruikt en binnen mcpServers staat.
• Wijzigingen in settings.json lijken niets te doen. Sluit de sessie volledig af en start opnieuw. Een draaiend proces houdt de toollijst vast die het bij het opstarten heeft opgebouwd.
• Het werkt in de ene map wel en in de andere niet. Je hebt twee instellingenbestanden. Kijk of de regel entergram in ~/.gemini staat of in de map .gemini van een repository.
• Elke aanroep geeft 403. Controleer eerst het abonnement (MCP vereist Pro) en daarna de rol: alles buiten de scopes van een persoonlijke agent vraagt om een eigenaar of beheerder.

De MCP-server van Entergram is voor elke client hetzelfde. Stel hem één keer in en koppel daarna de AI-client die je het liefst gebruikt, of meerdere:

• Claude via Entergram aan Telegram koppelen
• ChatGPT via Entergram aan Telegram koppelen
• Elke AI-tool aan Telegram MCP koppelen

Voor de volledige lijst met Gemini-tools, voorbeelden op projectniveau en geplande taken, zie de pagina Gemini Telegram MCP. Wil je weten wat de server voor elke client doet, begin dan bij de pagina over de Telegram MCP-server.