API- & MCP-Zugriff

API- & MCP-Zugriff

Metricgram enthält eine öffentliche API und einen MCP-Server, mit denen Sie eigene Tools, Dashboards, Automatisierungen oder KI-Clients mit den Daten und Aktionen Ihres Kontos verbinden können.

Der MCP-Server ist in allen bezahlten Plänen und während der 14-tägigen Testphase verfügbar. KI-Clients können sich per OAuth (Server-URL einfügen und Zugriff genehmigen) oder mit einem API-Schlüssel verbinden. Die REST-API erfordert Elite-Zugriff. Wenn Ihr Konto sie nicht enthält, kann der Bereich API gesperrt erscheinen oder einen Upgrade-Hinweis anzeigen.

Wo Sie ihn finden

Öffnen Sie Integrationen > MCP oder Integrationen > API im Verwaltungsbereich. Konten mit Zugriff können dort API-Tokens erstellen, aktive Tokens prüfen, Tokens widerrufen und die technische Referenz sehen, die für ihren Plan verfügbar ist.

So funktionieren Tokens

• Tokens gehören zu Ihrem Metricgram-Benutzerkonto, nicht zu einer einzelnen Gruppe.
• Ein Token kann auf die Gruppen und Ressourcen zugreifen, die Ihr Konto verwalten darf.
• Tokens enthalten Berechtigungen für Bereiche wie Gruppen, Mitglieder, Nachrichten, Automatisierungen, Abonnenten, Analysen, Support-Tickets, Empfehlungen und MCP.
• Einige Endpoints lesen nur Daten; andere können je nach Token-Berechtigungen erstellen, aktualisieren, moderieren oder Aktionen auslösen.
• Der Token-Wert wird nur einmal beim Erstellen angezeigt. Bewahren Sie ihn sicher auf.

Telegram Bot API über MCP

Der MCP-Server stellt außerdem eine auf Ihre Gruppen beschränkte Telegram Bot API bereit. So können KI-Agenten über den Metricgram-Bot oder Ihren eigenen Bot in Ihren Gruppen handeln.

• Mit telegram_api_methods listen Sie die Methoden auf, die Ihr Token aufrufen darf, und mit telegram_bot_api rufen Sie jede davon mit den offiziellen Parametern der Bot API auf.
• Typisierte Tools decken die tägliche Arbeit ab: send_telegram_message, send_telegram_media, send_telegram_poll, pin_telegram_message, manage_forum_topic, create_telegram_invite_link und weitere.
• Der Chat ist immer eine Ihrer eigenen Gruppen. Sie übergeben nie eine chat_id; Metricgram leitet sie aus der group_id ab.
• Telegram-Aktionen haben eigene Berechtigungen: telegram:read, telegram:write, telegram:moderate und telegram:admin. Tokens, die vor der Einführung dieser Berechtigungen erstellt wurden, müssen neu angelegt werden, um sie zu nutzen.
• Medien müssen eine öffentliche HTTPS-URL oder eine Telegram-file_id sein, und Inline-Buttons können nur URLs öffnen oder Text kopieren.
• Schreibende Tools akzeptieren einen optionalen idempotency_key, damit ein wiederholter Aufruf nicht doppelt ausgeführt wird.

Authentifizierung und Limits

API-Anfragen verwenden den Header Authorization: Bearer mg_.... Das Standardlimit beträgt 600 Anfragen pro Minute pro Token, und im Formular können Sie einen Wert innerhalb des von der App erlaubten Minimums und Maximums wählen.

Wenn ein Token widerrufen wird, das Konto den API-Zugriff verliert oder der Plan API & MCP nicht mehr enthält, werden Anfragen mit diesem Token abgelehnt.

Gute Praxis

• Erstellen Sie getrennte Tokens für verschiedene externe Tools.
• Verwenden Sie klare Namen, damit Sie erkennen, wo jeder Token genutzt wird.
• Widerrufen Sie Tokens, die Sie nicht mehr brauchen.
• Teilen Sie Tokens nicht in Chats, Screenshots, Tickets oder öffentlichen Repositories.