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

Cline · VS Code

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

Добавьте Entergram как MCP-сервер в Cline, ИИ-агент для VS Code, и обращайтесь к своему настоящему аккаунту Telegram прямо из редактора — ловите пропущенные сообщения и клиентов, ждущих ответа, не выпадая из потока.

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

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

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

cline_mcp_settings.json
{
  "mcpServers": {
    "entergram": {
      "url": "https://mcp.entergram.com/mcp"
    }
  }
}

Спрашивайте Cline о вашем Telegram

Когда личный аккаунт подключён, Cline проверяет Telegram, не заставляя вас выходить из VS Code. Попробуйте:

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

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

Работает с расширением Cline в VS Code.

  1. 01

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

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

  2. 02

    Добавьте сервер в Cline

    В настройках MCP в Cline (cline_mcp_settings.json) пропишите MCP-адрес Entergram: https://mcp.entergram.com/mcp.

  3. 03

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

    Нажмите Connect, войдите в свой аккаунт Entergram и нажмите Allow access. Теперь Cline может делать запросы к вашему аккаунту Telegram и действовать в нём, пока вы работаете в VS Code.

Три способа зарегистрировать сервер в Cline

Панель MCP Servers — вкладка Remote Servers

Путь, в котором нет JSON. Нажмите иконку сервера вверху панели Cline, откройте вкладку Remote Servers, назовите запись entergram, вставьте адрес и нажмите Add. Cline напишет конфигурацию за вас и покажет индикатор состояния рядом с сервером — самый быстрый способ отличить неудачную вставку от неудачной затеи.

cline_mcp_settings.json

Сам файл лежит в глобальном хранилище расширения — на macOS это ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json, а в Windows и Linux путь имеет ту же форму внутри пользовательской директории VS Code. Править его руками имеет смысл, когда вы хотите держать массив autoApprove под контролем версий вместе с остальными настройками машины.

{
  "mcpServers": {
    "entergram": {
      "url": "https://mcp.entergram.com/mcp",
      "disabled": false,
      "autoApprove": []
    }
  }
}

Автоподтверждение только для чтения

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

"autoApprove": [
  "entergram_list_accounts",
  "entergram_list_chats",
  "entergram_list_messages",
  "entergram_get_contact"
]

Шесть запусков и места, где Cline останавливается спросить

Cline — агент, который планирует на несколько шагов вперёд, а затем выполняет их по одному вызову за раз, показывая перед каждым кнопки Approve и Reject. Этот ритм меняет назначение коннектора: чтение проносится мимо, а вот на записи вы действительно смотрите. Ниже — запуски, которые стоит ему поручить.

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

«Преврати сегодняшние утренние баг-репорты в тикеты, по одному.»

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

entergram_list_live_chatsentergram_list_messagesentergram_create_ticket

Вы получаете

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

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

«Мы выкатились двадцать минут назад. Что-нибудь сломалось?»

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

entergram_list_live_chatsentergram_get_live_chatentergram_list_messages

Вы получаете

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

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

«Тикеты по ночному сбою до сих пор помечены как обычные. Подними серьёзность там, где обращались платящие клиенты.»

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

entergram_list_ticketsentergram_list_ticket_custom_columnsentergram_update_ticket

Вы получаете

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

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

«Отметь всех, кто сообщил о баге с экспортом, чтобы они видели: обращение замечено.»

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

entergram_list_messagesentergram_set_message_reactions

Вы получаете

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

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

«Подготовь release note для бета-группы и остановись перед отправкой.»

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

entergram_list_groupsentergram_list_group_membersentergram_send_message

Вы получаете

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

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

«Опиши, что ты сделал за этот запуск, внутренней заметкой в каждом затронутом чате.»

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

entergram_list_chat_commentsentergram_create_chat_comment

Вы получаете

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

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

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

К чему Cline может обратиться

Сервер отдаёт семьдесят инструментов в девяти группах, и Cline перечисляет их все под записью сервера, так что поверхность можно изучить до того, как что-то по ней подтверждать. Группы чтения — это то, к чему сессия кодинга обращается постоянно; группы записи стоит какое-то время оставить на ручном подтверждении.

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

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

Два рубежа, а не один

Запрос подтверждения в Cline — это тот рубеж, который вы видите. Права OAuth — рубеж, который вы задаёте один раз и потом о нём не думаете, и он строже: подтверждение вызова никогда не выдаст разрешения, которого нет у токена. Определитесь с уровнем доступа до того, как настраивать autoApprove, потому что токен задаёт потолок, а список автоподтверждения решает лишь то, как часто вас будут спрашивать о том, что и так разрешено. Отзыв — это два клика в Entergram в Settings → Workspace → Connectors → MCP.

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

Во что обходится цикл подтверждений

Честные компромиссы агента внутри редактора, у которого посередине стоит человек.

  • Подтверждение запрашивается на каждый вызов инструмента, а не на план целиком. Задача из шести шагов — это шесть запросов в панели, а если отойти на середине, запуск так и останется стоять на следующем сколь угодно долго.
  • autoApprove сопоставляет имена инструментов и никогда не аргументы. Добавив в список entergram_send_message, вы разрешаете его для любого чата, а не для того, который имели в виду, — поэтому держите инструменты записи вне списка, пока сценарий не заслужит места в нём.
  • Запуск живёт внутри окна редактора. Закройте VS Code или перезагрузите хост расширений — задача остановится там, где стояла: ничего не продолжается на сервере и ничего не подхватывается с места остановки.
  • Рабочее пространство ниже тарифа Pro пройдёт вход по OAuth и упадёт на первом вызове, а Cline покажет это как неудачный результат инструмента, а не как проблему подключения. Доступ к MCP — функция тарифа Pro.
  • Выбор аккаунта явный. Если в запросе аккаунт не назван, агент возьмёт один из списка и пойдёт дальше, а диалог подтверждения не подскажет, какой именно он выбрал.
  • Глубина истории определяется хранением в самом Telegram, а не Entergram, поэтому активная группа с многолетним архивом не отдаст всё за один проход. Вопросы, ограниченные датами, дают ответы лучше, чем открытые.

Решение проблем с коннектором Cline

В панели MCP Servers статус Disconnected
Нажмите на этой записи кнопку Restart Server, а не переустанавливайте что-либо. Cline держит по одному соединению на сервер и не пытается переподключиться сам после обрыва сети или выхода ноутбука из сна.
Cline спрашивает разрешение на каждое чтение
Это поведение по умолчанию. Откройте запись сервера в панели MCP Servers и перенесите инструменты только для чтения, подтверждать которые вам надоело, в её список автоподтверждения, оставив за его пределами отправку, редактирование и удаление.
После ручной правки файла настроек ничего не появилось
Лишняя запятая или посторонний символ делает недействительным весь документ, и Cline вместо жалобы просто откатывается к пустому списку серверов. Прогоните JSON через валидатор, затем перезагрузите окно VS Code, чтобы хост расширений перечитал файл.
Задача остановилась на середине без ошибки
Либо остался неотвеченным запрос подтверждения, либо окно перезагрузилось во время запуска. Cline не возобновляет задачи после перезапуска — запустите её заново, и он перепланирует работу по текущему состоянию ваших чатов.
Ответ ушёл не из того аккаунта Telegram
Попросите Cline вызвать entergram_list_accounts, а затем впишите имя аккаунта прямо в запрос. Когда аккаунт подразумевается, агент выбирает его сам, и диалог подтверждения этот выбор не показывает.
Сразу после успешного подключения инструменты падают с 403
Доступ выдан, а прав не хватает. Персональный агент не может отправлять сообщения и писать кастомные поля другого участника, поэтому, если запуску это действительно нужно, попросите у владельца или администратора коннектор рабочего пространства.

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

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

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