Telegram Bot über MCP mit Microsoft Copilot verbinden

💡 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 + Microsoft Copilot

Sende Telegram-Nachrichten, Fotos, Alben, Dokumente, Audio, Videos, Animationen, Sticker, Kontakte, Orte, Standorte und Umfragen aus jedem KI-Agent über die Telegram Bot API. 21 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

1. Öffne in Telegram einen Chat mit @BotFather, sende /newbot und wähle einen Anzeigenamen sowie einen Benutzernamen, der auf bot endet.
2. BotFather antwortet mit einem Token wie 123456789:ABCdef.... Behandle ihn als Geheimnis: Wer ihn hat, kann als dein Bot senden.
3. Füge den vollständigen Token in TELEGRAM_BOT_TOKEN ein und installiere den Connector. Telegram erwartet den Token in der Anfrageadresse, und der Connector setzt ihn dort für dich ein.
4. 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.

Schon installiert? Die Tools für Alben, Animationen, Sticker, Kontakte und Orte kommen über das Katalog-Update zu einem früher installierten Connector: Ö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.

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, Spiele und die Verwaltung von Sticker-Sets 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 Microsoft Copilot 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 Anleitung YOUR_SERVER_ID zeigt.

Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.

1. Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
2. Trag einen Server name ein (zum Beispiel AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft.
3. Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf X-API-Key und klicke auf Create.
4. Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
5. Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die Telegram Bot-Tools braucht.
6. Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.

Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, localhost funktioniert deshalb nicht.

Verfügbare Tools

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.“

FAQ

Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.

Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.

Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden