Telegram-MCP-Server: Telegram-Nachrichten mit einem Agenten lesen und senden
Ein Telegram-MCP-Server gibt einem Agenten vier Aktionen: Unterhaltungen lesen, eine Nachricht senden, in einem bestehenden Thread antworten und einen Chat mit jemandem öffnen, der deinem Bot schon geschrieben hat. Er läuft auf der offiziellen Bot API, ein Token ist also die ganze Einrichtung. Auf Telegram gibt es keine Posts. Alles unten wurde am 13. November 2026 geprüft.
Was ein Telegram-MCP-Server kann
Telegram ist ein Nachrichtenkanal. Wie WhatsApp hat es keinen Feed, kein Post-Objekt und damit weder Reichweite noch Impressions oder Engagement-Rate. Die Tool-Liste, die ein Agent über MCP bekommt, ist deshalb kurz: Unterhaltungen auflisten, den Nachrichtenverlauf einer davon lesen, Text senden, in einem Thread antworten, eine Unterhaltung mit einer bekannten Chat-ID öffnen.
In PlugKit heißen die Tools list_conversations, get_conversation, list_messages, send_message, send_dm, create_conversation und sync_conversations, und der Posteingang ist einheitlich: dieselben vier Tools lesen Instagram, Facebook, WhatsApp und Telegram. Das wiegt schwerer, als es klingt. Ein Agent, der deinen Posteingang sortiert, sollte kein eigenes Tool pro Netzwerk brauchen, denn in dem Moment schreibst du die Routing-Logik selbst in den Prompt.
Was du nicht findest: Planung, Analytics, Kommentarmoderation. Jeder Server, der Telegram-Analytics bewirbt, beschreibt entweder Kanalstatistiken aus einer anderen Oberfläche oder etwas, das es in der Bot API nicht gibt.
Warum die Bot API daraus den am einfachsten einzurichtenden MCP macht
Jede andere Plattform dieser Kategorie lässt dich eine App registrieren, Scopes beantragen, ein Review bestehen und danach ein Token für immer erneuern. Der Instagram-MCP-Server braucht ein professionelles Konto, eine Meta-App und ein App-Review. Der von LinkedIn braucht für die Hälfte seiner Endpunkte Partnerzugang.
Telegram braucht eine Unterhaltung mit einem anderen Bot. Du schreibst @BotFather, schickst /newbot, wähle einen Namen und einen Nutzernamen, der auf bot endet, und er gibt dir ein Token in der Form 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11. Dieses Token ist die Zugangsberechtigung. Es läuft nicht ab, es gibt keinen Erneuerungszyklus und keine Review-Warteschlange.
Aufrufe gehen an https://api.telegram.org/bot<token>/METHOD_NAME über HTTPS, GET oder POST. Das heißt auch: Das Token steckt bei jeder Anfrage im URL-Pfad und landet damit in Proxy-Logs und in der Shell-History. Behandle es wie ein Passwort und nutze /revoke im BotFather, sobald eines durchsickert.
In PlugKit heißt das Tool dafür connect_telegram: du gibst ihm das BotFather-Token, es prüft das Token bei Telegram, bevor es gespeichert wird, und der Bot erscheint als verbundenes Konto. Kein OAuth-Hin-und-Her, weil es nichts zu autorisieren gibt.
| Plattform | Credential | Review | Token-Ablauf |
|---|---|---|---|
| Telegram | Bot-Token vom BotFather | keiner | keiner |
| OAuth-Langzeit-Token | Metas App-Review | 60 Tage, erneuerbar | |
| WABA-Token über Embedded Signup | Meta-Unternehmensverifizierung | variiert, erneute Anmeldung nötig | |
| OAuth-Token | Partnerprogramm für die meisten Endpunkte | 60 Tage | |
| X | OAuth-2.0-Token | kostenpflichtige API-Stufe | erneuerbar |
Die eine Regel, die deinen Agenten ausbremst
Telegrams eigene Dokumentation sagt es in einer Zeile: „Bots can't start conversations with users. A user must either add them to a group or send them a message first.“
Das ist das Telegram-Gegenstück zu Metas 24-Stunden-Fenster, nur dauerhaft statt als Timer. Dein Agent kann keinen Nutzernamen nachschlagen und ihn anschreiben. Er kann nur denen antworten, die bei deinem Bot schon Start gedrückt haben, oder in Gruppen sprechen, in die der Bot geholt wurde.
Die praktische Folge für einen Agenten-Workflow: Eine Liste von Unterhaltungen ist keine Kontaktliste, die du anschreiben kannst. Bevor du etwas baust, das Nutzer benachrichtigt, brauchst du einen Weg, der sie zuerst den Bot öffnen lässt, meist ein Deeplink der Form t.me/yourbot?start=payload, wobei die Nutzlast in der ersten /start-Nachricht landet und dir sagt, wer sie sind.
In Gruppen gibt es ein zweites Limit, das du kennen solltest, bevor du eine Stunde lang debuggst. Standardmäßig bekommt ein Bot in einer Gruppe nur die Nachrichten, die ihn betreffen: Befehle, Antworten auf eigene Nachrichten, Erwähnungen. Telegram nennt das Privacy Mode. Soll dein Agent eine ganze Gruppenunterhaltung lesen, muss der Privacy Mode zuerst im BotFather aus sein, und der Bot muss aus der Gruppe entfernt und neu hinzugefügt werden, damit die Änderung greift.
getUpdates oder Webhook: wie die Nachrichten zum Server kommen
Die Bot API bietet genau zwei Wege, Nachrichten zu empfangen, und sie schließen sich gegenseitig aus. Einen zu setzen deaktiviert den anderen, und das ist mit Abstand die häufigste Ursache für „mein Bot empfängt nichts mehr“.
getUpdatesist Long Polling. Du fragst Updates mit einemoffset, einemlimitzwischen 1 und 100 und einemtimeoutab. Praktisch für lokale Entwicklung.setWebhooklässt Telegram jedes Update per POST an eine HTTPS-URL schicken, die dir gehört, mitmax_connectionszwischen 1 und 100 und einemsecret_token-Header, den du immer setzen solltest. Das nutzt ein gehosteter Server.
Wenn du einen lokalen MCP-Server auf deinem Laptop betreibst, bist du auf getUpdates, ob du es gewählt hast oder nicht, denn Telegram liefert keinen Webhook an eine Maschine ohne öffentliche HTTPS-Adresse. Ein gehosteter Server registriert den Webhook einmal, und die Updates kommen ohne Polling. Die Abwägungen sind dieselben wie in MCP server hosting.
Die Rate Limits, die aus einem Rundruf einen 429 machen
Telegram veröffentlicht sie in seiner Bot-FAQ, und sie sind strenger, als die meisten erwarten, denn nichts warnt dich, bis der 429 kommt.
| Ausgangslage | Limit | Was darüber hinaus passiert |
|---|---|---|
| Einzelchat | etwa 1 Nachricht pro Sekunde | kurze Spitzen toleriert, dauerhaftes Überschreiten gibt 429 |
| Gruppenchat | 20 Nachrichten pro Minute | 429 |
| Massenbenachrichtigungen | etwa 30 Nachrichten pro Sekunde über alle Chats | 429, außer bezahlte Broadcasts sind aktiviert |
| Bezahlte Broadcasts | bis zu 1000 Nachrichten pro Sekunde | 0,1 Stars pro Nachricht ab der 31. pro Sekunde |
Eine Nachricht pro Sekunde und Chat klingt großzügig, bis ein Agent beschließt, eine lange Frage in fünf Absätzen zu beantworten, jeden als eigene Nachricht. Sag ihm, er soll eine Nachricht senden, keinen Thread. Und falls du in Versuchung gerätst, einen Agenten eine Benachrichtigung an ein paar tausend Chats verteilen zu lassen: das ist die 30-pro-Sekunde-Linie, ein Rundruf an 3000 Personen dauert selbst im besten Fall mindestens 100 Sekunden.
Verbinde ihn mit Claude, ChatGPT oder Cursor
PlugKits gehosteter MCP-Server deckt Telegram neben den Publishing-Plattformen ab, und genau das spricht für einen einzigen Endpunkt statt eines reinen Telegram-Servers: derselbe Agent, der eine Telegram-Nachricht beantwortet, kann den Instagram-Post veröffentlichen, um den es dabei ging. Er läuft auf https://api.plugkit.co/mcp über Streamable HTTP und folgt der MCP-Spezifikation in der Fassung vom 28. Juli 2026, mit 103 Tools und drei vorbereiteten Workflows, Stand 13. November 2026.
In Claude Code:
claude mcp add -t http plugkit https://api.plugkit.co/mcp
In den Claude-Apps ist es Customize, dann Connectors, dann Add, dann ein eigener Connector mit derselben URL. ChatGPT nimmt sie unter Add custom MCP server. Cursor und VS Code nehmen einen Ein-Klick-Link oder ein paar Zeilen JSON. Die Authentifizierung läuft über OAuth 2.1 mit PKCE und ohne Client Secret, mit mcp:read zum Lesen von Unterhaltungen und mcp:write zum Senden. Fang mit mcp:read an: einen Posteingang zu lesen ist umkehrbar, eine Telegram-Nachricht zu senden nicht.
PlugKit kostet 49 $ pro Monat für 5 verbundene Konten, jederzeit kündbar, oder 97 $ für 30. Sieben Tage gratis, mit Karte bei der Anmeldung und nichts abgebucht vor Tag 7. Die Telegram-Nachrichten selbst kosten nichts, denn die Bot API hat außerhalb bezahlter Broadcasts keine Gebühr pro Nachricht.
Wenn du nur Telegram brauchst und sonst nichts, schreib es selbst. Ein Bot-Token und 40 Zeilen gegen sendMessage sind ehrlich gesagt die Arbeit eines Vormittags, und das bleibt die richtige Antwort für ein Projekt mit einem einzigen Kanal. Das Argument für einen gehosteten Server ist die zweite Plattform, dort beginnt die Arbeit mit den Zugangsdaten. MCP gegenüber einer normalen API ist die lange Fassung dieser Abwägung.
FAQ
Gibt es einen offiziellen Telegram-MCP-Server?
Nein. Telegram veröffentlicht die Bot API; jede MCP-Schicht darüber kommt von Dritten. Das lohnt sich zu prüfen, bevor du einen installierst, denn manche Community-Server steuern ein Nutzerkonto über die MTProto-Client-API statt einen Bot, und damit steht dein privates Konto im Risiko statt ein Bot, den du widerrufen kannst.
Kann Claude Telegram-Nachrichten senden?
Ja, über einen MCP-Server, der an die Bot API angebunden ist. Claude hat selbst keinen Telegram-Zugang. Ist der Server hinzugefügt, ist Senden ein Tool-Aufruf, mit derselben Regel wie für jeden Bot: Der Empfänger muss deinen Bot gestartet haben oder eine Gruppe mit ihm teilen.
Warum kann mein Bot einem Nutzer nicht zuerst schreiben?
Weil Telegram es per Design verbietet. Ein Nutzer muss dem Bot schreiben oder ihn in eine Gruppe holen, bevor der Bot ihm schreiben darf. Der übliche Umweg ist ein Deeplink, t.me/yourbot?start=payload, der den Bot mit einer Nutzlast öffnet, die du dem Nutzer zuordnen kannst.
Brauche ich OAuth für einen Telegram-MCP-Server?
Für Telegram selbst nicht. Die Bot API authentifiziert sich mit einem Token vom BotFather und sonst nichts. Du willst vielleicht trotzdem OAuth zwischen deinem Agenten und dem MCP-Server, das ist eine andere Schicht und steht in MCP server OAuth authentication.
Kann ein Telegram-Bot jede Nachricht in einer Gruppe lesen?
Nur wenn der Privacy Mode aus ist. Standardmäßig bekommt ein Bot in einer Gruppe Befehle, Antworten auf eigene Nachrichten und Erwähnungen, sonst nichts. Du schaltest den Privacy Mode im BotFather aus, entfernst den Bot dann aus der Gruppe und fügst ihn neu hinzu, damit die Änderung greift.
Ein Plug für jede Plattform, die dein Agent anfasst
49 $ im Monat für 5 verbundene Accounts, jederzeit kündbar. Jede Funktion in jedem Tarif.
Hol dir deinen API-Key →