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

Goose · Block

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

Добавьте Entergram как MCP-расширение в Goose, опенсорсный ИИ-агент от Block, и дайте ему работать с вашим настоящим аккаунтом Telegram — находить пропущенные сообщения, догонять остывшие лиды и самостоятельно действовать в чатах.

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

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

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

~/.config/goose/config.yaml
extensions:
  entergram:
    type: streamable_http
    uri: https://mcp.entergram.com/mcp
    enabled: true

Спрашивайте Goose о том, чего не спросишь у Telegram

Когда личный аккаунт подключён, Goose может действовать во всех чатах. Попробуйте запросы вроде:

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

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

Работает с десктоп-приложением Goose и CLI.

  1. 01

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

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

  2. 02

    Добавьте расширение в Goose

    В Goose добавьте новое расширение типа Streamable HTTP, указывающее на MCP-адрес Entergram: https://mcp.entergram.com/mcp.

  3. 03

    Авторизуйтесь и запускайте

    Нажмите Connect, войдите в свой аккаунт Entergram и нажмите Allow access. После этого Goose сможет читать ваш аккаунт Telegram и действовать в нём в своих сессиях.

Три способа запустить расширение Entergram

Goose Desktop

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

Goose CLI

`goose configure` проведёт вас по добавлению удалённого расширения без единой строки YAML — выберите Add Extension, затем вариант удалённого Streamable HTTP. Ручная правка ~/.config/goose/config.yaml делает ровно то же самое и удобнее, если вы держите настройки машины в репозитории с дотфайлами.

goose configure

Запуски без присмотра

Как только расширение авторизовано, headless-запуск наследует этот доступ. Именно так разбор Telegram превращается в то, что машина делает в восемь утра, а не в то, что вы вспоминаете попросить. Сочетайте с cron или launchd: сам Entergram агента не разбудит.

goose run -t "List every Entergram chat that has been waiting on a reply for more than a day"

Долгие задачи, доведённые до конца

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

Задача

«Пройди по всем тикетам, открытым дольше трёх дней, прочитай чат за каждым и подготовь клиенту обновление статуса. Покажи мне черновики до отправки.»

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

entergram_list_ticketsentergram_get_ticketentergram_list_messagesentergram_send_message

Goose возвращает

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

Задача

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

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

entergram_create_custom_columnentergram_create_custom_column_optionentergram_list_workspace_chatsentergram_patch_chat_custom_fields

Goose возвращает

Схема и заполнение задним числом в одном запуске — как раз там, где агент себя окупает: колонка должна существовать до того, как в неё запишут хоть одно значение, а значения опций нужно прочитать обратно, чтобы классификатор писал реальные идентификаторы опций, а не свободный текст. Работать он будет долго и в конце вернёт список по каждому чату. Только коннектор рабочего пространства.

Задача

«Проверь три наши партнёрские группы: кто в каждой и кто из наших контактов состоит больше чем в одной?»

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

entergram_list_groupsentergram_list_group_membersentergram_list_contact_shared_groups

Goose возвращает

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

Задача

«Найди всех, кто задал один и тот же вопрос дважды и так и не получил ответа, заведи на каждого тикет и вставь оба его сообщения в тикет комментарием.»

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

entergram_list_messagesentergram_create_ticketentergram_create_ticket_comment

Goose возвращает

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

Задача

«Колонка серьёзности тикетов расползлась, и три опции теперь означают одно и то же. Сведи их к одному нормальному набору.»

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

entergram_list_ticket_custom_columnsentergram_list_ticket_custom_column_optionsentergram_update_ticket_custom_column_optionentergram_update_ticket

Goose возвращает

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

Задача

«Разошли новые release notes во все группы, куда мы их когда-либо публиковали.»

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

entergram_list_groupsentergram_list_messagesentergram_list_accountsentergram_send_media_message

Goose возвращает

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

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

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

Полный набор инструментов расширения

Включение расширения регистрирует в сессии 70 инструментов в 9 группах. Goose сам решает, какие из них выстроить в цепочку и в каком порядке, поэтому группировка ниже — не столько меню, сколько карта их взаимосвязей. Обратите внимание, где проходят разрушительные границы — администрирование групп, удаление элементов схемы, исходящие отправки: именно до них персональный агент не дотягивается вовсе.

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

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

Права — и почему автономному агенту их лучше дать поменьше

Авторизация — это обычный вход по OAuth в браузере: Goose открывает экран согласия Entergram, вы подтверждаете, и полученный токен остаётся в вашей локальной конфигурации Goose, а не на чьём-то сервере. Сама сессия Telegram остаётся за Entergram: номер, на который вы регистрировались, и привязанный к нему вход агенту Block не передаются — как и тому провайдеру модели, на который вы направили Goose. Поскольку агент действует, пока вы смотрите в другую сторону, реальным средством безопасности здесь является выбранный уровень доступа, а не промпт.

Персональный агент
Доступен любому участнику рабочего пространства. Он может читать рабочее пространство и его участников, подключённые аккаунты, ваши контакты, список чатов, историю сообщений и очередь тикетов; единственное, что он пишет, — кастомные поля в чатах аккаунтов, которые подключили вы сами. Агент с таким токеном может весь день исследовать и отчитываться и при этом не скажет клиенту ни слова — обычно это правильный размен для запуска, за которым вы не следите.
Коннектор рабочего пространства
Только для владельцев и администраторов, и он несёт весь набор прав — исходящие сообщения, запись кастомных полей в любом чате, изменение тикетов и схемы, администрирование групп. Отдавайте его экземпляру Goose, только если план действительно должен действовать от имени рабочего пространства, и держите подальше от машин, за которые могут сесть другие люди.
Как оборвать доступ прямо во время запуска
Два переключателя, работающие на разных уровнях. Отключение расширения в Goose закрывает текущему агенту доступ к Entergram. Отзыв токена в Settings → Workspace → Connectors → MCP аннулирует его сразу везде, включая запуск, уже идущий на другой машине.

Где автономный запуск упирается в стену

Ограничения, о которых стоит знать до того, как вы отдадите Goose план и отойдёте от экрана.

  • Вызовы инструментов требуют рабочего пространства на тарифе Pro. MCP в Entergram — функция тарифа Pro, поэтому рукопожатие OAuth пройдёт на любом тарифе, а упадёт первый же вызов инструмента в вашем плане — неприятное открытие на сороковой минуте запуска.
  • Персональный агент не сможет закончить план, который завершается отправкой. Если последний шаг исходящий, запуску нужен коннектор рабочего пространства, а создать его может только владелец или администратор.
  • Кроме вас, Goose никто не запускает по расписанию. Entergram не отдаёт триггеров, которые разбудили бы агента, поэтому регулярная работа — это cron, launchd или тот раннер, который у вас уже есть, вызывающий Goose с нужным интервалом.
  • Примитива массовой рассылки не существует. Каждый инструмент сообщений разрешает один account_id и один чат, поэтому агент, решивший связаться с сорока людьми, сделает сорок отдельных вызовов — каждый виден в стенограмме, и остановить его можно на середине.
  • История не бездонна. Глубокое чтение активной группы ограничено собственным хранением и постраничной выдачей Telegram, а не Entergram, поэтому план, рассчитывающий пройти год большой группы, вернётся неполным и не скажет об этом громко.
  • Долгое чтение стоит токенов модели. Goose работает на том провайдере, который вы ему настроили, и план, затягивающий в контекст тысячи сообщений, оплачивается там — ограничивайте чатом, диапазоном дат или очередью тикетов, прежде чем отпускать его.

Когда запуск Goose идёт не так

Расширение в списке есть, а инструментов нет
Goose читает список расширений при старте сессии, а не во время неё. Убедитесь, что в записи стоит `enabled: true`, и начните новую сессию: возобновлённая сохраняет тот список инструментов, с которым была создана.
CLI зависает на шаге авторизации
Экрану согласия нужен браузер, а у SSH-сессии или контейнера открыть его нечем. Авторизуйтесь один раз из десктоп-сессии, а последующие headless-запуски переиспользуют сохранённый токен.
Goose пытается запустить бинарник и падает
Выбран не тот тип расширения. Entergram — размещённый сервер, доступный по Streamable HTTP, а не расширение командной строки: запись типа command отправляет Goose искать исполняемый файл, которого на вашей машине никогда не было.
Запуск останавливается на середине с ошибкой прав
План перешёл от чтения к записи. Персональный агент не может отправлять сообщения, править поля в чужих чатах и администрировать группы, поэтому попросите у владельца или администратора коннектор рабочего пространства либо перепишите план так, чтобы он останавливался на черновике.
Он действовал не в том аккаунте Telegram
Когда подключено несколько аккаунтов, неуточнённая инструкция оставляет выбор модели. Назовите аккаунт в запросе и потребуйте вызвать entergram_list_accounts в начале, чтобы account_id определялся по данным, а не угадывался.
Правки в config.yaml будто игнорируются
YAML чувствителен к отступам, и неправильно вложенный блок extensions молча превращается в ничто. Запустите `goose configure` и добавьте удалённое расширение через меню — оно запишет тот же файл корректно, и потом можно посмотреть разницу.

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

Как Goose подключается к MCP-серверам?
Goose подключается к MCP-серверам как к расширениям. Добавьте Entergram как расширение Streamable HTTP с MCP-адресом и авторизуйтесь через OAuth.
Это Telegram-бот?
Нет. Entergram подключает ваш настоящий личный аккаунт Telegram через размещённый MCP-сервер.
Это безопасно?
Да. OAuth 2.0 с ограниченными правами; вы решаете, к чему имеет доступ Goose, и можете отозвать его в любой момент.

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