Zusammenfassung
Sende Telegram-Nachrichten, Fotos, Alben, Dokumente, Audio, Videos, Animationen, Sticker, Kontakte, Orte, Standorte und Umfragen aus jedem KI-Agent über die Telegram Bot API. 33 Tools, Authentifizierung per Bot-Token. Ausgehende Nachrichten plus ein schlankes Lesen der letzten Updates (kein Long-Polling).
Geführte Einrichtung
Telegram Bot in 2 Minuten mit Gemini verbinden
Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde Telegram Bot in der geführten Einrichtung und trag deine MCP-URL in Gemini ein. Ohne Code, ohne eigenen Server.
Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar
Frag einfach
Beispiel-Prompts für Telegram Bot
Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.
Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.
💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Telegram Bot klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein
git clone, kein lokaler Server.
Telegram Bot + Gemini
Sende Telegram-Nachrichten, Fotos, Alben, Dokumente, Audio, Videos, Animationen, Sticker, Kontakte, Orte, Standorte und Umfragen aus jedem KI-Agent über die Telegram Bot API. 33 Tools, Authentifizierung per Bot-Token. Ausgehende Nachrichten plus ein schlankes Lesen der letzten Updates (kein Long-Polling).
Voraussetzungen
Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:
TELEGRAM_BOT_TOKEN
Schritt 1 — Zugangsdaten holen
- Öffne in Telegram einen Chat mit @BotFather, sende
/newbotund wähle einen Anzeigenamen sowie einen Benutzernamen, der aufbotendet. - BotFather antwortet mit einem Token wie
123456789:ABCdef.... Behandle ihn als Geheimnis: Wer ihn hat, kann als dein Bot senden. - Füge den vollständigen Token in
TELEGRAM_BOT_TOKENein und installiere den Connector. Telegram erwartet den Token in der Anfrageadresse, und der Connector setzt ihn dort für dich ein. - Starte mit
telegram_bot_get_me, um zu prüfen, ob der Token funktioniert.
Wen der Bot erreicht: Jeder Chat hat eine numerische chat_id. Ein Nutzer muss deinem Bot mindestens einmal /start geschickt haben, und in Gruppen und Kanäle muss der Bot zuerst aufgenommen werden. Öffentliche Kanäle akzeptieren auch @channelusername; private Kanäle brauchen die numerische ID, die mit -100 beginnt. telegram_bot_get_updates zeigt die letzten eingehenden Nachrichten mit ihren Chat-IDs.
Was er sendet: Textnachrichten (HTML-Formatierung ist die sicherste Wahl), Fotos, Alben, Dokumente, Audiodateien, Sprachnachrichten, Videos, GIF-Animationen, Sticker, Kontaktkarten, Orte, Standorte (auch Live-Standorte) sowie Umfragen oder Quizze. Er kann außerdem seine eigenen Nachrichten bearbeiten und löschen und Chat-Details lesen.
Alben: telegram_bot_send_album sendet 2 bis 10 Fotos und Videos als eine gruppierte Nachricht, oder 2 bis 10 Dokumente, oder 2 bis 10 Audiodateien; Dokumente und Audio lassen sich nicht mit anderen Typen mischen. Die Bildunterschrift kommt an das erste Element. Meldet Telegram WEBPAGE_CURL_FAILED für ein Element, konnte es diese Datei nicht herunterladen: Der Link muss öffentlich sein und direkt auf die Datei zeigen, nicht auf eine Webseite.
Dateien: Medien werden per HTTPS-Link gesendet (bis 5 MB für Fotos und 20 MB für andere Dateien) oder über die file_id von etwas, das schon einmal gesendet wurde. Eine Datei von deinem Computer im selben Aufruf hochzuladen, wird nicht unterstützt.
Reaktionen, Anheften und Chat-Verwaltung: Der Bot kann mit einem Emoji auf eine Nachricht reagieren und die Bildunterschrift eines Fotos, Videos oder Dokuments ändern, das er gesendet hat. In Gruppen und Kanälen, in denen er Administrator mit dem passenden Recht ist (Nachrichten anheften, Chat-Infos ändern, Nutzer einladen, Themen verwalten), heftet er Nachrichten an und löst sie wieder, benennt den Chat um, ändert seine Beschreibung, erstellt zusätzliche Einladungslinks (benannt, mit Ablaufdatum oder begrenzter Zahl von Beitritten) und eröffnet Themen in Forum-Gruppen. Außerdem kann er vorhandene Bilder zu einem neuen Sticker-Set eines Nutzers zusammenstellen und weitere Sticker hinzufügen. telegram_bot_get_webhook_info zeigt, ob der Bot einen Webhook hat; solange einer gesetzt ist, antwortet telegram_bot_get_updates mit 409 Conflict. telegram_bot_remove_webhook löscht den Webhook und ist bei der Installation ausgeschaltet, denn der Dienst, der ihn empfängt (ein Chatbot, eine Automatisierung), bekommt danach keine Nachrichten mehr: Schalte es bewusst auf der Connector-Seite ein; die KI fragt vor jeder Änderung nach.
Schon installiert? Ein früher installierter Connector bekommt die neuen Tools über sein Katalog-Update: Öffne den Connector in AnythingMCP, prüfe unter Catalog update available die Liste der neuen Tools und klicke auf Apply update. Dein Bot-Token und alle Tools, die du selbst hinzugefügt hast, bleiben unverändert, und telegram_bot_remove_webhook kommt ausgeschaltet an, wie bei einer Neuinstallation.
Ratenlimits: etwa 30 Nachrichten pro Sekunde über verschiedene Chats, 1 pro Sekunde an denselben Chat und 20 pro Minute an dieselbe Gruppe. Bei einem 429 sagt Telegram, wie lange du warten musst.
Der Connector liest die letzten Updates, wenn du danach fragst, und betreibt keinen Chatbot, der von sich aus antwortet. Dafür braucht es einen Webhook, den du selbst hostest. Zahlungen, Inline-Modus und Spiele sind nicht abgedeckt.
Schritt 2 — Adapter installieren
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Schritt 3 — Connector in Gemini hinzufügen
Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (
https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese AnleitungYOUR_SERVER_IDzeigt.
Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von
YOUR_MCP_API_KEYein. - Speichere die Datei und starte
geminineu. - Führe in der Gemini CLI
/mcpaus (odergemini mcp listim Terminal):anythingmcpsollte als verbunden erscheinen. - Leg los: Gemini CLI kann jetzt die
Telegram Bot-Tools aufrufen.
Verfügbare Tools
| Tool | What it does |
|---|---|
telegram_bot_get_me | Return the bot's own user info: id, username, first_name, can_join_groups, can_read_all_group_messages, supports_inline_queries |
telegram_bot_send_message | Send a text message to a chat |
telegram_bot_send_photo | Send a photo (JPG/PNG, ≤5MB via URL) by HTTPS URL or by reusable file_id |
telegram_bot_send_document | Send a document (any type, ≤20MB via URL) by HTTPS URL or file_id |
telegram_bot_send_audio | Send an audio file (MP3, M4A, ≤20MB via URL) |
telegram_bot_send_voice | Send a voice note (OGG-Opus encoded) |
telegram_bot_send_video | Send a video (MP4, H.264, AAC, ≤20MB via URL) |
telegram_bot_send_location | Send a location point |
telegram_bot_send_poll | Send a poll (regular or quiz) |
telegram_bot_edit_message_text | Edit the text of a previously-sent message (your bot's own messages only) |
telegram_bot_delete_message | Delete a message the bot sent (within ~48 hours for groups, anytime for own DMs) |
telegram_bot_get_chat | Fetch chat info: title, type (private/group/supergroup/channel), photo, description, invite_link, member_count, permissions |
telegram_bot_get_updates | Long-poll recent inbound messages (one-shot: pulls all updates since the last offset+1) |
telegram_bot_send_album | Send 2 to 10 photos or videos as one album (sendMediaGroup), or 2 to 10 documents, or 2 to 10 audio files; documents and audio cannot be… |
telegram_bot_send_animation | Send a GIF or a silent MP4 animation by HTTPS URL or file_id; Telegram plays it on a loop |
telegram_bot_send_sticker | Send a sticker by file_id (any sticker the bot has seen, e.g. from telegram_bot_get_updates) or by HTTPS URL of a .WEBP image |
telegram_bot_send_contact | Send a phone contact card that the recipient can save or call |
telegram_bot_send_venue | Send a venue: a map pin with a name and address, e.g. a shop or meeting point |
telegram_bot_get_file | Look up a file the bot received (photo, document, voice note, video) by its file_id, from a message in telegram_bot_get_updates |
telegram_bot_download_file | Download a file by the file_path telegram_bot_get_file returned |
telegram_bot_fetch_sticker_set | Read a sticker set (or custom emoji set) by its name: title, sticker_type (regular, mask, custom_emoji) and every sticker with its emoji… |
telegram_bot_react_to_message | Set the bot's reaction on a message (the emoji under a message), or remove it with an empty list |
telegram_bot_pin_message | Pin a message in a chat, so it shows at the top |
telegram_bot_unpin_chat_message | Unpin a pinned message in a chat; without message_id the most recently pinned message is unpinned |
telegram_bot_rename_chat | Change the title of a group, supergroup or channel (1 to 128 characters); not possible for private chats |
telegram_bot_update_chat_description | Change the description of a group, supergroup or channel (0 to 255 characters; empty removes it) |
telegram_bot_add_forum_topic | Create a topic in a forum supergroup (a group with topics enabled) |
telegram_bot_edit_message_caption | Edit the caption of a photo, video, document, audio or animation message the bot sent (an empty caption removes it) |
telegram_bot_create_chat_invite_link | Create an additional invite link for a group, supergroup or channel, optionally named, expiring, limited to a number of joins, or requiring… |
telegram_bot_create_sticker_set | Create a new sticker set owned by a user, with 1 to 50 first stickers from existing image files |
telegram_bot_extend_sticker_set | Add one sticker to a sticker set the bot created (telegram_bot_create_sticker_set) |
telegram_bot_get_webhook_info | Show whether the bot has a webhook: its url (empty when none), pending_update_count, the last error date and message, and allowed_updates |
telegram_bot_remove_webhook | Remove the bot's webhook so updates can be read with telegram_bot_get_updates again |
Beispiel-Prompts
- „Schick die Fotos von diesen vier Links als ein Album in unseren Team-Kanal, mit der Bildunterschrift ‚Neue Kollektion, ab heute live‘.“
- „Starte eine Umfrage in der Vertriebsgruppe: Welcher Tag passt für das Quartalsreview, Dienstag oder Donnerstag?“
- „Schick die Adresse unseres Ladens als Ort in den Kundenchat, damit der Kunde sie in seiner Karten-App öffnen kann.“
- „Zeig mir die Nachrichten, die der Bot in der letzten Stunde bekommen hat, und wer sie geschickt hat.“
- „Hefte in der Kundengruppe die Nachricht mit den Öffnungszeiten über die Feiertage an und reagiere darauf mit einem Daumen hoch.“
- „Erstelle für die Beta-Gruppe einen Einladungslink, der am Freitag abläuft und höchstens 50 Beitritte erlaubt.“
FAQ
Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.
Nächste Schritte
- Connector-Startseite
- Mit Claude verbinden
- Mit ChatGPT verbinden
- Mit Cursor verbinden
- Mit Meta Muse verbinden
- Mit Microsoft Copilot verbinden
War dieser Guide hilfreich?