← Alle Telegram-MCP-Connectoren

opencode · SST

opencode Telegram MCP — Ihr Postfach für den Terminal-Agenten

Fügen Sie Entergram als MCP-Server in opencode hinzu, dem quelloffenen Terminal-KI-Agenten von SST, und lassen Sie ihn Ihr echtes Telegram-Konto bearbeiten — verpasste Nachrichten sichtbar machen, kalt gewordene Leads nachfassen und direkt aus der Kommandozeile auf Chats reagieren.

MCP-Server-URL https://mcp.entergram.com/mcp

opencode lädt MCP-Server aus seiner Konfigurationsdatei. Registrieren Sie den von Entergram als entfernten MCP-Server, und der quelloffene Agent von SST arbeitet im Terminal mit Ihrem echten persönlichen Telegram-Konto — per OAuth abgestuft, ohne Bot-Konto und ohne API-Schlüssel.

Konfiguration zum Einfügen

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

Fragen Sie opencode Dinge, die Sie Telegram nie fragen könnten

Mit verbundenem persönlichem Konto kann opencode vom Terminal aus über alle Chats hinweg handeln. Probieren Sie Eingaben wie:

  • „Öffne einen Incident-Kanal und hol die Rufbereitschaft dazu.“
  • „Poste die Deploy-Zusammenfassung in den Kanal für Kunden-Updates.“
  • „Wie viele Tickets sind noch offen, bevor ich das Release schneide?“
  • „Finde Chats, in denen es um die Migration geht, und fasse die Bedenken zusammen.“
  • „Häng eine Notiz mit dem Rollback-Plan an diesen Thread.“
  • „Wer in der Beta-Gruppe hat auf den Upgrade-Hinweis nicht geantwortet?“

opencode in 3 Schritten verbinden

Funktioniert mit der opencode-TUI und der CLI.

  1. 01

    Ihre MCP-URL in Entergram kopieren

    Kopieren Sie Ihren Endpunkt in Entergram unter Settings → Workspace → Connectors → MCP. opencode liest ihn aus opencode.json, Sie fügen ihn also in eine Datei ein und nicht in ein Eingabefeld.

  2. 02

    Server in opencode.json eintragen

    Tragen Sie Entergram in Ihrer opencode.json unter "mcp" als entfernten Server mit der Entergram MCP-URL ein: https://mcp.entergram.com/mcp.

  3. 03

    Autorisieren und ausführen

    Starten Sie opencode, melden Sie sich mit Ihrem Entergram-Konto an und klicken Sie auf Allow access, um den abgestuften Zugriff zu erteilen. Danach kann opencode in seinen Sitzungen Ihr Telegram-Konto lesen und darauf reagieren.

Global, pro Projekt oder headless

Global — ~/.config/opencode/opencode.json

Ein Eintrag, der Ihnen in jedes Repository folgt, das Sie öffnen. Das ist der richtige Ort für eine persönliche Freigabe: Der Server steht bereit, egal ob Sie in einem Arbeits- oder einem Wochenendprojekt sind, und Sie autorisieren einmal statt einmal pro Checkout.

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

Pro Projekt — opencode.json im Repo-Wurzelverzeichnis

Neben dem Code eingecheckt, sodass jede Person, die das Repository klont, den Server deklariert vorfindet, ohne dass man es ihr sagen muss. Es wird nichts Geheimes geteilt — die Datei benennt einen Endpunkt und sonst nichts, und jedes Teammitglied durchläuft weiterhin seinen eigenen Login mit seinen eigenen Berechtigungen. Die Projektkonfiguration legt sich über die globale Datei; halten Sie deshalb eine Definition statt zweier konkurrierender.

Headless — opencode run

Der Grund, warum dieser Connector überhaupt zu einem Terminal-Agenten passt. Ein einzelner nicht-interaktiver Aufruf passt in ein Deploy-Skript, ein Makefile-Target oder einen CI-Schritt — und so hört eine Release-Benachrichtigung auf, davon abzuhängen, dass jemand ans Senden denkt.

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

Ausliefern, aus derselben Shell

Ein Terminal-Agent wird genau in den Momenten benutzt, in denen das Öffnen einer Chat-App die Konzentration zerschlagen würde: direkt nach einem Deploy, mitten in einem Incident oder am Ende eines Tages, wenn Sie wissen wollen, was noch offen ist. Diese Läufe setzen diesen Kontext voraus — kurze Prompts, nur Tastatur, und der Connector übernimmt den Teil, den Sie sonst so lange aufschieben, bis er keine Rolle mehr spielt. Jeder bildet sich auf eine Handvoll benannter Aufrufe ab, die im Sitzungsprotokoll erscheinen — was sie auch sicher macht, um sie später direkt in ein Skript zu heben.

Du fragst

„Der Deploy ist durch. Poste Version und Changelog-Link in den Release-Kanal.“

Aufgerufene Tools

entergram_list_accountsentergram_list_groupsentergram_send_message

Du bekommst

Die Ankündigung geht aus derselben Shell raus, die den Deploy ausgeführt hat — Sekunden nach dem Erfolg statt eine Stunde später. Der Agent klärt, welches verbundene Konto posten darf, findet den Kanal über den Namen, sodass die ID nie in Ihrem Skript stehen muss, und sendet. Verdrahten Sie das ins Deploy-Target, und der Schritt hört auf, optional zu sein.

Du fragst

„Ich habe die falsche Build-Nummer in die Ankündigung geschrieben — korrigier das an Ort und Stelle.“

Aufgerufene Tools

entergram_list_messagesentergram_get_messageentergram_edit_message

Du bekommst

Das Original zu korrigieren schlägt eine Korrektur darunter. Der Agent geht die jüngste Historie zurück, um die Nachricht zu identifizieren, prüft den Inhalt, bevor er sie anfasst, und bearbeitet sie — wer morgen vorbeiscrollt, liest also die richtige Zahl statt eines Fadens aus Nachträgen.

Du fragst

„Öffne dafür einen Incident-Raum und hol die Rufbereitschaft dazu.“

Aufgerufene Tools

entergram_create_group_chatentergram_list_membersentergram_invite_chat_members

Du bekommst

Dreißig Sekunden Einrichtung, die niemand erledigen will, während ein System steht. Eine Gruppe wird angelegt, die Workspace-Liste wird gelesen, um die von Ihnen genannten Personen aufzulösen, und die Einladungen gehen raus. Sie sind wieder bei den Logs, während die Koordination bereits erledigt statt halb begonnen ist.

Du fragst

„Leite die Wartungsankündigung von Freitag an jede Kundengruppe weiter, die sie noch nicht gesehen hat.“

Aufgerufene Tools

entergram_list_groupsentergram_list_messagesentergram_forward_messages

Du bekommst

Das Original weiterzuleiten sorgt dafür, dass jede Gruppe denselben Wortlaut liest — genau das, was Sie bei einem Wartungsfenster wollen, und genau das, was Abtippen zerstört. Der Agent prüft vor dem Verteilen, welche Gruppen sie bereits erhalten haben, sodass niemand denselben Hinweis zweimal bekommt.

Du fragst

„Diese meldende Person ist in einigen unserer Communitys — in welchen, und wer von unserer Liste ist dort noch?“

Aufgerufene Tools

entergram_list_contactsentergram_get_contactentergram_list_contact_shared_groups

Du bekommst

Die Suche nach gemeinsamen Gruppen beantwortet eine Frage, die Telegram selbst nicht beantwortet: wo Ihre Überschneidung mit jemandem tatsächlich liegt. Nützlich, wenn eine Fehlermeldung Kontext dazu braucht, wie laut die meldende Person vermutlich wird — und wieder nützlich, wenn Sie entscheiden, ob ein Workaround einmal in einer gemeinsamen Community stehen kann, statt zehnmal von Hand in Direktchats wiederholt zu werden.

Du fragst

„Bevor ich das Release schneide: Wie viele offene Tickets sind für diesen Meilenstein getaggt?“

Aufgerufene Tools

entergram_list_ticket_custom_columnsentergram_list_ticketsentergram_get_ticket

Du bekommst

Eine Release-Bereitschaftsprüfung, die eine Zeile kostet und kein Dashboard braucht. Der Agent liest Ihr Ticket-Schema, um die Meilenstein-Spalte zu finden, filtert die offenen Tickets danach und meldet Anzahl samt Titeln. Setzen Sie das als ersten Schritt Ihres Release-Skripts, und ein blockierendes Ticket stoppt den Tag, statt danach aufzutauchen.

Was opencode mit Ihrem Telegram tun kann

  • Telegram vollständig über die Tastatur steuern
  • Nach dem Ausliefern einen Deploy im Kundenkanal ankündigen
  • Einen Incident-Kanal öffnen und Beteiligte einladen
  • Offene Tickets zählen, bevor ein Release geschnitten wird
  • Global oder pro Projekt über opencode.json konfigurieren
  • Nicht-interaktiv für geskriptete Aufgaben laufen

Siebzig Tools, nichts lokal installiert

Entergram hostet den Server, opencode nimmt also neun Tool-Gruppen auf, ohne dass Ihrer Maschine oder Ihrem CI-Image eine einzige Abhängigkeit hinzugefügt wird — kein Bridge-Prozess, keine Python-Umgebung, keine Zugangsdaten im Repository. Alles Folgende ist erreichbar, sobald die Freigabe existiert, innerhalb der von Ihnen gewählten Zugriffsstufe, und dieselbe Liste steht einer interaktiven Sitzung wie einem Einmal-Lauf zur Verfügung.

Konten & Workspace

5 Tools

Identität und Geltungsbereich ermitteln. Jeder Nachrichtenaufruf braucht zuerst eine account_id aus list_accounts — ein KI-Client, der diesen Schritt überspringt, spricht das falsche Telegram-Konto an.

  • entergram_get_me
  • entergram_list_accounts
  • entergram_get_workspace
  • entergram_get_member
  • entergram_list_members

Chats & Suche

8 Tools

Unterhaltungen finden. Die Workspace-Ansichten liefern den CRM-Zustand (Tickets, Kommentare, individuelle Felder), die Live-Ansichten den aktuellen Telegram-Transportzustand samt Anzahl ungelesener Nachrichten.

  • entergram_list_chats
  • entergram_get_chat
  • entergram_list_live_chats
  • entergram_get_live_chat
  • entergram_list_workspace_chats
  • entergram_get_workspace_chat
  • entergram_update_workspace_chat
  • entergram_get_chat_management

Nachrichten

9 Tools

Nachrichtenverlauf lesen und schreiben, inklusive Bearbeitungen, Weiterleitungen und Reaktionen. Das Senden ist pro Konto abgegrenzt, nichts gilt kontoübergreifend für Ihre verbundenen Konten.

  • entergram_list_messages
  • entergram_get_message
  • entergram_send_message
  • entergram_send_media_message
  • entergram_edit_message
  • entergram_delete_message
  • entergram_forward_messages
  • entergram_get_message_reactions
  • entergram_set_message_reactions

Kontakte

3 Tools

Mit wem Sie sprechen — und wo Sie sich sonst noch begegnen. Erst die Abfrage gemeinsamer Gruppen macht Fragen wie „Welche meiner Leads sind in derselben Community?“ beantwortbar.

  • entergram_list_contacts
  • entergram_get_contact
  • entergram_list_contact_shared_groups

Tickets

10 Tools

Volle Kontrolle über den Support-Desk: öffnen, zuweisen, priorisieren, kommentieren und schließen. Tickets verweisen zurück auf den Chat, aus dem sie stammen — so kommt ein KI-Client in einem Schritt von der Unterhaltung in die Warteschlange.

  • entergram_list_tickets
  • entergram_get_ticket
  • entergram_create_ticket
  • entergram_update_ticket
  • entergram_delete_ticket
  • entergram_list_chat_tickets
  • entergram_list_ticket_comments
  • entergram_create_ticket_comment
  • entergram_update_ticket_comment
  • entergram_delete_ticket_comment

Individuelle CRM-Felder

11 Tools

Das Schema Ihrer Pipeline. Lesen Sie die Spalten, bevor Sie Werte schreiben — Checkboxen erwarten Booleans, Mehrfachauswahlen Arrays von Optionswerten, Datumsfelder ISO-8601-Zeichenketten.

  • entergram_list_custom_columns
  • entergram_get_custom_column
  • entergram_create_custom_column
  • entergram_update_custom_column
  • entergram_delete_custom_column
  • entergram_list_custom_column_options
  • entergram_create_custom_column_option
  • entergram_update_custom_column_option
  • entergram_delete_custom_column_option
  • entergram_get_chat_custom_fields
  • entergram_patch_chat_custom_fields

Individuelle Ticket-Felder

9 Tools

Dieselbe Schema-Kontrolle auf der Ticket-Seite — Kategorien, Schweregrade, SLA-Stufen und alles Weitere, was Ihr Desk über Status und Priorität hinaus erfasst.

  • entergram_list_ticket_custom_columns
  • entergram_get_ticket_custom_column
  • entergram_create_ticket_custom_column
  • entergram_update_ticket_custom_column
  • entergram_delete_ticket_custom_column
  • entergram_list_ticket_custom_column_options
  • entergram_create_ticket_custom_column_option
  • entergram_update_ticket_custom_column_option
  • entergram_delete_ticket_custom_column_option

Interne Notizen

4 Tools

Kommentare zu einem Chat, die Ihr Kunde nie sieht. Nützlich, damit ein KI-Client seine Überlegungen hinterlässt und ein menschlicher Kollege dort weitermacht.

  • entergram_list_chat_comments
  • entergram_create_chat_comment
  • entergram_update_chat_comment
  • entergram_delete_chat_comment

Gruppen & Kanäle

11 Tools

Telegram-Gruppen und -Kanäle anlegen und verwalten — Mitglieder, Berechtigungen, Privatsphäre und Infos — plus einen rohen Befehls-Notausgang für alles Übrige.

  • entergram_list_groups
  • entergram_get_group
  • entergram_list_group_members
  • entergram_create_group_chat
  • entergram_create_channel
  • entergram_invite_chat_members
  • entergram_remove_chat_member
  • entergram_update_chat_info
  • entergram_update_chat_permissions
  • entergram_update_chat_privacy
  • entergram_run_chat_command

Terminal-Sicherheit in einem Absatz

In Ihren Dotfiles landet nichts Sensibles. opencode.json trägt eine URL und ein Flag; die Zugangsberechtigung selbst liegt nach einem Browser-Login im eigenen Auth-Speicher von opencode, und Ihre Telegram-Sitzung bleibt in Entergram, wo weder SST noch der Modellanbieter sie zu sehen bekommen. Geht eine Maschine verloren oder wird ein CI-Runner ausgemustert, killen Sie die Freigabe in Entergram unter Settings → Workspace → Connectors → MCP, und jede Sitzung auf dieser Kiste verliert beim nächsten Aufruf den Zugriff.

Persönlicher Agent
Der Standard für das Terminal einer einzelnen Entwicklerin, und für jedes Mitglied ohne Genehmigungsschritt verfügbar. Das Lesen umfasst den Workspace-Datensatz, Ihre verbundenen Konten, Kontakte, Chats, Nachrichtenhistorie und die Ticket-Warteschlange; das Schreiben beschränkt sich auf die benutzerdefinierten Felder von Chats, die Ihren eigenen Konten gehören. Genug für Sichtung, Zusammenfassungen und Release-Bereitschaftsprüfungen — und bewusst zu wenig für alles, was mit einer Kundin spricht.
Workspace-Connector
Von einem Owner oder Admin angelegt und mit jedem Scope ausgestattet, den der Server definiert: Senden, Bearbeiten, Weiterleiten, Ticket-Schreibzugriffe, Schreiben benutzerdefinierter Felder überall im Workspace und Gruppenverwaltung. Das ist die Stufe, die ein Deploy-Skript braucht, wenn es ohne Menschen in der Schleife in einen Kundenkanal posten soll.
Widerruf
Sofort wirksam und bewusst einseitig. Sie brauchen keinen Zugriff auf die Maschine, auf der opencode läuft, um ihn zu kappen — ein Widerruf in Entergram macht die Freigabe ungültig, wo immer sie gespeichert ist. Genau darum geht es, wenn der Runner eine CI-Kiste ist und kein Laptop auf Ihrem Schreibtisch.

Randbedingungen eines terminalnahen Connectors

Die meisten davon betreffen die Lücke zwischen einer interaktiven und einer automatisierten Sitzung — die Lücke, in der ein Terminal-Agent sein ganzes Leben verbringt. Keine ist ein Ausschlusskriterium; alle lernt man hier billiger als in einer Pipeline.

  • Die erste Autorisierung braucht einen Browser. Ein geskripteter Aufruf kann keinen Zustimmungsdialog abschließen; autorisieren Sie also einmal in einer interaktiven Sitzung und lassen Sie die gespeicherte Freigabe die folgenden Läufe tragen.
  • Eine eingecheckte opencode.json teilt die Adresse, nicht den Zugriff. Teammitglieder, die das Repo ziehen, durchlaufen jeweils ihren eigenen Login, und ihr Token trägt ihre Berechtigungen, nicht Ihre.
  • Auf unserer Seite gibt es keinen Scheduler. opencode beendet sich, wenn der Lauf endet; alles Wiederkehrende — eine nächtliche Zusammenfassung, eine Meldung nach dem Deploy — ist Ihr cron-Eintrag oder Ihr Pipeline-Schritt und nie etwas, das Entergram von selbst auslöst.
  • MCP gehört zum Pro-Tarif. In allem darunter beantwortet der Server den Handshake trotzdem, was den Fehler nach einem Konfigurationsproblem aussehen lässt, obwohl es ein Abrechnungsproblem ist.
  • Schreibvorgänge setzen voraus, dass die Spalte bereits existiert. Der Agent kann ein Release-Tracking-Feld an einem Chat befüllen, aber dieses Feld anzulegen ist eine Aktion für den Workspace-Connector, und eine persönliche Freigabe tut es nicht.
  • Die Adressierung pro Konto ist Pflicht. Terminal-Gewohnheiten erwarten einen sinnvollen Standardwert, und den gibt es nicht — nennen Sie also das Konto im Prompt, sonst löst der Agent es selbst aus der Kontenliste auf.

Fehlerbehebung für den opencode-Connector

opencode startet, listet aber keine Entergram-Tools
Prüfen Sie, ob der Eintrag im mcp-Block liegt, type auf remote und enabled auf true steht — ein Eintrag, dem eines davon fehlt, wird kommentarlos geparst und übersprungen. Die Konfiguration wird beim Start gelesen, starten Sie die Sitzung nach dem Bearbeiten also neu.
opencode startet nach der Änderung nicht mehr
Behalten Sie die $schema-Zeile und schicken Sie die Datei durch einen JSON-Parser. Ein überzähliges Komma ist die übliche Ursache, und die Startfehlermeldung benennt eher die Datei als die betroffene Zeile.
Ein geskripteter Lauf hängt bei der Autorisierung
Nicht-interaktive Läufe können keinen Zustimmungsdialog öffnen. Starten Sie opencode einmal interaktiv, schließen Sie den Entergram-Login ab, und die gespeicherte Freigabe trägt von da an die geskripteten Läufe.
Die falsche Konfiguration ist aktiv
Eine opencode.json im Projekt legt sich über die globale Datei in ~/.config/opencode/. Hat eine Kollegin einen Eintrag eingecheckt, ist ihrer der wirksame — gleichen Sie die beiden ab, statt einen zweiten Server unter anderem Namen hinzuzufügen.
Nachrichten landen an der falschen Stelle
Nennen Sie im Prompt sowohl das Konto als auch den Ziel-Chat. entergram_list_accounts klärt Ersteres, aber nichts an einer Terminal-Sitzung impliziert einen Standard, und ein Einmal-Lauf hält nicht an, um Sie zu fragen.
Aufrufe scheitern seit ein paar Tagen
Tokens laufen ab. Starten Sie opencode interaktiv und bestätigen Sie den Zugriff erneut — die Konfigurationsdatei ändert sich nicht, nur die Freigabe dahinter.

opencode + Telegram FAQ

Wie verbindet sich opencode mit MCP-Servern?
opencode liest MCP-Server aus seiner Konfigurationsdatei. Tragen Sie Entergram als entfernten Server mit der MCP-URL ein und autorisieren Sie per OAuth.
Ist das ein Telegram-Bot?
Nein. In diesem Setup gibt es nirgends ein Bot-Token — der gehostete MCP-Server handelt als Ihr eigenes Telegram-Konto, und genau deshalb kann er Historie lesen, die ein Bot nie sehen könnte.
Ist es sicher?
Ja. OAuth 2.0 mit fein abgestuften Berechtigungen; Sie entscheiden, worauf opencode zugreifen darf, und können es jederzeit widerrufen.
Kann opencode mehrstufige Telegram-Aktionen ausführen?
Ja. Als autonomer Terminal-Agent kann opencode Schritte in einem Lauf verketten — unbeantwortete Chats lesen, Antworten entwerfen und Tickets öffnen — und hält vor dem Senden für Ihre Freigabe an.

opencode Telegram MCP — Ihr Postfach für den Terminal-Agenten