Jak połączyć Google Gemini z Twoimi czatami w Telegramie

Google Gemini łączysz z czatami w Telegramie, rejestrując hostowany serwer MCP Entergram, https://mcp.entergram.com/mcp, w Gemini CLI i logując się raz do Entergram w przeglądarce. Od tego momentu Gemini może czytać Twoje czaty, kontakty i dane CRM przez Twoje prawdziwe, osobiste konto Telegram, a także działać na nich w zakresie uprawnień, które mu nadałeś. Konfiguracja to trzy kroki i jeden krótki blok JSON, pokazany niżej.

Gemini CLI to ścieżka, którą w całości opisuje strona Gemini Telegram MCP. Każdy inny klient zgodny z MCP, który korzysta z modelu Gemini, może użyć tego samego adresu URL, zarejestrowanego w sposób, jakiego wymaga dany klient.

• Obszar roboczy w planie Pro. API i MCP to funkcja planu Pro. W niższym planie CLI nadal pokaże serwer na liście, ale każde wywołanie zostanie odrzucone. Wygląda to na zepsutą konfigurację, choć nią nie jest.
• Co najmniej jedno podłączone konto Telegram na Twoim stanowisku. Osobisty konektor może korzystać tylko z kont Telegram widocznych w Settings → Accounts (Ustawienia → Konta) dla Twojego członka zespołu.
• Przeglądarka na tym komputerze przy pierwszym logowaniu. Ekran zgody jej wymaga, więc serwer bez interfejsu graficznego trzeba najpierw autoryzować ze zwykłej stacji roboczej.

Krok 1: Skopiuj adres URL MCP w Entergram

Przejdź do Settings → Workspace → Connectors → MCP (Ustawienia → Obszar roboczy → Konektory → MCP) i skopiuj adres URL serwera MCP. Jest taki sam dla każdego klienta:

https://mcp.entergram.com/mcp

Krok 2: Zarejestruj serwer w Gemini CLI

Dodaj Entergram w sekcji mcpServers w pliku ~/.gemini/settings.json. Serwer jest zdalny i działa przez HTTPS, dlatego kluczem jest httpUrl, a nie wpis z poleceniem i argumentami:

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

Plik w katalogu domowym obowiązuje dla każdego projektu na tym komputerze. Jeśli chcesz ograniczyć dostęp do Telegrama do jednego repozytorium, umieść ten sam blok w pliku .gemini/settings.json wewnątrz tego repozytorium.

Krok 3: Uruchom CLI ponownie i nadaj autoryzację

CLI wczytuje konfigurację przy starcie, więc całkowicie zamknij sesję i uruchom ją od nowa. Zaloguj się do Entergram w oknie przeglądarki, które się otworzy, i nadaj uprawnienia, jakie ma mieć Gemini. Nic w settings.json nie jest danymi logowania: plik mówi tylko, gdzie znajduje się serwer, a dostęp wynika z logowania OAuth.

Po autoryzacji wyświetl w CLI listę zarejestrowanych serwerów MCP. Narzędzia Entergram pojawią się pod nazwą entergram.

To, co może Gemini, zależy od rodzaju klienta, którego autoryzujesz, zgodnie z opisem na stronie pomocy o konektorach MCP:

Osobisty agent nie może wysyłać wiadomości w Telegramie. Jeśli odczyt działa, a wysyłanie jest odrzucane, to granica uprawnień, a nie błąd. Właściciel lub administrator musi autoryzować konektor obszaru roboczego, a Ty przechodzisz proces zgody ponownie, już dla niego. W obu przypadkach nadawaj najmniejszy zestaw uprawnień, jakiego wymaga zadanie: messages.write pozwala agentowi wysyłać wiadomości w Twoim imieniu.

Aby odciąć dostęp, unieważnij klienta w Entergram w Settings → Workspace → Connectors → MCP. Usunięcie wpisu z mcpServers sprawia tylko, że CLI przestaje wywoływać serwer. Nie unieważnia to nadanego dostępu.

Serwer MCP Entergram łączy się z Twoim osobistym kontem Telegram, a nie z botem, więc Gemini pracuje na tych samych czatach, które widzisz Ty. Polecenia, które dobrze działają w CLI:

• "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 informacje o wydaniu z CHANGELOG.md na kanale beta." (wymaga konektora obszaru roboczego)
• "Zrobiłem literówkę w numerze wersji w tym ogłoszeniu, popraw ją." (wymaga konektora obszaru roboczego)
• "Podaj liczbę zgłoszeń z tego tygodnia według osoby przypisanej, w formacie TSV."

CLI wypisuje każde wywołanie narzędzia, które wykonuje, więc możesz obejrzeć mechanikę na zadaniu tylko do odczytu, zanim powierzysz mu zapis.

• Narzędzia do wiadomości wymagają wskazania konta. Nie ma domyślnego konta, więc skrypt powinien najpierw pobrać listę kont i przekazać dalej identyfikator konta.
• Nic nie przychodzi samo. MCP działa na zasadzie żądanie i odpowiedź. Gemini dowiaduje się o nowej wiadomości dopiero wtedy, gdy Ty albo Twoje zaplanowane zadanie poprosi go o sprawdzenie.
• Brak podwyższonego dostępu. Gemini widzi dokładnie to, co widzą Twoje podłączone konta Telegram. Grupy, z której wyszedłeś, nie przeczyta, a czaty wykluczone w Accounts → Exclude chats (Konta → Wyklucz czaty) nie trafiają do wyników MCP.

• Serwer w ogóle nie pojawia się na liście MCP. Zwykle przyczyną jest błędny JSON: jeden zbędny przecinek na końcu sprawia, że CLI pomija cały plik ustawień. Sprawdź, czy wpis używa httpUrl i znajduje się wewnątrz mcpServers.
• Zmiany w settings.json nic nie dają. Zamknij sesję całkowicie i uruchom ją ponownie. Działający proces trzyma listę narzędzi zbudowaną przy starcie.
• Działa w jednym katalogu, a w innym nie. Masz dwa pliki ustawień. Sprawdź, czy wpis entergram jest w ~/.gemini, czy w folderze .gemini któregoś repozytorium.
• Każde wywołanie zwraca 403. Najpierw sprawdź plan (MCP wymaga Pro), potem rolę: wszystko poza zakresem uprawnień osobistego agenta wymaga właściciela lub administratora.

Serwer MCP Entergram jest ten sam dla każdego klienta. Skonfiguruj go raz i podłącz dowolnego klienta AI, jakiego wolisz, albo kilku naraz:

• Połącz Claude z Telegramem przez Entergram
• Połącz ChatGPT z Telegramem przez Entergram
• Połącz dowolne narzędzie AI z Telegram MCP

Pełną listę narzędzi Gemini, przykłady zakresu projektu i zaplanowane zadania znajdziesz na stronie Gemini Telegram MCP. Jeśli chcesz wiedzieć, co serwer robi we wszystkich klientach, zacznij od strony serwera Telegram MCP.