Telegram MCP Server: KI-Agenten sicher Zugriff auf die komplette Telegram Bot API geben

Warum KI-Agenten eine Brücke zu Telegram brauchen

KI-Agenten werden immer besser darin, echte Werkzeuge zu bedienen. Sie lesen ein Dashboard, erkennen, was wichtig ist, und erledigen den nächsten Schritt. Um aber in Telegram zu handeln, brauchen sie eine Brücke: etwas, das einen Satz wie "Pinne die AMA-Ankündigung an und eröffne ein Thema für Fragen" in die richtigen Aufrufe der Telegram API übersetzt.

Diese Brücke ist ein Telegram MCP Server.

Das Model Context Protocol (MCP) ist ein offener Standard, mit dem KI-Clients wie Claude, ChatGPT, Cursor und Codex Tools entdecken und aufrufen können. Ein Telegram MCP Server stellt Telegram-Aktionen als solche Tools bereit, mit klaren Beschreibungen und Eingabeschemas, denen das Modell folgen kann.

Metricgram betreibt jetzt einen solchen Server für Sie, gestützt auf den Bot, der Ihre Gruppen bereits verwaltet.

Was es wirklich bedeutet, die Telegram Bot API einzubinden

Auf dem Papier klingt es einfach, die Bot API für einen Agenten aufzubereiten. In der Praxis müssen Sie:

• Einen Bot hosten, sein Token geheim halten und ihn dauerhaft am Laufen halten.
• Updates per Webhook oder Polling empfangen.
• Für jeden Endpunkt, den der Agent nutzen soll, eine Tool-Definition schreiben.
• Verhindern, dass der Agent in Chats postet, die er niemals berühren sollte.
• Rate Limits, migrierte Supergruppen und Telegram-Fehlermeldungen behandeln.
• Wiederholungen absichern, damit ein wackeliger Netzwerkaufruf dieselbe Nachricht nicht zweimal sendet.
• Protokollieren, was der Agent getan hat, falls Sie es später erklären müssen.

Die meisten Teams hören nach "Nachricht senden" auf, weil alles andere viel Infrastrukturarbeit ist. Das Ergebnis ist ein Agent, der reden, aber eine Community nicht wirklich verwalten kann.

So funktioniert der Telegram MCP Server von Metricgram

Metricgram ist bereits als Admin-Bot (oder als Ihr eigener Bot) in Ihren Telegram-Gruppen aktiv. Der MCP Server lässt Ihren KI-Client diesen Bot einfach über einen gehosteten Endpunkt nutzen:

1. Verbinden Sie Ihre Gruppen mit Metricgram und geben Sie dem Bot Admin-Rechte.
2. Fügen Sie den Endpunkt https://metricgram.com/api/v1/mcp in Ihren KI-Client ein, zum Beispiel als benutzerdefinierten Connector in Claude.
3. Melden Sie sich an und genehmigen Sie den Zugriff mit OAuth. Das war es: keine Server, Webhooks oder Tokens, um die Sie sich kümmern müssen. Clients ohne OAuth können stattdessen einen API-Schlüssel mit der Konfiguration unten verwenden.

{
  "mcpServers": {
    "metricgram": {
      "url": "https://metricgram.com/api/v1/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

In Claude Desktop lässt sich derselbe Endpunkt über mcp-remote anbinden. Die genauen Snippets für jeden Client finden Sie auf der MCP-Seite in Ihrem Manager.

Über 70 Bot-API-Methoden, zwei Wege, sie aufzurufen

Der Server stellt die Telegram Bot API in zwei Ebenen bereit.

Typisierte Tools für den Alltag

Häufige Aufgaben haben eigene Tools mit sprechenden Parametern, die Modelle leicht korrekt verwenden können:

• send_telegram_message mit Themen, Antworten und URL-Buttons
• send_telegram_media für Fotos, Videos, GIFs, Dokumente, Audio und Sticker
• send_telegram_poll für Umfragen und Quiz
• edit_telegram_message, delete_telegram_messages, react_to_telegram_message
• pin_telegram_message und forward_telegram_message
• manage_forum_topic zum Erstellen, Umbenennen, Schließen, Wiedereröffnen oder Löschen von Themen
• get_telegram_chat und get_telegram_chat_member für Live-Chatdaten
• handle_telegram_join_request, create_telegram_invite_link und update_telegram_chat_settings

Ein vollständiges Bot-API-Gateway

Alles andere läuft über telegram_bot_api. Der Agent übergibt einen offiziellen Methodennamen der Bot API samt Parametern, zum Beispiel setChatPermissions, banChatSenderChat, editMessageMedia, hideGeneralForumTopic oder revokeChatInviteLink. Das Begleit-Tool telegram_api_methods listet jede Methode auf, die der aktuelle Schlüssel verwenden darf, sodass der Agent immer weiß, was verfügbar ist.

Sicherheit: Warum der Agent nie eine chat_id wählt

Die wichtigste Designentscheidung betrifft das, was der Agent nicht tun kann.

• Der Chat ist festgelegt. Der Agent übergibt eine Metricgram-group_id. Der Server leitet die Telegram-chat_id aus einer Gruppe ab, die Ihnen gehört, und lehnt jeden anderen Chat ab.
• Weiterleitungen und Zitate werden geprüft. Eine Nachricht kann nur aus Ihren eigenen Gruppen weitergeleitet, kopiert oder zitiert werden.
• Bot-weite Aktionen sind ausgeschlossen. Webhooks, Zahlungen, Änderungen am Bot-Profil und das Verlassen einer Gruppe werden nicht angeboten.
• Buttons sind sicher. Inline-Buttons können URLs öffnen oder Text kopieren, aber keine Callbacks an den Bot auslösen.
• Berechtigungen entsprechen dem Vertrauen. telegram:read, telegram:write, telegram:moderate und telegram:admin sind getrennt, und Sie können mehrere Schlüssel mit unterschiedlichen Rechten führen.
• Wiederholungen sind idempotent. Schreibende Tools akzeptieren einen idempotency_key, sodass ein wiederholter Aufruf das erste Ergebnis zurückgibt, statt doppelt zu handeln.
• Jeder Aufruf wird protokolliert, inklusive Tool und verwendeter Bot-API-Methode.

Der Agent handelt über die offizielle Bot API als Bot und niemals als Ihr persönliches Telegram-Konto.

Kontext, den ein einfacher Bot nicht hat

Ein reiner Bot-API-Wrapper kann handeln, sieht aber wenig. Der MCP Server von Metricgram stellt zusätzlich Community-Wissen bereit:

• Analyseübersicht und Aktivitätsverläufe
• Aktive Mitglieder, Mitgliederverlauf und erfasste Nachrichten
• Gamification-Ranglisten und Belohnungen
• KI-Zusammenfassungen dessen, was in der Gruppe passiert ist
• Status der Stripe-Abonnenten und gefährdete Verlängerungen

So kann ein Agent die Frage "Wer hat diesen Monat aufgehört mitzumachen?" beantworten und diesen Mitgliedern anschließend eine persönliche Nachricht schicken, alles in einem einzigen Gespräch.

Beispiel-Workflows

Wöchentliche Ankündigung. "Poste die wöchentliche AMA-Ankündigung in Crypto Talk, pinne sie an, ohne alle zu benachrichtigen, eröffne ein Thema für AMA-Fragen und erstelle einen Einladungslink, der am Freitag abläuft."

Moderationsrunde. "Prüfe die letzten 200 Nachrichten auf Spam-Links, lösche sie und schränke die Absender für 24 Stunden ein."

Community-Bericht. "Vergleiche die Aktivität dieser Woche mit der letzten, liste die fünf aktivsten Mitglieder auf und poste eine kurze Dankesnachricht im Thema General."

Beitrittsanfragen sortieren. "Genehmige die offenen Beitrittsanfragen von Nutzern mit aktivem Abo und lehne den Rest ab."

Für wen ist das gedacht?

• Community-Betreiber, die einen Assistenten für Routine-Adminarbeit wollen.
• Agenturen, die viele Kundengruppen betreuen und einen Agenten für alle einsetzen möchten.
• Support- und Success-Teams, die Kunden-Communities auf Telegram betreiben.
• Entwickler, die Telegram in ihren Agenten-Stack holen wollen, ohne eine Bot-Infrastruktur zu betreiben.

Erste Schritte

Der MCP Server ist in jedem Metricgram-Tarif und in der 14-tägigen kostenlosen Testphase enthalten. Sie können also einen Agenten verbinden, bevor Sie bezahlen. Die meisten Clients verbinden sich per OAuth: Server-URL einfügen, anmelden und Zugriff genehmigen. Für Clients ohne OAuth stehen weiterhin API-Schlüssel zur Verfügung.

Mehr erfahren Sie auf der Seite zum Telegram MCP Server und in der Übersicht der MCP-Funktionen. Anschließend erstellen Sie Ihren ersten Schlüssel im Manager.