← Все коннекторы Telegram MCP

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.

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

~/.gemini/settings.json
{
  "mcpServers": {
    "entergram": {
      "httpUrl": "https://mcp.entergram.com/mcp"
    }
  }
}

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

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

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

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

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

  1. 01

    Скопируйте свой MCP-адрес в Entergram

    В Entergram откройте Settings → Workspace → Connectors → MCP и скопируйте URL вашего MCP-сервера.

  2. 02

    Зарегистрируйте MCP-сервер в Gemini

    Добавьте Entergram в конфигурацию MCP вашего Gemini CLI с адресом: https://mcp.entergram.com/mcp.

  3. 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, поэтому тот, кто запускает клиент, авторизуется от своего имени, а не наследует чужой доступ.

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

В 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
  • Отправлять сообщения и ответы с вашего согласия
  • Оценивать упущенные возможности и отзывы
  • Создавать и обновлять тикеты поддержки

Набор инструментов в CLI

Выведите список зарегистрированных MCP-серверов после подключения — и все 70 инструментов появятся под именем entergram, сгруппированные так же, как ниже. Имена инструментов — это буквальные идентификаторы, и в терминале это значит больше, чем в окне чата: вы можете прямо назвать нужный вызов в запросе, когда хотите детерминированного поведения, а не собственного маршрута модели. CLI печатает каждый вызов и его аргументы по ходу дела, поэтому незнакомый список инструментов осваивается быстро.

Аккаунты и рабочее пространство

5 инструментов

Определение личности и области доступа. Любому вызову для работы с сообщениями сначала нужен account_id из list_accounts — ИИ-клиент, пропустивший этот шаг, обратится не к тому аккаунту Telegram.

  • entergram_get_me
  • entergram_list_accounts
  • entergram_get_workspace
  • entergram_get_member
  • entergram_list_members

Чаты и поиск

8 инструментов

Поиск переписок. Представления рабочего пространства отдают состояние CRM (тикеты, комментарии, кастомные поля), а живые представления — текущее транспортное состояние Telegram и счётчики непрочитанного.

  • entergram_list_chats
  • entergram_get_chat
  • entergram_list_live_chats
  • entergram_get_live_chat
  • entergram_list_workspace_chats
  • entergram_get_workspace_chat
  • entergram_update_workspace_chat
  • entergram_get_chat_management

Сообщения

9 инструментов

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

  • entergram_list_messages
  • entergram_get_message
  • entergram_send_message
  • entergram_send_media_message
  • entergram_edit_message
  • entergram_delete_message
  • entergram_forward_messages
  • entergram_get_message_reactions
  • entergram_set_message_reactions

Контакты

3 инструментов

С кем вы общаетесь и где ещё пересекаетесь. Именно поиск по общим группам позволяет отвечать на вопросы вроде «кто из моих лидов состоит в одном сообществе?».

  • entergram_list_contacts
  • entergram_get_contact
  • entergram_list_contact_shared_groups

Тикеты

10 инструментов

Полный контроль над службой поддержки: открыть, назначить, задать приоритет, прокомментировать и закрыть. Тикет ссылается на чат, из которого он появился, поэтому ИИ-клиент переходит от переписки к очереди за один шаг.

  • entergram_list_tickets
  • entergram_get_ticket
  • entergram_create_ticket
  • entergram_update_ticket
  • entergram_delete_ticket
  • entergram_list_chat_tickets
  • entergram_list_ticket_comments
  • entergram_create_ticket_comment
  • entergram_update_ticket_comment
  • entergram_delete_ticket_comment

Кастомные поля CRM

11 инструментов

Схема вашей воронки. Прочитайте колонки, прежде чем записывать значения: чекбоксы принимают булевы значения, мультиселекты — массивы значений опций, а даты — строки в формате ISO 8601.

  • entergram_list_custom_columns
  • entergram_get_custom_column
  • entergram_create_custom_column
  • entergram_update_custom_column
  • entergram_delete_custom_column
  • entergram_list_custom_column_options
  • entergram_create_custom_column_option
  • entergram_update_custom_column_option
  • entergram_delete_custom_column_option
  • entergram_get_chat_custom_fields
  • entergram_patch_chat_custom_fields

Кастомные поля тикетов

9 инструментов

Тот же контроль схемы на стороне тикетов — категории, уровни критичности, ступени SLA и всё остальное, что ваша поддержка отслеживает помимо статуса и приоритета.

  • entergram_list_ticket_custom_columns
  • entergram_get_ticket_custom_column
  • entergram_create_ticket_custom_column
  • entergram_update_ticket_custom_column
  • entergram_delete_ticket_custom_column
  • entergram_list_ticket_custom_column_options
  • entergram_create_ticket_custom_column_option
  • entergram_update_ticket_custom_column_option
  • entergram_delete_ticket_custom_column_option

Внутренние заметки

4 инструментов

Комментарии к чату, которых клиент никогда не увидит. Удобно, когда ИИ-клиенту нужно оставить ход своих рассуждений, чтобы его подхватил живой коллега.

  • entergram_list_chat_comments
  • entergram_create_chat_comment
  • entergram_update_chat_comment
  • entergram_delete_chat_comment

Группы и каналы

11 инструментов

Создание и администрирование групп и каналов Telegram — участники, права, приватность и описание — плюс запасной вариант с выполнением сырой команды для всего остального.

  • entergram_list_groups
  • entergram_get_group
  • entergram_list_group_members
  • entergram_create_group_chat
  • entergram_create_channel
  • entergram_invite_chat_members
  • entergram_remove_chat_member
  • entergram_update_chat_info
  • entergram_update_chat_permissions
  • entergram_update_chat_privacy
  • entergram_run_chat_command

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

В 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.
Чтение работает, а отправка отклоняется
Это не временный сбой, а граница персонального агента. Отправки в его наборе прав нет вовсе, поэтому повторные попытки не помогут: владелец или администратор должен авторизовать коннектор рабочего пространства, и экран согласия нужно пройти уже для него.

Gemini + Telegram: частые вопросы

Работает ли это с Gemini CLI?
Да. Gemini CLI поддерживает MCP-серверы — пропишите MCP-адрес Entergram в своей конфигурации MCP и авторизуйтесь через OAuth.
Это Telegram-бот?
Нет. Entergram подключает ваш настоящий личный аккаунт Telegram через размещённый MCP-сервер, поэтому Gemini работает с вашими реальными чатами.
Может ли Gemini подсказать, что я пропустил?
Да. Он читает сразу все ваши подключённые чаты, считает сообщения без ответа и непрочитанные и выделяет те, что от клиентов и лидов.
Это безопасно?
Да. Соединение использует OAuth 2.0 с ограниченными правами; вы решаете, к чему Gemini получит доступ, и можете отозвать его в любой момент.

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