Telegram MCP Server für KI-Agenten
Metricgram stellt die Telegram Bot API als gehosteten MCP Server bereit. Ihr KI-Agent kann Ihre Telegram-Gruppen lesen, darin posten, sie moderieren und verwalten, mit eingeschränkten Schlüsseln und ganz ohne eigenen Bot-Code.
- Über 70 Methoden der Telegram Bot API als MCP-Tools
- Funktioniert mit Claude, ChatGPT, Cursor und Codex
- Jeder Aufruf ist auf Ihre eigenen Gruppen beschränkt
- Analysen, Mitglieder und Abonnenten im selben Server
Keine Kreditkarte erforderlich
In 2 Minuten eingerichtet
So funktioniert es
1
Bot hinzufügen und Gruppen verbinden
Fügen Sie den Metricgram-Bot (oder Ihren eigenen Bot) als Admin zu Ihren Telegram-Gruppen hinzu. Keine Server, Webhooks oder Polling, um die Sie sich kümmern müssen.
2
Einen eingeschränkten API-Schlüssel erstellen
Erzeugen Sie einen Elite-API-Schlüssel und legen Sie genau fest, was der Agent darf, vom reinen Lesezugriff auf Telegram bis zu Posten, Moderation und Chat-Einstellungen.
3
Mit Ihrem KI-Client verbinden
Fügen Sie einen einzigen Konfigurationsblock in Claude, Cursor, Codex oder einen anderen MCP-Client ein. Ihr Agent sieht nun jede erlaubte Telegram-Aktion als Tool.
Ein Prompt, echte Telegram-Aktionen
Ihr Agent wählt die passenden Bot-API-Aufrufe, Metricgram führt sie in der richtigen Gruppe aus und liefert strukturierte Ergebnisse zurück.
metricgram · mcp
Sie fragen
Poste die AMA-Ankündigung dieser Woche in Crypto Talk, pinne sie still an, eröffne ein Thema "AMA-Fragen" und gib mir einen Einladungslink, der am Freitag abläuft.
Der Agent ruft auf
- send_telegram_message(group_id: 42, text: "…", buttons: [{ url: "…" }])
- pin_telegram_message(group_id: 42, action: "pin", disable_notification: true)
- manage_forum_topic(group_id: 42, action: "create", name: "…")
- create_telegram_invite_link(group_id: 42, expire_date: "2026-10-23T23:59:00Z")
Jeden MCP-Client verbinden
Nutzen Sie den gehosteten Endpunkt mit Ihrem API-Schlüssel. In Claude Desktop lässt er sich über mcp-remote anbinden.
{
"mcpServers": {
"metricgram": {
"url": "https://metricgram.com/api/v1/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Tools für Ihren Agenten
Nachrichten und Medien
send_telegram_message
send_telegram_media
send_telegram_poll
edit_telegram_message
delete_telegram_messages
forward_telegram_message
react_to_telegram_message
Angepinnte Nachrichten und Forenthemen
pin_telegram_message
manage_forum_topic
createForumTopic
closeGeneralForumTopic
unpinAllForumTopicMessages
Moderation und Beitrittsanfragen
ban_member
restrict_member
promote_member
handle_telegram_join_request
banChatSenderChat
setChatAdministratorCustomTitle
Chat-Einstellungen und Einladungslinks
update_telegram_chat_settings
create_telegram_invite_link
revokeChatInviteLink
setChatPermissions
setChatStickerSet
Analysen und Community-Daten
analytics_overview
active_users
list_members
list_messages
gamification_rankings
get_subscriber_health
Jede unterstützte Bot-API-Methode
telegram_api_methods
telegram_bot_api
get_telegram_chat
get_telegram_chat_member
Die Telegram Bot API, aufbereitet für KI-Agenten
Eine Telegram-Integration für einen Agenten bedeutet normalerweise, einen Bot zu hosten, Webhooks zu verarbeiten, Tokens zu speichern und für jeden Endpunkt ein eigenes Tool zu schreiben. Metricgram betreibt den Bot bereits in Ihren Gruppen, daher erhält Ihr Agent die Bot API als fertige MCP-Tools über einen einzigen gehosteten Endpunkt.
Typisierte Tools plus ein vollständiges Bot-API-Gateway
Für häufige Aufgaben wie Nachrichten, Medien, Umfragen, Anpinnen, Themen und Einladungslinks gibt es eigene, gut beschriebene Tools. Alles andere läuft über telegram_bot_api, das offizielle Methodennamen und Parameter der Bot API akzeptiert. So bleibt nichts aus dem unterstützten Katalog außer Reichweite.
Auf Ihre eigenen Gruppen beschränkt
Der Agent wählt niemals selbst eine chat_id. Metricgram leitet sie aus der Gruppe ab, die Ihnen gehört, prüft weitergeleitete und zitierte Nachrichten gegen Ihre anderen Gruppen und lehnt alles ab, was einen fremden Chat erreichen könnte.
Berechtigungen für jedes Vertrauensniveau
Vergeben Sie telegram:read für Recherche-Agenten, telegram:write für Beiträge und Themen, telegram:moderate für Sperren und Beitrittsanfragen sowie telegram:admin für Titel, Berechtigungen und Einladungslinks. Schlüssel lassen sich jederzeit widerrufen.
Sichere Wiederholungen und klare Fehler
Schreibende Tools akzeptieren einen Idempotenzschlüssel, sodass ein wiederholter Aufruf nie doppelt postet. Telegram-Fehler und Rate Limits kommen als strukturierte Ergebnisse mit retry_after zurück, die Agenten selbstständig verarbeiten können.
Kontext, den einfache Bots nicht haben
Derselbe Server stellt Metricgram-Analysen, Mitgliederverlauf, erfasste Nachrichten, Gamification, KI-Zusammenfassungen und den Status Ihrer Stripe-Abonnenten bereit. So kann Ihr Agent entscheiden, was zu tun ist, bevor er handelt.
Metricgram vs. manuelle Verwaltung
| Metricgram | Manuell | |
|---|---|---|
| Gehosteter MCP-Endpunkt, kein eigener Bot-Server nötig | ||
| Über 70 Telegram-Bot-API-Methoden als Tools | ||
| chat_id auf Ihre eigenen Gruppen beschränkt | ||
| API-Schlüssel mit eigenen Berechtigungen, jederzeit widerrufbar | ||
| Idempotente Wiederholungen für schreibende Tools | ||
| Analysen und Mitgliederverlauf als Kontext | ||
| Live-Chatdaten, Admins und Berechtigungen | ||
| Funktioniert mit Ihrem eigenen Bot |
Häufig gestellte Fragen
Was ist ein Telegram MCP Server?
Ein Server nach dem Model Context Protocol, der Telegram-Aktionen als Tools bereitstellt, die ein KI-Agent aufrufen kann. Metricgram hostet ihn für Sie, gestützt auf den Bot, der Ihre Gruppen bereits verwaltet.
Mit welchen KI-Clients funktioniert er?
Mit jedem Client, der MCP über HTTP spricht, darunter Claude Code, Claude Desktop (über mcp-remote), Cursor, Codex und eigene Agenten, die mit den SDKs von OpenAI oder Anthropic gebaut sind.
Deckt er die gesamte Telegram Bot API ab?
Er deckt über 70 gruppenbezogene Methoden ab, darunter Nachrichten, Medien, Umfragen, Bearbeitungen, Reaktionen, Anpinnen, Forenthemen, Moderation, Beitrittsanfragen, Chat-Einstellungen und Einladungslinks. Methoden, die andere Chats oder den Bot selbst betreffen würden, etwa Webhooks, Zahlungen oder das Verlassen einer Gruppe, sind bewusst ausgeschlossen.
Kann ein Agent in Gruppen posten, die mir nicht gehören?
Nein. Jeder Aufruf ist an eine Ihrer verbundenen Gruppen gebunden. Die chat_id wird von Metricgram gesetzt, und Weiterleitungen oder Antworten dürfen nur auf Ihre eigenen Gruppen verweisen.
Ist das die Telegram-Nutzer-API (MTProto)?
Nein. Es wird die offizielle Bot API über Ihren Gruppen-Bot genutzt. Der Agent handelt also als Bot und niemals als Ihr persönliches Telegram-Konto.
Welcher Tarif enthält den MCP Server?
MCP- und API-Zugang sind Teil des Elite-Tarifs. Die 14-tägige kostenlose Testphase umfasst Zugriff auf Elite-Niveau, sodass Sie einen Agenten verbinden können, bevor Sie bezahlen.
Kann ich einschränken, was der Agent tun darf?
Ja. Jeder API-Schlüssel hat eigene Berechtigungen, und Sie können separate Schlüssel für reine Recherche, Posten, Moderation und Verwaltung anlegen.
Weiter erkunden
Finden Sie einen praktischen Leitfaden, entdecken Sie aktive Communitys oder weitere Einsatzmöglichkeiten von Metricgram.
Ratgeber
Blog
Lesen Sie praxisnahe Leitfäden zu Wachstum, Monetarisierung, Moderation und zum Betrieb von Telegram-Communitys.
EntdeckenCommunity-Verzeichnis
Telegram-Community-Verzeichnis
Durchsuchen Sie aktive Telegram-Communitys nach Kategorie, Sprache und Positionierung.
EntdeckenBereichs-Hub
Lösungen
Alle Seiten dieses Bereichs auf einen Blick.
EntdeckenMehr entdecken
Telegram-Gruppenverwaltungs-Tool
Telegram-Gruppen-Analysen & Metriken
Telegram-Bot für Gruppenverwaltung
Automatisieren Sie Ihre Telegram-Gruppe
Telegram Mitgliedschafts-Bot für bezahlte Communities
Telegram Zahlungs-Bot für Gruppen und Kanäle
Telegram Abonnement-Bot für wiederkehrende Einnahmen
Telegram Kanal-Monetarisierung leicht gemacht
Erstellen und verwalten Sie eine Telegram VIP-Gruppe
Telegram-Support in Account Intelligence verwandeln
MCP
API
KI-Chatbots Assistenten