Skip to main content
← Все коннекторы 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.

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

Готовая конфигурация для вставки
{
  "mcpServers": {
    "entergram": {
      "url": "https://mcp.entergram.com/mcp"
    }
  }
}

Подключите редактор за 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"
    }
  }
}

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

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

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

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

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

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

«Нам прислали 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

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

Запись, которую вы вставляете в 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