Serwer MCP Telegram dla agentów AI

Metricgram udostępnia Telegram Bot API jako hostowany serwer MCP, dzięki czemu Twój agent AI może czytać, publikować, moderować i administrować Twoimi grupami Telegram z kluczami o ograniczonych uprawnieniach i bez utrzymywania kodu bota.

  • Ponad 70 metod Telegram Bot API jako narzędzia MCP
  • Działa z Claude, ChatGPT, Cursor i Codex
  • Każde wywołanie ograniczone do Twoich grup
  • Analityka, członkowie i subskrybenci na tym samym serwerze
Bez karty kredytowej Skonfiguruj w 2 minuty

Jak to działa

1

Dodaj bota i połącz grupy

Dodaj bota Metricgram (lub własnego bota) do swoich grup Telegram jako administratora. Żadnych serwerów, webhooków ani pollingu do utrzymania.

2

Utwórz klucz API z wybranymi uprawnieniami

Wygeneruj klucz API w planie Elite i wybierz dokładnie, co agent może robić, od dostępu tylko do odczytu po publikowanie, moderację i ustawienia czatu.

3

Podłącz go do klienta AI

Wklej jeden blok konfiguracji do Claude, Cursor, Codex lub dowolnego klienta MCP. Twój agent widzi teraz każdą dozwoloną akcję w Telegramie jako narzędzie.

Jedno polecenie, prawdziwe akcje w Telegramie

Agent wybiera odpowiednie wywołania Bot API, Metricgram wykonuje je we właściwej grupie i zwraca uporządkowane wyniki.

metricgram · mcp

Prosisz

Opublikuj w Crypto Talk ogłoszenie o tegotygodniowym AMA, przypnij je po cichu, otwórz temat "Pytania do AMA" i daj mi link zapraszający, który wygaśnie w piątek.

Agent wywołuje

  • 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")

Połącz dowolnego klienta MCP

Użyj hostowanego endpointu ze swoim kluczem API. W Claude Desktop można go podłączyć przez mcp-remote.

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

Narzędzia, które dostaje Twój agent

Wiadomości i multimedia

send_telegram_message send_telegram_media send_telegram_poll edit_telegram_message delete_telegram_messages forward_telegram_message react_to_telegram_message

Przypięte wiadomości i tematy forum

pin_telegram_message manage_forum_topic createForumTopic closeGeneralForumTopic unpinAllForumTopicMessages

Moderacja i prośby o dołączenie

ban_member restrict_member promote_member handle_telegram_join_request banChatSenderChat setChatAdministratorCustomTitle

Ustawienia czatu i linki zapraszające

update_telegram_chat_settings create_telegram_invite_link revokeChatInviteLink setChatPermissions setChatStickerSet

Analityka i dane społeczności

analytics_overview active_users list_members list_messages gamification_rankings get_subscriber_health

Każda obsługiwana metoda Bot API

telegram_api_methods telegram_bot_api get_telegram_chat get_telegram_chat_member

Telegram Bot API przygotowane dla agentów AI

Integracja Telegrama z agentem zwykle oznacza hostowanie bota, obsługę webhooków, przechowywanie tokenów i pisanie narzędzia dla każdego endpointu. Metricgram już uruchamia bota w Twoich grupach, więc agent dostaje Bot API jako gotowe narzędzia MCP z jednego hostowanego endpointu.
01

Typowane narzędzia i pełna bramka Bot API

Najczęstsze zadania, takie jak wysyłanie wiadomości, multimediów, ankiet, przypinanie, tematy i linki zapraszające, mają dedykowane, dobrze opisane narzędzia. Cała reszta przechodzi przez telegram_bot_api, które przyjmuje oficjalne nazwy metod i parametry Bot API, więc nic z obsługiwanego katalogu nie jest poza zasięgiem.
02

Ograniczone do Twoich grup

Agent nigdy sam nie wybiera chat_id. Metricgram wyznacza go na podstawie grupy, której jesteś właścicielem, sprawdza przekazywane i cytowane wiadomości względem Twoich pozostałych grup i odrzuca wszystko, co mogłoby trafić do innego czatu.
03

Uprawnienia na każdy poziom zaufania

Nadaj telegram:read agentom badawczym, telegram:write do publikowania i tematów, telegram:moderate do banów i próśb o dołączenie oraz telegram:admin do tytułów, uprawnień i linków zapraszających. Klucze możesz w każdej chwili odwołać.
04

Bezpieczne ponowienia i czytelne błędy

Narzędzia zapisujące przyjmują klucz idempotencji, więc ponowione wywołanie nigdy nie opublikuje niczego dwa razy. Błędy Telegrama i limity zapytań wracają jako uporządkowane wyniki z retry_after, które agent obsłuży samodzielnie.
05

Kontekst, którego zwykłe boty nie mają

Ten sam serwer udostępnia analitykę Metricgram, historię członków, zapisane wiadomości, grywalizację, podsumowania AI i kondycję subskrybentów Stripe, dzięki czemu agent może zdecydować, co zrobić, zanim zacznie działać.

Metricgram vs. zarządzanie ręczne

Metricgram Ręcznie
Hostowany endpoint MCP, bez własnego serwera bota
Ponad 70 metod Telegram Bot API jako narzędzia
chat_id ograniczony do Twoich grup
Klucze API z osobnymi uprawnieniami, które możesz odwołać
Idempotentne ponowienia dla narzędzi zapisujących
Analityka i historia członków jako kontekst
Dane czatu na żywo, administratorzy i uprawnienia
Działa z Twoim własnym botem

Najczęściej zadawane pytania

Czym jest serwer MCP Telegram?
To serwer Model Context Protocol, który udostępnia akcje Telegrama jako narzędzia, z których może korzystać agent AI. Metricgram hostuje go za Ciebie, w oparciu o bota, który już zarządza Twoimi grupami.
Z jakimi klientami AI działa?
Z każdym klientem obsługującym MCP przez HTTP, w tym z Claude Code, Claude Desktop (przez mcp-remote), Cursor, Codex oraz własnymi agentami zbudowanymi na SDK OpenAI lub Anthropic.
Czy obejmuje całe Telegram Bot API?
Obejmuje ponad 70 metod związanych z grupami, w tym wiadomości, multimedia, ankiety, edycje, reakcje, przypinanie, tematy forum, moderację, prośby o dołączenie, ustawienia czatu i linki zapraszające. Metody, które mogłyby wpłynąć na inne czaty lub samego bota, takie jak webhooki, płatności czy opuszczanie grupy, są celowo wyłączone.
Czy agent może publikować w grupach, których nie jestem właścicielem?
Nie. Każde wywołanie jest powiązane z jedną z Twoich połączonych grup. chat_id ustawia Metricgram, a przekazania i odpowiedzi mogą odnosić się wyłącznie do Twoich grup.
Czy to API użytkownika Telegrama (MTProto)?
Nie. Korzysta z oficjalnego Bot API przez bota Twojej grupy, więc agent działa jako bot, a nigdy jako Twoje prywatne konto Telegram.
Który plan obejmuje serwer MCP?
Dostęp do MCP i API jest częścią planu Elite. 14-dniowy darmowy okres próbny daje dostęp na poziomie Elite, więc możesz podłączyć agenta, zanim zapłacisz.
Czy mogę ograniczyć, co agent może robić?
Tak. Każdy klucz API ma własne uprawnienia, a Ty możesz tworzyć osobne klucze do analiz tylko do odczytu, publikowania, moderacji i administracji.

Rozpocznij w kilka minut

Połącz swoją grupę na Telegramie w kilka minut i wypróbuj wszystkie funkcje za darmo przez 14 dni.

Zobacz cennik