Gemini · Google

Gemini Telegram MCP - dla Gemini i CLI

Używaj Entergram jako serwera Telegram MCP dla Google Gemini i Gemini CLI. Daj Gemini bezpieczny dostęp do prawdziwych czatów Telegram, ograniczony zakresami OAuth, aby wyłapywał przeoczone wiadomości, czekających klientów i wystygłe leady.

Adres URL serwera MCP https://mcp.entergram.com/mcp

Zacznij bezpłatnie Zobacz wszystkie konektory

Połącz Gemini w 3 krokach

Działa z Gemini CLI i klientami Gemini zgodnymi z MCP.

Adres URL serwera MCP https://mcp.entergram.com/mcp

Zacznij w Entergram: adres serwera znajdziesz w Settings → Workspace → Connectors → MCP. Skopiuj go do schowka, bo Gemini CLI czyta go z pliku konfiguracyjnego, a nie z pola formularza.
Dodaj Entergram do konfiguracji MCP w Gemini CLI z adresem: https://mcp.entergram.com/mcp.
Uruchom CLI ponownie, żeby wczytało nowy serwer, zaloguj się do Entergram w otwartej przeglądarce i przyznaj ograniczony zakresami dostęp do swojej przestrzeni roboczej.

Zadawaj Gemini pytania, których nie zadasz Telegramowi

Gdy twoje osobiste konto jest połączone, Gemini analizuje wszystkie czaty naraz. Wypróbuj prompty takie jak:

„Które czaty mają pytania bez odpowiedzi z ostatnich trzech dni?”
„Wypisz kontakty z mojej grupy klientów, których nie ma w grupie społeczności.”
„Opublikuj zawartość build.log na kanale wydań.”
„Utwórz kanał Launch Updates i zaproś do niego główny zespół.”
„Popraw literówkę w mojej ostatniej wiadomości w wątku Acme.”
„Wyeksportuj zgłoszenia z tego miesiąca jako TSV do wklejenia w arkusz.”

Co Gemini potrafi zrobić z twoim Telegramem

Zarówno Gemini CLI, jak i klienty Gemini zgodne z MCP mogą rejestrować zewnętrzne serwery MCP. Dodaj adres Entergram, a Gemini zyska ograniczony zakresami, zabezpieczony przez OAuth dostęp do twojego prawdziwego osobistego konta Telegram. Bez bota do utrzymywania, bez kodu i bez kluczy API do przechowywania.

Przeszukiwać czaty bez wychodzenia z terminala
Porównywać listę klientów z listą członków społeczności
Publikować wynik builda lub plik prosto w czacie
Tworzyć kanał i od razu dodawać do niego właściwych członków
Poprawiać wiadomość w miejscu zamiast wysyłać ją ponownie
Eksportować dane zgłoszeń jako tekst rozdzielany tabulatorami do arkusza

Zadania w terminalu, które warto podpiąć

W CLI to jednolinijkowe wywołania, które możesz schować za aliasem powłoki lub hookiem git. Każda prośba w zwykłym języku rozwija się w sekwencję wywołań narzędzi, a CLI wypisuje, które z nich wykonało, więc możesz obejrzeć mechanikę, zanim powierzysz mu zapis. Wszystko poniżej zakłada, że serwer został raz zarejestrowany i autoryzowany. Potem zostaje już tylko pisanie.

Dowiedz się więcej

Pytasz

„Opublikuj informacje o wydaniu z CHANGELOG.md na kanale beta.”

Wywołane narzędzia

entergram_list_accountsentergram_list_groupsentergram_send_message

Otrzymujesz

Krok po wdrożeniu, o którym nikt nie pamięta. Gemini ma już changelog w kontekście z repozytorium, wybiera konto administrujące kanałem, dopasowuje kanał po nazwie i publikuje. Podepnij to pod udany build, a ogłoszenie przestanie zależeć od czyjejś pamięci.

Pytasz

„Kto jest na kanale beta, a nigdy nie został oznaczony jako płacący klient?”

Wywołane narzędzia

entergram_list_group_membersentergram_list_contactsentergram_get_chat_custom_fields

Otrzymujesz

Różnica zbiorów między dwoma systemami, które zwykle żyją w różnych kartach przeglądarki. Gemini wylicza członków kanału, dopasowuje ich do listy kontaktów, a potem czyta pola CRM, by sprawdzić, kto ma oznaczenie klienta. Wynik to ta połowa twojej społeczności, która jeszcze nie kupiła, z imienia i nazwiska.

Pytasz

„Wyślij wynik nieudanego testu do wątku Acme z krótkim wyjaśnieniem.”

Wywołane narzędzia

entergram_list_chatsentergram_send_media_message

Otrzymujesz

Plik leży już na dysku obok ciebie, więc odpada całe przesyłanie. Gemini dołącza plik i sam pisze zdanie wprowadzenia. To różnica między klientem, który widzi ścianę stack trace, a klientem, który wie, co się zepsuło i kiedy zostanie naprawione.

Pytasz

„Utwórz kanał premiery, nazwij go porządnie i dodaj zespół wydania.”

Wywołane narzędzia

entergram_create_channelentergram_update_chat_infoentergram_invite_chat_members

Otrzymujesz

Trzy kroki w interfejsie Telegrama zamieniają się w jedno zdanie. Kanał powstaje, tytuł i opis są ustawiane według twojego opisu, a lista zaproszeń jest ustalana na podstawie kontaktów. To wymaga konektora przestrzeni roboczej: administrowanie grupami nie należy do zakresów agenta osobistego.

Pytasz

„W tym ogłoszeniu jest literówka w numerze wersji, popraw ją.”

Wywołane narzędzia

entergram_list_messagesentergram_edit_message

Otrzymujesz

Gemini czyta ostatnią historię, by ustalić, o którą wiadomość chodzi, i edytuje ją w miejscu, zamiast publikować poprawkę pod spodem. Telegram zostawia wiadomość tam, gdzie była, więc nikt, kto już ją przeczytał, nie dostaje kolejnego powiadomienia, a historia kanału pozostaje czysta.

Pytasz

„Daj mi liczbę zgłoszeń z tego tygodnia według osoby przypisanej, w formacie TSV.”

Wywołane narzędzia

entergram_list_ticketsentergram_list_ticket_custom_columnsentergram_list_members

Otrzymujesz

Formatowanie wyniku to miejsce, w którym klient terminalowy pokazuje swoją wartość. Gemini pobiera kolejkę, przekłada kolumny kategorii i ważności na rzeczywiste wartości opcji, zamienia ID osób przypisanych na nazwiska i wypisuje wiersze rozdzielone tabulatorami, które możesz przekierować prosto do arkusza lub skryptu z wykresami. Doraźne raportowanie, bez budowania raportu.

Gdzie zarejestrować serwer

Dowiedz się więcej

Gemini CLI, zakres użytkownika

Główna ścieżka i to, co większość osób ma na myśli, mówiąc o Gemini MCP. Dodaj serwer do ~/.gemini/settings.json w sekcji mcpServers, z httpUrl wskazującym hostowany punkt końcowy, uruchom CLI ponownie, a narzędzia będą dostępne w każdym projekcie na tym komputerze. Serwer jest zdalny (HTTPS), więc nie ma wrappera npx ani mostu stdio do podtrzymywania.

{ "mcpServers": { "entergram": { "httpUrl": "https://mcp.entergram.com/mcp" } } }

Gemini CLI, zakres projektu

Ten sam blok umieszczony w .gemini/settings.json wewnątrz repozytorium działa tylko w tej kopii roboczej. Przydaje się, gdy jedno repo to pipeline wdrożeń, który ogłasza wydania na kanale Telegram, a reszta twojej pracy nie powinna dotykać czatów. Konfiguracja trafia też do systemu kontroli wersji, gdzie osoba z zespołu może ją przeczytać.

mkdir -p .gemini && $EDITOR .gemini/settings.json

Dowolny klient z modelem Gemini

Punkt końcowy nie zależy od modelu. Agent w IDE, skryptowy harness lub wewnętrzne narzędzie działające na Gemini rejestruje Entergram tak, jak wymaga jego własna konfiguracja MCP, i dostaje identyczną listę narzędzi. Ekran zgody należy do Entergram, więc każdy, kto uruchamia klienta, autoryzuje się we własnym imieniu, zamiast dziedziczyć cudze uprawnienia.

Narzędzia dostępne w CLI

Po połączeniu wylistuj zarejestrowane serwery MCP, a wszystkie 78 narzędzi pojawi się pod entergram, pogrupowanych tak jak poniżej. Nazwy narzędzi to dosłowne identyfikatory, co w terminalu znaczy więcej niż w oknie czatu: możesz wskazać wywołanie wprost w prompcie, gdy chcesz przewidywalnego zachowania, zamiast pozwalać modelowi wybierać drogę. CLI wypisuje każde wywołanie z argumentami, więc nieznaną listę narzędzi szybko się poznaje.

Dowiedz się więcej

Pokaż wszystkie narzędzia (78, grupy: 9) →

Zgoda dla każdego komputera osobno

Nic w settings.json nie jest danymi uwierzytelniającymi. Plik mówi CLI tylko, gdzie jest serwer. Dostęp daje logowanie OAuth, które kończysz w przeglądarce, a powstały token należy do ciebie, nie do repozytorium. Google w żadnym momencie nie dostaje danych logowania do Telegrama: numer telefonu i sesja zostają w Entergram. Istnieją dwa zestawy zakresów, a wybór zależy od tego, czy CLI ma cokolwiek zapisywać.

Dowiedz się więcej

Zestaw zakresów agenta osobistego (Personal agent): Każdy członek może go utworzyć bez pytania administratora. Obejmuje odczyt przestrzeni roboczej, połączonych kont, kontaktów, czatów, wiadomości i zgłoszeń oraz zapis wartości pól niestandardowych we własnych czatach. Wystarcza do każdej analizy i eksportu z tej strony, ale nie do wysłania wiadomości.
Zestaw zakresów konektora przestrzeni roboczej (Workspace connector): Tylko dla właścicieli i administratorów, i to właśnie jego potrzebuje automatyzacja. Dodaje wysyłanie, media, edycję, zapis zgłoszeń, zapis pól niestandardowych w całej przestrzeni roboczej i administrowanie grupami Telegram. Jest współdzielony, a nie osobisty, więc komputer, na którym go autoryzujesz, traktuj z odpowiednią ostrożnością.
Odcięcie połączenia: Usunięcie wpisu z mcpServers sprawia, że CLI przestaje wywoływać serwer, ale niczego nie unieważnia. Żeby naprawdę odciąć dostęp, cofnij uprawnienia klienta po stronie Entergram w Settings → Workspace → Connectors → MCP. Działa to natychmiast, na każdym komputerze, który z niego korzystał.

Ograniczenia, pod które trzeba projektować

Większość z nich daje o sobie znać dopiero wtedy, gdy uruchamiasz CLI bez nadzoru.

Dowiedz się więcej

Rejestracja serwera to nie to samo co autoryzacja. Każdy komputer za pierwszym razem przechodzi ekran zgody osobno, więc nowy laptop lub przebudowany kontener przynajmniej raz potrzebuje przeglądarki.
Przestrzeń robocza Entergram musi być na planie Pro. Na niższym planie CLI bez problemu wylistuje serwer, a potem zbierze odmowy przy każdym wywołaniu. Wygląda to na zepsutą konfigurację, ale nią nie jest.
Nie ma domyślnego konta. Narzędzia wiadomości wymagają jawnego account_id, więc każdy skrypt musi najpierw pobrać listę kont. W czacie ledwo to zauważasz, w pipeline to jeszcze jedna rzecz do zapamiętania. Pobierz ją raz na początku skryptu i przekazuj dalej.
Agent osobisty nie może wysyłać ani administrować grupami. Automatyzacje, które publikują informacje o wydaniu lub tworzą kanały, potrzebują konektora przestrzeni roboczej autoryzowanego przez właściciela lub administratora.
Protokół działa w trybie żądanie i odpowiedź, a nie subskrypcji. Nic nie trafia do terminala samo z siebie: Gemini dowiaduje się o nowej wiadomości dopiero wtedy, gdy coś każe mu sprawdzić. Wszystko, co przypomina monitorowanie, musi być zaplanowanym zadaniem po twojej stronie.
CLI nie podnosi żadnych uprawnień. Widzi dokładnie te czaty, które widzi twoje konto Telegram, a grupy, z której konto wyszło, już nie przeczyta.

Problemy z CLI i ich przyczyny

Dowiedz się więcej

Serwer nie pojawia się na liście MCP

Prawie zawsze to błędny JSON: jeden przecinek na końcu sprawia, że CLI po cichu pomija cały plik ustawień. Zwaliduj go, upewnij się, że dla zdalnego serwera HTTPS kluczem jest httpUrl, a nie wpis stdio z command i args, i sprawdź, czy wpis naprawdę jest wewnątrz mcpServers.

Zmiany w settings.json nic nie dają

Konfiguracja jest czytana przy starcie. Zamknij sesję całkowicie i uruchom ją ponownie. Działający proces nadal serwuje listę narzędzi zbudowaną przy uruchomieniu, więc plik może być poprawny, a mimo to wyglądać na ignorowany.

OAuth nie kończy się na komputerze bez ekranu

Ekran zgody wymaga przeglądarki. Autoryzuj na stacji roboczej, przy której siedzisz, albo przekieruj port callbacku przez SSH. Agent buildów bez ekranu sam nie dokończy uzgadniania.

W jednym katalogu działa, w innym nie

Masz dwa pliki ustawień. Ten w ~/.gemini działa wszędzie, ten w .gemini wewnątrz repozytorium tylko tam. Zanim zmienisz cokolwiek innego, sprawdź, który z nich faktycznie zawiera wpis entergram.

Każde wywołanie zwraca 403

Najpierw sprawdź plan, potem rolę. Dostęp do MCP wymaga planu Pro, a wszystko ponad zestaw zakresów agenta osobistego wymaga uprawnień właściciela lub administratora w przestrzeni roboczej Entergram.

Odczyt działa, ale wysyłanie jest odrzucane

To granica agenta osobistego, a nie przejściowy błąd. Wysyłania w ogóle nie ma w jego zestawie zakresów, więc ponawianie nie pomoże. Właściciel lub administrator musi autoryzować konektor przestrzeni roboczej, a ty ponownie przechodzisz przez proces zgody.