Gemini · Google

Подключите Telegram к Gemini

Используйте Entergram как Telegram MCP-сервер для Google Gemini и Gemini CLI - дайте Gemini безопасный доступ с ограниченными правами OAuth к вашим реальным чатам Telegram, чтобы он показывал пропущенные сообщения, ждущих клиентов и остывшие лиды.

URL MCP-сервера https://mcp.entergram.com/mcp

Начать бесплатно Все коннекторы

Gemini CLI и совместимые с MCP инструменты Gemini могут подключаться к внешним MCP-серверам. Entergram превращает ваш личный аккаунт Telegram в размещённый MCP-сервер, поэтому Gemini читает ваши реальные чаты и действует в них с защитой OAuth - без бота, без кода и без ключей API.

Готовая конфигурация для вставки

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

Подключите Gemini за 3 шага

Работает с Gemini CLI и совместимыми с MCP клиентами Gemini.

01
Скопируйте свой MCP-адрес в Entergram
В Entergram откройте Settings → Workspace → Connectors → MCP и скопируйте URL вашего MCP-сервера.
02
Зарегистрируйте MCP-сервер в Gemini
Добавьте Entergram в конфигурацию MCP вашего Gemini CLI с адресом: https://mcp.entergram.com/mcp.
03
Авторизуйтесь и запускайте
Нажмите Connect, войдите в свой аккаунт Entergram и нажмите Allow access. После этого Gemini сможет делать запросы и действовать в вашем аккаунте Telegram.

Где регистрировать сервер

Gemini CLI, уровень пользователя

Основной путь и то, что обычно имеют в виду под «Gemini MCP». Добавьте сервер в ~/.gemini/settings.json в блок mcpServers, указав httpUrl на размещённый эндпойнт, перезапустите CLI - и инструменты будут доступны в любом проекте на этой машине. Поскольку это удалённый HTTPS, никакой обёртки через npx и никакого stdio-моста поддерживать не нужно.

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

Gemini CLI, уровень проекта

Тот же блок, положенный в .gemini/settings.json внутри репозитория, действует только для этого чекаута. Полезно, когда один репозиторий - это пайплайн деплоя, объявляющий релизы в канал Telegram, а остальной вашей работе к чатам прикасаться незачем. Заодно конфигурация оказывается под контролем версий, где её увидит коллега.

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

Любой клиент, работающий на модели Gemini

Эндпойнт не зависит от модели. Агент в IDE, скриптовая обвязка или внутренний инструмент на Gemini регистрируют Entergram так, как этого ждёт их собственная конфигурация MCP, и получают идентичный список инструментов. Экран согласия принадлежит Entergram, поэтому тот, кто запускает клиент, авторизуется от своего имени, а не наследует чужой доступ.

Спросите Gemini о том, чего у Telegram не спросишь

С подключённым личным аккаунтом Gemini анализирует сразу все чаты. Попробуйте запросы вроде:

«Сколько сообщений я пропустил на этой неделе и какие из них от клиентов?»
«Каким диалогам я забываю ответить?»
«Посчитай лиды, которые остыли, потому что я не написал им вовремя.»
«Собери отзывы, которые клиенты дали мне за последний месяц.»
«Найди по всем чатам каждый вопрос, оставшийся без ответа.»
«Набросай ответы на мои самые старые сообщения без ответа, чтобы я их проверил.»

Терминальные задачи, которые стоит настроить

В CLI это однострочные команды, которые можно повесить на алиас в шелле или на git-хук. Каждый запрос обычными словами разворачивается в последовательность вызовов инструментов, и CLI печатает, какие именно вызовы он сделал, - так что механику можно понаблюдать до того, как доверить ему запись. Всё ниже предполагает, что сервер зарегистрирован и авторизован один раз; дальше остаётся только печатать.

Вы спрашиваете

«Опубликуй release notes из CHANGELOG.md в бета-канале.»

Вызванные инструменты

entergram_list_accountsentergram_list_groupsentergram_send_message

Вы получаете

Шаг после деплоя, о котором все забывают. Чейнджлог у Gemini уже в контексте из репозитория, он выбирает аккаунт, администрирующий канал, находит канал по названию и публикует. Повесьте это на успешную сборку - и объявление перестанет зависеть от чьей-то памяти.

Вы спрашиваете

«Кто состоит в бета-канале, но ни разу не отмечен у нас как платящий клиент?»

Вызванные инструменты

entergram_list_group_membersentergram_list_contactsentergram_get_chat_custom_fields

Вы получаете

Разность двух множеств, которые обычно живут в разных вкладках браузера. Он перебирает состав канала, сопоставляет людей с вашим списком контактов, а затем читает поля CRM, чтобы увидеть, у кого стоит отметка клиента. Возвращается неконвертированная половина вашего сообщества - поимённо.

Вы спрашиваете

«Отправь вывод упавших тестов в ветку Acme с короткой пояснительной запиской.»

Вызванные инструменты

entergram_list_chatsentergram_send_media_message

Вы получаете

Файл уже лежит рядом на диске, поэтому вся возня с загрузкой пропускается. Gemini прикладывает артефакт и сам пишет сопроводительную строку - разница между клиентом, который видит стену стектрейса, и клиентом, который видит, что сломалось и когда это починят.

Вы спрашиваете

«Создай канал для запуска, назови его как надо и добавь релизную команду.»

Вызванные инструменты

entergram_create_channelentergram_update_chat_infoentergram_invite_chat_members

Вы получаете

Три шага в интерфейсе самого Telegram сворачиваются в одну фразу. Канал создан, название и описание заданы по вашему описанию, а список приглашений собран из контактов. Здесь нужен коннектор рабочего пространства: администрирование групп в набор прав персонального агента не входит.

Вы спрашиваете

«Я опечатался в номере версии в том объявлении - исправь.»

Вызванные инструменты

entergram_list_messagesentergram_edit_message

Вы получаете

Он перечитывает недавнюю историю, чтобы понять, о каком сообщении речь, и правит его на месте, а не публикует поправку следом. Telegram оставляет сообщение там же, где оно было, - никто из уже прочитавших не получает повторного уведомления, а история канала остаётся чистой.

Вы спрашиваете

«Дай мне количество тикетов за неделю по исполнителям в формате TSV.»

Вызванные инструменты

entergram_list_ticketsentergram_list_ticket_custom_columnsentergram_list_members

Вы получаете

Форматирование вывода - как раз то, ради чего держат терминальный клиент. Он поднимает очередь, разворачивает колонки категории и серьёзности в их реальные значения опций, сопоставляет идентификаторы исполнителей с именами людей и печатает строки с табуляцией, которые можно сразу отправить в таблицу или в скрипт для графика. Отчётность на лету, без предварительного построения отчёта.

Что Gemini может делать с вашим Telegram

-Читать и обобщать переписку в Telegram
-Показывать пропущенные сообщения и просроченные ответы
-Находить контакты и кастомные поля CRM
-Отправлять сообщения и ответы с вашего согласия
-Оценивать упущенные возможности и отзывы
-Создавать и обновлять тикеты поддержки

Согласие - на каждой машине отдельно

В settings.json нет никаких учётных данных. Файл лишь сообщает CLI, где находится сервер; доступ появляется после входа по OAuth в браузере, и полученный токен принадлежит вам, а не чекауту. Google не получает никаких данных Telegram: номер телефона и сессия остаются внутри Entergram. Наборов прав два, и какой из них нужен, зависит от того, должен ли CLI что-то записывать.

Набор прав персонального агента: Создать может любой участник, не спрашивая администратора. Покрывает чтение рабочего пространства, подключённых аккаунтов, контактов, чатов, сообщений и тикетов, плюс запись значений кастомных полей в ваших собственных чатах. Этого хватает на любую задачу анализа и выгрузки с этой страницы - и не хватает, чтобы отправить сообщение.
Набор прав коннектора рабочего пространства: Доступен только владельцам и администраторам - и именно он нужен автоматизации. Добавляет отправку, медиа, редактирование, запись тикетов, запись кастомных полей по всему рабочему пространству и администрирование групп в Telegram. Поскольку он общий, а не личный, к машине, на которой вы его авторизуете, стоит относиться соответствующе.
Как оборвать соединение: Удаление записи из mcpServers остановит обращения CLI к серверу, но ничего не аннулирует. Чтобы действительно закрыть доступ, отзовите клиента на стороне Entergram в Settings → Workspace → Connectors → MCP - это срабатывает мгновенно и на всех машинах, которые им пользовались.

Ограничения, под которые стоит проектировать

Большинство из них дают о себе знать, только когда вы пытаетесь запускать CLI без присмотра.

Зарегистрировать сервер - не то же самое, что авторизовать его. Каждая машина в первый раз проходит экран согласия самостоятельно, поэтому новому ноутбуку или пересобранному контейнеру хотя бы однажды нужен браузер.
Рабочее пространство Entergram должно быть на тарифе Pro. На более низком тарифе CLI спокойно покажет сервер, а затем начнёт собирать отказы на каждом вызове - выглядит как сломанная конфигурация, хотя дело не в ней.
Аккаунт по умолчанию отсутствует. Инструментам сообщений нужен явный account_id, поэтому любой скрипт сначала должен получить список аккаунтов - в чате это почти незаметно, в пайплайне это ещё одна вещь, о которой нужно помнить. Определите его один раз в начале скрипта и передавайте дальше.
Персональный агент не умеет отправлять и не умеет администрировать группы. Автоматизациям, которые публикуют release notes или создают каналы, нужен коннектор рабочего пространства, авторизованный владельцем или администратором.
Протокол построен на запросе и ответе, а не на подписке. В ваш терминал ничего не приходит само; Gemini узнаёт о новом сообщении, только когда что-то попросит его посмотреть. Всё, что похоже на мониторинг, должно быть вашей задачей по расписанию.
CLI не расширяет ваши права. Он видит ровно те чаты, что видит ваш собственный аккаунт Telegram, и группу, из которой вы вышли, прочитать не сможет.

Проблемы CLI и их причины

Сервер вообще не появляется в списке MCP

Почти всегда это некорректный JSON: одна лишняя запятая - и CLI молча отбрасывает весь файл настроек. Проверьте синтаксис, убедитесь, что для удалённого HTTPS-сервера используется ключ httpUrl, а не stdio-запись с командой и аргументами, и что запись действительно лежит внутри mcpServers.

Правки в settings.json будто ни на что не влияют

Конфигурация читается при запуске. Полностью завершите сессию и запустите её заново: работающий процесс продолжает отдавать тот список инструментов, который собрал при старте, поэтому файл может быть верным и всё равно выглядеть проигнорированным.

OAuth не завершается на машине без графики

Экрану согласия нужен браузер. Авторизуйтесь на рабочей станции, которую вы видите, или пробросьте порт обратного вызова через SSH - сборочный агент без дисплея рукопожатие сам не закончит.

В одной директории работает, в другой нет

У вас два файла настроек. Тот, что в ~/.gemini, действует везде; тот, что в .gemini внутри репозитория, - только там. Прежде чем править что-то ещё, выясните, в каком из них на самом деле лежит запись entergram.

Каждый вызов возвращает 403

Сначала проверьте тариф, потом роль. Доступ к MCP требует Pro, а всё, что выходит за набор прав персонального агента, - прав владельца или администратора рабочего пространства Entergram.

Чтение работает, а отправка отклоняется

Это не временный сбой, а граница персонального агента. Отправки в его наборе прав нет вовсе, поэтому повторные попытки не помогут: владелец или администратор должен авторизовать коннектор рабочего пространства, и экран согласия нужно пройти уже для него.