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

Cursor, Zed и Windsurf

Подключите Telegram к Cursor и IDE

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

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

Cursor, Zed и Windsurf поддерживают MCP-серверы через конфигурацию mcp.json. Entergram превращает ваш личный аккаунт Telegram в размещённый MCP-сервер, поэтому ИИ вашего редактора действует в ваших реальных чатах с защитой OAuth — без бота и без ключей API.

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

mcp.json (Cursor / Zed / Windsurf)
{
  "mcpServers": {
    "entergram": {
      "url": "https://mcp.entergram.com/mcp"
    }
  }
}

Спросите редактор о вашем Telegram

С подключённым личным аккаунтом ИИ вашего IDE проверяет Telegram без переключения между приложениями. Попробуйте:

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

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

Работает с Cursor, Zed и Windsurf.

  1. 01

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

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

  2. 02

    Добавьте сервер в mcp.json

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

  3. 03

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

    Нажмите Connect, войдите в свой аккаунт Entergram и нажмите Allow access. ИИ-ассистент вашего редактора теперь может делать запросы и действовать в вашем аккаунте Telegram.

Три редактора — три файла конфигурации

Cursor — ~/.cursor/mcp.json

Cursor загружает серверы из ~/.cursor/mcp.json для каждого открытого проекта либо из .cursor/mcp.json, закоммиченного внутрь репозитория, если сервер нужен только в этой кодовой базе. Через меню путь такой: Cursor Settings → MCP & Integrations → New MCP server — он пишет тот же файл за вас. Запись уровня проекта при первом обращении агента спрашивает доверие, поэтому коллега, который стянет репозиторий, всё равно принимает осознанное решение.

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

Zed — ~/.config/zed/settings.json

Zed хранит MCP-серверы в блоке context_servers своего основного файла настроек, а не в блоке mcpServers, и именно это слово ломает большинство первых попыток: вставьте сниппет от Cursor дословно — и не загрузится ничего, причём без ошибки, которая объяснила бы почему. В настройках панели агента есть кнопка Add Custom Server, которая напишет правильную структуру, если править JSON руками не хочется.

{
  "context_servers": {
    "entergram": {
      "source": "custom",
      "url": "https://mcp.entergram.com/mcp"
    }
  }
}

Windsurf — ~/.codeium/windsurf/mcp_config.json

Windsurf читает отдельный файл в ~/.codeium, а не настройки редактора, как можно было бы ожидать, и Cascade перечитывает его по требованию: после сохранения откройте панель MCP в Cascade и нажмите обновление, иначе инструменты останутся невидимыми до следующего перезапуска. Сама структура JSON совпадает с Cursor, так что запись переносится между ними без правок.

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

От стектрейса — к человеку, который его прислал

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

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

«Нам прислали TypeError со страницы биллинга. Найди сообщение и скажи, кто сообщил.»

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

entergram_list_messagesentergram_get_contactentergram_list_chat_tickets

Вы получаете

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

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

«Это стоит чинить сегодня? Посчитай, сколько человек сообщили о том же самом.»

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

entergram_list_workspace_chatsentergram_list_messagesentergram_get_chat

Вы получаете

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

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

«Достань лог, который прислал клиент, чтобы я воспроизвёл это локально.»

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

entergram_list_chatsentergram_list_messagesentergram_get_message

Вы получаете

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

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

«Вставь эти шаги воспроизведения в тикет по этому багу.»

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

entergram_list_ticketsentergram_get_ticketentergram_create_ticket_comment

Вы получаете

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

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

«На каком тарифе тот, кто это завёл, и что мы ему уже говорили?»

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

entergram_list_custom_columnsentergram_get_chat_custom_fieldsentergram_list_chat_comments

Вы получаете

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

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

«Фикс влит. Сообщи двум людям, которые о нём писали, и закрой тикет.»

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

entergram_list_accountsentergram_send_messageentergram_update_ticket

Вы получаете

Шаг, который все пропускают. Он определяет, какому подключённому аккаунту принадлежит каждый диалог, готовит по короткому сообщению на человека для вашего утверждения и переводит тикет в закрытые, когда они ушли. Разрыв между «выкатили» и «сказали клиенту» сжимается из пункта в списке дел в один запрос.

Что ваш редактор может делать с Telegram

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

70 инструментов, которые получает ваш редактор

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

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

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

Что лежит в файле конфигурации, а что нет

Запись, которую вы вставляете в mcp.json, содержит ровно одну вещь: адрес. Ни токена, ни номера телефона, ни ключа API — поэтому .cursor/mcp.json уровня проекта безопасно коммитить рядом с кодом, который он обслуживает. Само разрешение выдаётся в браузере, принадлежит вам, а не репозиторию, и хранится редактором. Чтобы забрать его обратно, отзовите подключение на экране MCP в Settings → Workspace → Connectors в Entergram: токен, который держит редактор, перестанет работать на следующем вызове. Уровня доступа два, и они не взаимозаменяемы.

Персональный агент
Любой участник может выдать его себе сам, и на рабочем ноутбуке это обычно правильный потолок. Он читает рабочее пространство, аккаунты, контакты, чаты, сообщения и тикеты, а пишет только кастомные поля в чатах, принадлежащих вашим собственным подключённым аккаунтам. Агент с таким доступом может сколь угодно подробно исследовать баг и при этом не может написать человеку, который о нём сообщил.
Коннектор рабочего пространства
Только для владельцев и администраторов. Несёт весь набор прав — отправка, запись кастомных полей в любом чате, администрирование групп — и он общий для команды, а не принадлежит одному разработчику. Используйте его, когда редактор работает от имени компании, а не от вашего.
Отзыв доступа
Работает с обеих сторон и действует немедленно. Удаление сервера из mcp.json заставит редактор перестать спрашивать; отзыв в Entergram — перестать отвечать. Второе и важно, когда ноутбук уже не у вас в руках.

Где интеграция с редактором заканчивается

Стоит знать до того, как это войдёт в привычку.

  • Доступ к MCP входит в тариф Pro, и со стороны редактора это не изменить: рабочее пространство ниже нужного тарифа зарегистрирует сервер, пройдёт вход и всё равно не получит от вызова ничего полезного.
  • Само ничего не приходит. Редактор обращается к Entergram только внутри начатого вами хода, поэтому сообщение, пришедшее посреди рефакторинга, тихо ждёт, пока вы о нём не спросите.
  • Конфигурация привязана к машине. mcp.json не путешествует вместе с аккаунтом редактора, и разрешение OAuth тоже: второй ноутбук — это второй файл и второй экран согласия.
  • Вывод инструментов остаётся в переписке. Агент может процитировать лог клиента в комментарий или в фикстуру, но в ваши файлы он пишет только по просьбе — и никогда в обратную сторону.
  • Каждая отправка называет один аккаунт. account_id — обязательный аргумент, а не значение по умолчанию, поэтому агент, свернувший не в ту ветку, не сможет заодно разослать сообщение всему вашему списку контактов.
  • Коннектор видит ровно то, что видит ваш аккаунт Telegram. Группа, в которую вас не добавляли, остаётся невидимой и из редактора, как бы ни был сформулирован запрос.

Когда редактор не видит Entergram

В панели MCP в Cursor у сервера красная точка
Cursor кэширует список инструментов с последнего удачного рукопожатия. Выключите и включите сервер в Cursor Settings → MCP & Integrations, а если точка осталась красной, перезагрузите окно: агент читает список при старте окна, а не при правке файла.
Zed полностью игнорирует запись
Вы почти наверняка написали mcpServers. В Zed ключ называется context_servers, а нераспознанный ключ верхнего уровня отбрасывается молча, без сообщения об ошибке. Исправьте имя ключа, сохраните и перезапустите Zed.
После сохранения Windsurf не показывает инструментов Entergram
Убедитесь, что вы правили ~/.codeium/windsurf/mcp_config.json, а не интерфейс настроек, затем откройте панель MCP в Cascade и обновите её. Windsurf перечитывает этот файл по запросу и не раньше.
Экран согласия открылся, но редактор так и не подключился
Авторизация завершается в том браузере, который открывает ваша операционная система по умолчанию. Пройдите вход именно там, будучи авторизованным в Entergram в том же профиле, затем вернитесь и снова запустите подключение.
Агент рассуждает о Telegram, ничего не вызывая
Зарегистрировано слишком много серверов, и список инструментов обрезается до того, как его увидит модель. Отключите MCP-серверы, не нужные для этой задачи, и назовите Entergram в запросе, чтобы выбор был однозначным.
Вызовы возвращают 403
Проверьте две вещи по порядку. Роль: коннектору рабочего пространства нужны права владельца или администратора, всем остальным подходит персональный агент. Затем тариф: доступ к MCP живёт на Pro, и на более низком тарифе всё падает здесь, а не на этапе подключения.

Cursor / Zed / Windsurf + Telegram: частые вопросы

Какие редакторы поддерживаются?
Любой редактор, поддерживающий MCP через mcp.json, — включая Cursor, Zed и Windsurf. Пропишите MCP-адрес Entergram и авторизуйтесь через OAuth.
Это Telegram-бот?
Нет. Entergram подключает ваш настоящий личный аккаунт Telegram через размещённый MCP-сервер.
Может ли это подсказать, что я пропустил, пока кодил?
Да. Спросите ИИ своего редактора — он прочитает ваши чаты, посчитает сообщения без ответа и выделит те, что от клиентов.
Это безопасно?
Да. OAuth 2.0 с ограниченными правами; ваши учётные данные никогда не попадают к разработчику редактора, а доступ можно отозвать.

Подключите Telegram к Cursor и IDE