Naar de hoofdinhoud
Alle Telegram MCP-connectors

opencode · SST

opencode Telegram MCP - geef je terminalagent je inbox

Voeg Entergram toe als MCP-server in opencode, de open-source AI-agent voor de terminal van SST, en laat hem met je echte Telegram-account werken: gemiste berichten opsporen, afgekoelde leads opvolgen en vanaf de opdrachtregel actie ondernemen in chats.

URL van de MCP-server https://mcp.entergram.com/mcp

Koppel opencode in 3 stappen

Werkt met de TUI en de CLI van opencode.

URL van de MCP-server https://mcp.entergram.com/mcp
  1. Kopieer je eindpunt in Entergram onder Settings → Workspace → Connectors → MCP. opencode leest het uit opencode.json, dus je plakt het in een bestand en niet in een prompt.

  2. Voeg in je opencode.json Entergram toe onder "mcp" als remote server die naar de Entergram MCP-URL wijst: https://mcp.entergram.com/mcp.

  3. Start opencode, log in met je Entergram-account en klik op Allow access om afgebakende toegang te geven. Daarna kan opencode in zijn sessies je Telegram-account lezen en ermee werken.

Vraag opencode wat Telegram je nooit kan vertellen

Met je persoonlijke account gekoppeld kan opencode vanuit de terminal in elke chat aan de slag. Probeer prompts zoals:

  1. “Open een incidentkanaal en haal iedereen erbij die dienst heeft.”

  2. “Plaats de deploysamenvatting in het kanaal met klantupdates.”

  3. “Hoeveel tickets staan er nog open voordat ik de release maak?”

  4. “Zoek chats die de migratie noemen en vat de zorgen samen.”

  5. “Voeg een notitie met het rollbackplan toe aan die thread.”

  6. “Wie in de bètagroep heeft niet gereageerd op de upgrademelding?”

Wat opencode met je Telegram kan

opencode laadt MCP-servers uit zijn configuratiebestand. Registreer die van Entergram als remote MCP-server en de open-source agent van SST kan in de terminal met je echte persoonlijke Telegram-account werken. Afgebakend via OAuth, zonder botaccount en zonder API-sleutels.

  1. Telegram volledig vanaf het toetsenbord bedienen

  2. Een deploy na livegang aankondigen in een klantkanaal

  3. Een incidentkanaal openen en de juiste mensen uitnodigen

  4. Open tickets tellen voordat je een release maakt

  5. Globaal of per project instellen via opencode.json

  6. Niet-interactief draaien voor gescripte taken

Releasen, vanuit dezelfde shell

Een terminalagent gebruik je op momenten waarop een chatapp openen je concentratie zou breken: vlak na een deploy, midden in een incident of aan het eind van de dag als je wilt weten wat er nog openstaat. Deze runs gaan uit van die context: korte prompts, alleen toetsenbord, en de connector doet het deel dat je anders zou uitstellen tot het er niet meer toe deed. Elke run komt neer op een handvol benoemde aanroepen die in het sessielog verschijnen. Daardoor kun je ze ook veilig direct in een script zetten zodra je ze met de hand hebt zien werken.

Meer informatie

Je vraagt

“De deploy is klaar. Plaats de versie en de link naar de changelog in het releasekanaal.”

Aangeroepen tools

entergram_list_accountsentergram_list_groupsentergram_send_message

Je krijgt

De aankondiging gaat uit vanuit dezelfde shell die de deploy draaide, seconden na het slagen in plaats van een uur later. De agent bepaalt welk gekoppeld account mag posten, vindt het kanaal op naam zodat de ID niet in je script hoeft te staan, en verstuurt. Koppel het aan je deploytarget en de stap is niet langer optioneel.

Je vraagt

“Ik heb het verkeerde buildnummer in die aankondiging gezet. Pas het ter plekke aan.”

Aangeroepen tools

entergram_list_messagesentergram_get_messageentergram_edit_message

Je krijgt

Het origineel corrigeren is beter dan er een correctie onder zetten. De agent loopt de recente geschiedenis terug om het bericht te vinden, controleert de inhoud voordat hij iets aanraakt en bewerkt het. Wie er morgen langs scrollt, leest het juiste nummer in plaats van een reeks aanvullingen.

Je vraagt

“Open hiervoor een incidentruimte en haal iedereen erbij die dienst heeft.”

Aangeroepen tools

entergram_create_group_chatentergram_list_membersentergram_invite_chat_members

Je krijgt

Dertig seconden inrichten die niemand wil doen terwijl een systeem plat ligt. Er wordt een groep aangemaakt, de ledenlijst van de workspace wordt gelezen om de genoemde mensen te vinden, en de uitnodigingen gaan de deur uit. Jij gaat terug naar de logs met de coördinatie al geregeld in plaats van half begonnen.

Je vraagt

“Stuur de onderhoudsmelding van vrijdag door naar elke klantgroep die hem nog niet heeft gezien.”

Aangeroepen tools

entergram_list_groupsentergram_list_messagesentergram_forward_messages

Je krijgt

Het origineel doorsturen houdt de formulering in elke groep identiek, en dat wil je bij een onderhoudsvenster precies; opnieuw typen maakt dat kapot. De agent controleert welke groepen de melding al kregen voordat hij verspreidt, zodat niemand dezelfde melding twee keer krijgt.

Je vraagt

“Deze melder zit in een paar van onze community's. Welke, en wie van onze lijst zit daar nog meer?”

Aangeroepen tools

entergram_list_contactsentergram_get_contactentergram_list_contact_shared_groups

Je krijgt

Opzoeken van gedeelde groepen beantwoordt een vraag die Telegram zelf niet beantwoordt: waar je overlap met iemand echt zit. Handig als een bugmelding context nodig heeft over hoe luid de melder waarschijnlijk wordt, en opnieuw handig als je beslist of je een workaround één keer in een gedeelde community kunt plaatsen in plaats van hem met de hand in tien privéthreads te herhalen.

Je vraagt

“Hoeveel open tickets hangen aan deze mijlpaal voordat ik de release maak?”

Aangeroepen tools

entergram_list_ticket_custom_columnsentergram_list_ticketsentergram_get_ticket

Je krijgt

Een releasecheck in één regel, zonder dashboard. De agent leest je ticketschema om de mijlpaalkolom te vinden, filtert open tickets daarop en meldt het aantal met titels. Zet het als eerste stap in je releasescript en een blokkerend ticket houdt de tag tegen in plaats van erna op te duiken.

Globaal, per project of headless

Meer informatie

Globaal: ~/.config/opencode/opencode.json

Eén vermelding die je in elke repository volgt die je opent. Dit is de juiste plek voor een persoonlijke autorisatie: de server is beschikbaar in een werkproject en in een weekendproject, en je autoriseert één keer in plaats van per checkout.

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "entergram": {
      "type": "remote",
      "url": "https://mcp.entergram.com/mcp",
      "enabled": true
    }
  }
}

Per project: opencode.json in de root van de repo

Samen met de code gecommit, zodat iedereen die de repository kloont de server gedeclareerd krijgt zonder dat iemand het hoeft uit te leggen. Er wordt niets geheims gedeeld: het bestand noemt een eindpunt en verder niets, en elke collega rondt nog steeds een eigen login af met eigen rechten. De projectconfiguratie ligt over het globale bestand heen, dus houd één definitie aan in plaats van twee concurrerende.

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "entergram": {
      "type": "remote",
      "url": "https://mcp.entergram.com/mcp",
      "enabled": true
    }
  }
}

Headless: opencode run

De reden dat deze connector überhaupt bij een terminalagent past. Eén niet-interactieve aanroep past in een deployscript, een Makefile-target of een CI-stap. Zo hangt een releasemelding niet langer af van iemand die eraan denkt om hem te sturen.

opencode run "post the release summary for v2.14 in the customer channel"

78 tools, niets lokaal geïnstalleerd

Entergram host de server, dus opencode krijgt negen toolgroepen zonder dat er één afhankelijkheid op je machine of in je CI-image bijkomt: geen brugproces, geen Python-omgeving, geen inloggegevens in de repo. Alles hieronder is bereikbaar zodra de autorisatie bestaat, binnen het toegangsniveau dat je koos, en dezelfde lijst is beschikbaar voor een interactieve sessie en een eenmalige run.

Meer informatie

Beveiliging aan de terminalkant in één alinea

Er komt niets gevoeligs in je dotfiles. opencode.json bevat een URL en een vlag; het inloggegeven zelf staat na een browserlogin in de eigen authopslag van opencode, en je Telegram-sessie blijft in Entergram, waar SST en de modelaanbieder hem nooit zien. Raakt een machine zoek of wordt een CI-runner uitgefaseerd, trek de autorisatie dan in Entergram in onder Settings → Workspace → Connectors → MCP. Elke sessie op dat apparaat verliest de toegang bij de volgende aanroep.

Meer informatie
Persoonlijke agent
De standaard voor de terminal van één ontwikkelaar, en voor elk lid beschikbaar zonder goedkeuringsstap. Lezen omvat de workspace, je gekoppelde accounts, contacten, chats, berichtgeschiedenis en de ticketwachtrij; schrijven is beperkt tot de custom fields op chats van je eigen accounts. Genoeg voor triage, overzichten en releasechecks, en bewust niet genoeg om iets tegen een klant te zeggen.
Workspaceconnector
Aangemaakt door een eigenaar of beheerder, met elke scope die de server kent: versturen, bewerken, doorsturen, tickets schrijven, custom fields overal in de workspace schrijven en groepsbeheer. Dit niveau heeft een deployscript nodig als het zonder mens ertussen in een klantkanaal moet posten.
Intrekken
Direct, en bewust eenzijdig. Je hebt geen toegang tot de machine met opencode nodig om hem af te sluiten: intrekken in Entergram maakt de autorisatie ongeldig, waar die ook is opgeslagen. Dat is precies de bedoeling als de runner een CI-machine is en geen laptop op je bureau.

Grenzen van een connector voor de terminal

De meeste gaan over het gat tussen een interactieve sessie en een geautomatiseerde, en precies over dat gat staat een terminalagent zijn hele leven. Geen ervan houdt je tegen; ze zijn allemaal goedkoper om hier te leren dan in een pipeline.

Meer informatie
  • De eerste autorisatie heeft een browser nodig. Een gescripte aanroep kan geen toestemmingsscherm afronden, dus autoriseer één keer in een interactieve sessie en laat de opgeslagen autorisatie de volgende runs dragen.
  • Een gecommitte opencode.json deelt het adres, niet de toegang. Collega's die de repo binnenhalen, doorlopen elk een eigen login, en hun token draagt hun rechten en niet de jouwe.
  • Aan onze kant is er geen planner. opencode stopt als de run klaar is, dus alles wat terugkeert (een nachtelijk overzicht, een melding na een deploy) is jouw cron-regel of pipelinestap, nooit iets wat Entergram zelf start.
  • MCP hoort bij het Pro-abonnement. Op een lager abonnement antwoordt de server nog op de handshake, waardoor de fout op een configuratiebug lijkt terwijl het om facturering gaat.
  • Schrijven vraagt dat de kolom al bestaat. De agent kan een veld voor releasetracking op een chat invullen, maar dat veld aanmaken is een actie voor de workspaceconnector en een persoonlijke autorisatie doet het niet.
  • Adresseren per account is verplicht. Terminalgewoontes verwachten een verstandige standaard en die is er niet. Noem het account in de prompt, anders bepaalt de agent het zelf uit de accountlijst.

Problemen met de opencode-connector oplossen

Meer informatie

opencode start maar toont geen Entergram-tools

Controleer of de vermelding onder het mcp-blok staat, met type op remote en enabled op true. Een vermelding waarin een van beide ontbreekt, wordt zonder melding ingelezen en overgeslagen. De configuratie wordt bij het opstarten gelezen, dus herstart de sessie na het bewerken.

opencode wil na de wijziging niet meer starten

Laat de $schema-regel staan en haal het bestand door een JSON-parser. Een komma aan het eind is de gebruikelijke oorzaak, en de opstartfout noemt meestal het bestand en niet de regel waar het misgaat.

Een gescripte run blijft hangen bij de autorisatie

Niet-interactieve runs kunnen geen toestemmingsscherm openen. Start opencode één keer interactief, rond de Entergram-login af, en de opgeslagen autorisatie draagt vanaf dan de gescripte runs.

De verkeerde configuratie is actief

Een opencode.json in het project ligt over het globale bestand in ~/.config/opencode/ heen. Heeft een collega een vermelding gecommit, dan wordt die gebruikt. Breng de twee in lijn in plaats van een tweede server onder een andere naam toe te voegen.

Berichten komen op de verkeerde plek terecht

Noem zowel het account als de doelchat in de prompt. entergram_list_accounts lost het eerste op, maar een terminalsessie kent geen standaard, en een eenmalige run stopt niet om het je te vragen.

Aanroepen mislukken na een paar dagen

Tokens verlopen. Start opencode interactief en keur de toegang opnieuw goed. Het configuratiebestand verandert niet, alleen de autorisatie erachter.

opencode + Telegram FAQ

Hoe maakt opencode verbinding met MCP-servers?
opencode leest MCP-servers uit zijn configuratiebestand. Voeg Entergram toe als remote server met de MCP-URL en autoriseer via OAuth.
Is dit een Telegram-bot?
Nee. Er zit nergens een bottoken in deze opzet. De gehoste MCP-server werkt als je eigen Telegram-account, en daarom kan hij geschiedenis lezen die een bot nooit zou zien.
Is het veilig?
Ja. OAuth 2.0 met afgebakende rechten. Jij bepaalt waar opencode bij kan en je trekt de toegang op elk moment in.
Kan opencode Telegram-acties met meerdere stappen uitvoeren?
Ja. Als zelfstandige terminalagent kan opencode stappen in één run aan elkaar rijgen: onbeantwoorde chats lezen, antwoorden opstellen en tickets openen. Voordat er iets wordt verstuurd, wacht hij op jouw goedkeuring.

opencode Telegram MCP - geef je terminalagent je inbox