Serwer MCP Telegram: bezpieczny dostęp agentów AI do pełnego Telegram Bot API

Dlaczego agenci AI potrzebują pomostu do Telegrama

Agenci AI coraz lepiej radzą sobie z prawdziwymi narzędziami. Potrafią przeczytać dashboard, ocenić, co jest ważne, i wykonać kolejny krok. Żeby jednak działać w Telegramie, potrzebują pomostu: czegoś, co zamieni zdanie w rodzaju "przypnij ogłoszenie o AMA i otwórz temat na pytania" na właściwe wywołania Telegram API.

Tym pomostem jest serwer MCP Telegram.

Model Context Protocol (MCP) to otwarty standard, dzięki któremu klienci AI tacy jak Claude, ChatGPT, Cursor i Codex mogą wykrywać narzędzia i je wywoływać. Serwer MCP Telegram udostępnia akcje Telegrama właśnie jako takie narzędzia, z jasnymi opisami i schematami danych wejściowych, którymi model może się kierować.

Metricgram uruchamia teraz taki serwer za Ciebie, w oparciu o bota, który już zarządza Twoimi grupami.

Co naprawdę oznacza obudowanie Telegram Bot API

Na papierze przygotowanie Bot API dla agenta brzmi prosto. W praktyce musisz:

• Hostować bota, chronić jego token i dbać o to, żeby stale działał.
• Odbierać aktualizacje przez webhooki lub polling.
• Napisać definicję narzędzia dla każdego endpointu, z którego ma korzystać agent.
• Powstrzymać agenta przed publikowaniem w czatach, których nigdy nie powinien dotykać.
• Obsługiwać limity zapytań, zmigrowane supergrupy i komunikaty błędów Telegrama.
• Zabezpieczyć ponowienia, żeby jedno niestabilne połączenie nie wysłało tej samej wiadomości dwa razy.
• Rejestrować, co zrobił agent, na wypadek gdybyś musiał to później wyjaśnić.

Większość zespołów kończy na "wyślij wiadomość", bo cała reszta to mnóstwo pracy infrastrukturalnej. Efekt to agent, który potrafi mówić, ale nie potrafi naprawdę zarządzać społecznością.

Jak działa serwer MCP Telegram od Metricgram

Metricgram już działa w Twoich grupach Telegram jako bot administrator (lub jako Twój własny bot). Serwer MCP po prostu pozwala klientowi AI korzystać z tego bota przez hostowany endpoint:

1. Połącz swoje grupy z Metricgram i nadaj botowi uprawnienia administratora.
2. Dodaj endpoint https://metricgram.com/api/v1/mcp do swojego klienta AI, na przykład jako niestandardowy konektor w Claude.
3. Zaloguj się i zatwierdź dostęp przez OAuth. To wszystko: żadnych serwerów, webhooków ani tokenów do zarządzania. Klienci bez OAuth mogą zamiast tego użyć klucza API z konfiguracją poniżej.

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

Użytkownicy Claude Desktop mogą podłączyć ten sam endpoint przez mcp-remote. Dokładne fragmenty konfiguracji dla każdego klienta znajdziesz na stronie MCP w swoim Managerze.

Ponad 70 metod Bot API i dwa sposoby ich wywołania

Serwer udostępnia Telegram Bot API w dwóch warstwach.

Typowane narzędzia do codziennej pracy

Najczęstsze zadania mają dedykowane narzędzia z opisowymi parametrami, dzięki którym modele łatwo używają ich poprawnie:

• send_telegram_message z tematami, odpowiedziami i przyciskami URL
• send_telegram_media dla zdjęć, filmów, GIF-ów, dokumentów, audio i naklejek
• send_telegram_poll dla ankiet i quizów
• edit_telegram_message, delete_telegram_messages, react_to_telegram_message
• pin_telegram_message i forward_telegram_message
• manage_forum_topic do tworzenia, zmiany nazwy, zamykania, ponownego otwierania i usuwania tematów
• get_telegram_chat i get_telegram_chat_member dla danych czatu na żywo
• handle_telegram_join_request, create_telegram_invite_link i update_telegram_chat_settings

Pełna bramka Bot API

Cała reszta przechodzi przez telegram_bot_api. Agent przekazuje oficjalną nazwę metody Bot API i jej parametry, na przykład setChatPermissions, banChatSenderChat, editMessageMedia, hideGeneralForumTopic lub revokeChatInviteLink. Narzędzie pomocnicze telegram_api_methods wyświetla każdą metodę, z której może korzystać bieżący klucz, więc agent zawsze wie, co jest dostępne.

Bezpieczeństwo: dlaczego agent nigdy nie wybiera chat_id

Najważniejsza decyzja projektowa dotyczy tego, czego agent nie może zrobić.

• Czat jest zablokowany. Agent przekazuje group_id z Metricgram. Serwer wyznacza chat_id Telegrama na podstawie grupy, której jesteś właścicielem, i odrzuca każdy inny czat.
• Przekazania i cytaty są sprawdzane. Wiadomość można przekazać, skopiować lub zacytować tylko z Twoich własnych grup.
• Akcje dotyczące całego bota są wyłączone. Webhooki, płatności, zmiany profilu bota i opuszczanie grupy nie są udostępniane.
• Przyciski są bezpieczne. Przyciski inline mogą otwierać adresy URL lub kopiować tekst, ale nie mogą wywoływać callbacków do bota.
• Uprawnienia odpowiadają poziomowi zaufania. telegram:read, telegram:write, telegram:moderate i telegram:admin są rozdzielone, a Ty możesz mieć kilka kluczy o różnych uprawnieniach.
• Ponowienia są idempotentne. Narzędzia zapisujące przyjmują idempotency_key, więc ponowione wywołanie zwraca pierwszy wynik zamiast działać dwa razy.
• Każde wywołanie jest rejestrowane wraz z narzędziem i użytą metodą Bot API.

Agent działa jako bot przez oficjalne Bot API, a nigdy jako Twoje prywatne konto Telegram.

Kontekst, którego nie ma zwykły bot

Prosty wrapper Bot API potrafi działać, ale niewiele widzi. Serwer MCP Metricgram udostępnia też wiedzę o społeczności:

• Przegląd analityki i szeregi czasowe aktywności
• Aktywnych członków, historię członków i zapisane wiadomości
• Rankingi i nagrody grywalizacji
• Podsumowania AI tego, co działo się w grupie
• Kondycję subskrybentów Stripe i zagrożone odnowienia

Dzięki temu agent może odpowiedzieć na pytanie "kto przestał się udzielać w tym miesiącu?", a potem wysłać tym osobom przemyślaną wiadomość, wszystko w jednej rozmowie.

Przykładowe scenariusze

Cotygodniowe ogłoszenie. "Opublikuj w Crypto Talk cotygodniowe ogłoszenie o AMA, przypnij je bez powiadamiania wszystkich, otwórz temat na pytania do AMA i utwórz link zapraszający, który wygaśnie w piątek."

Przegląd moderacyjny. "Sprawdź ostatnie 200 wiadomości pod kątem linków ze spamem, usuń je i ogranicz nadawców na 24 godziny."

Raport o społeczności. "Porównaj aktywność z tego tygodnia z poprzednim, wypisz pięciu najaktywniejszych członków i opublikuj krótkie podziękowanie w temacie General."

Obsługa próśb o dołączenie. "Zatwierdź oczekujące prośby o dołączenie od użytkowników z aktywną subskrypcją, a pozostałe odrzuć."

Dla kogo to jest

• Właściciele społeczności, którzy chcą asystenta do rutynowej pracy administracyjnej.
• Agencje, które zarządzają wieloma grupami klientów i chcą jednego agenta dla wszystkich.
• Zespoły wsparcia i customer success, które prowadzą społeczności klientów na Telegramie.
• Programiści, którzy chcą mieć Telegram w swoim stosie agentowym bez utrzymywania infrastruktury bota.

Jak zacząć

Serwer MCP jest dostępny w każdym planie Metricgram i w 14-dniowym darmowym okresie próbnym, więc możesz podłączyć agenta, zanim zapłacisz. Większość klientów łączy się przez OAuth: wklej adres URL serwera, zaloguj się i zatwierdź dostęp. Klucze API pozostają dostępne dla klientów bez OAuth.

Więcej przeczytasz na stronie serwera MCP Telegram i w przeglądzie funkcji MCP. Potem utwórz swój pierwszy klucz w Managerze.