Как подключить Google Gemini к Telegram-чатам

Google Gemini подключается к вашим Telegram-чатам так: зарегистрируйте размещённый MCP-сервер Entergram https://mcp.entergram.com/mcp в Gemini CLI и один раз войдите в Entergram в браузере. После этого Gemini может читать ваши чаты, контакты и CRM-данные через ваш реальный личный аккаунт Telegram и действовать с ними в пределах выданных вами разрешений. Настройка занимает три шага и один небольшой JSON-блок, он приведён ниже.

Gemini CLI: именно этот путь подробно описан на странице Gemini Telegram MCP. Любой другой MCP-совместимый клиент с моделью Gemini может использовать тот же URL, зарегистрировав его так, как принято в этом клиенте.

• Рабочее пространство на тарифе Pro. API и MCP входят в тариф Pro. На младшем тарифе CLI всё равно покажет сервер, но каждый вызов будет отклонён. Это похоже на сломанную конфигурацию, хотя дело не в ней.
• Хотя бы один подключённый аккаунт Telegram на вашем месте. Личный коннектор может использовать только те аккаунты Telegram, которые указаны в Settings → Accounts для вашего участника.
• Браузер на этой машине для первого входа. Экран согласия открывается в браузере, поэтому headless-сервер сначала нужно авторизовать с рабочей станции.

Шаг 1: Скопируйте MCP URL в Entergram

Откройте Settings → Workspace → Connectors → MCP и скопируйте URL MCP-сервера. Он одинаков для всех клиентов:

https://mcp.entergram.com/mcp

Шаг 2: Зарегистрируйте сервер в Gemini CLI

Добавьте Entergram в раздел mcpServers файла ~/.gemini/settings.json. Сервер удалённый и работает по HTTPS, поэтому ключ называется httpUrl, а не запись с командой и аргументами:

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

Файл в домашнем каталоге действует для всех проектов на этой машине. Чтобы ограничить доступ к Telegram одним репозиторием, поместите тот же блок в .gemini/settings.json внутри этого репозитория.

Шаг 3: Перезапустите CLI и авторизуйтесь

CLI читает конфигурацию при запуске, поэтому полностью завершите сессию и запустите её снова. Войдите в Entergram в открывшемся окне браузера и выдайте Gemini нужные разрешения. В settings.json нет учётных данных: файл только указывает, где находится сервер, а доступ даёт вход через OAuth.

После авторизации выведите в CLI список зарегистрированных MCP-серверов: инструменты Entergram появятся под именем entergram.

Что может делать Gemini, зависит от типа клиента, который вы авторизуете. Подробнее на странице справки о MCP-коннекторах:

Личный агент не может отправлять сообщения в Telegram. Если чтение работает, а отправка отклоняется, это граница разрешений, а не ошибка. Владелец или администратор должен авторизовать коннектор рабочего пространства, после чего вы проходите процедуру согласия заново уже для него. В любом случае выдавайте минимальный набор разрешений, нужный для задачи: messages.write позволяет агенту отправлять сообщения от вашего имени.

Чтобы отозвать доступ, отключите клиента в Entergram в Settings → Workspace → Connectors → MCP. Удаление записи из mcpServers лишь не даёт CLI обращаться к серверу, но не отменяет выданный доступ.

MCP-сервер Entergram подключается к вашему личному аккаунту Telegram, а не к боту, поэтому Gemini работает с теми же чатами, которые видите вы. Запросы, которые хорошо работают в CLI:

• «В каких чатах остались вопросы без ответа за последние три дня?»
• «Покажи контакты из группы клиентов, которых нет в группе сообщества.»
• «Опубликуй release notes из CHANGELOG.md в бета-канале.» (нужен коннектор рабочего пространства)
• «Я опечатался в номере версии в том объявлении, исправь.» (нужен коннектор рабочего пространства)
• «Дай количество тикетов за эту неделю по ответственным в формате TSV.»

CLI выводит каждый вызов инструмента, так что механику можно понаблюдать на задаче только для чтения, прежде чем доверять ей запись.

• Инструментам сообщений нужен явно указанный аккаунт. Аккаунта по умолчанию нет, поэтому скрипт должен сначала получить список аккаунтов и передавать id аккаунта дальше.
• Ничего не приходит само. MCP работает по схеме запрос и ответ. Gemini узнаёт о новом сообщении только тогда, когда вы или ваше запланированное задание просите его посмотреть.
• Никакого расширенного доступа. Gemini видит ровно то, что видят ваши подключённые аккаунты Telegram. Группу, из которой вы вышли, он прочитать не может, а чаты, исключённые в Accounts → Exclude chats, не попадают в результаты MCP.

• Сервер не появляется в списке MCP. Обычно причина в некорректном JSON: одна лишняя запятая в конце заставляет CLI отбросить весь файл настроек. Проверьте, что запись использует httpUrl и находится внутри mcpServers.
• Правки settings.json ни на что не влияют. Полностью завершите сессию и запустите заново. Работающий процесс сохраняет список инструментов, собранный при запуске.
• В одном каталоге работает, в другом нет. У вас два файла настроек. Проверьте, где лежит запись entergram: в ~/.gemini или в папке .gemini репозитория.
• Каждый вызов возвращает 403. Сначала проверьте тариф (MCP требует Pro), затем роль: всё, что выходит за набор разрешений личного агента, требует владельца или администратора.

MCP-сервер Entergram один для всех клиентов. Настройте его один раз и подключайте любой удобный AI-клиент или сразу несколько:

• Подключите Claude к Telegram через Entergram
• Подключите ChatGPT к Telegram через Entergram
• Подключите любой AI-инструмент к Telegram MCP

Полный список инструментов для Gemini, примеры с областью проекта и запланированные задания описаны на странице Gemini Telegram MCP. Чтобы узнать, что сервер делает во всех клиентах, начните со страницы Telegram MCP-сервера.