Telegram MCP от chaindead
Telegram MCP
MCP-сервер на Go для вашего Telegram: агент читает диалоги и непрочитанное, отмечает прочитанным, ответы кладет в черновики
- 350 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент читает ваши личные диалоги, группы и каналы под вашей учетной записью, а переписка попадает в модель
- Сессия Telegram хранится на диске, и тот, кто получит к ней доступ, получит доступ к аккаунту
- Неправильное использование API Telegram, по предупреждению автора, может привести к блокировке аккаунта
Установка
- Работает в
- Сервисы
Ручная установка
brew install chaindead/tap/telegram-mcpДля macOS и Linux. Дальше выполните telegram-mcp auth. Без Homebrew запускайте npx -y @chaindead/telegram-mcp или скачайте архив из релизов.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент читает ваши личные диалоги, группы и каналы под вашей учетной записью, а переписка попадает в модель
- Сессия Telegram хранится на диске, и тот, кто получит к ней доступ, получит доступ к аккаунту
- Неправильное использование API Telegram, по предупреждению автора, может привести к блокировке аккаунта
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Telegram MCP соединяет API Telegram и ИИ-ассистента. Сервер входит в Telegram от вашего имени через MTProto по идентификатору приложения и хешу API, поэтому агент видит ваши личные диалоги, группы и каналы. Инструментов пять. `tg_me` показывает данные текущего аккаунта. `tg_dialogs` выводит список диалогов, при желании только с непрочитанными. `tg_dialog` достает сообщения из конкретного диалога. `tg_read` отмечает диалог прочитанным. `tg_send` сохраняет сообщение в черновик диалога. С таким набором агент разбирает непрочитанное, готовит черновики ответов и ищет вопросы, которые остались без ответа. Авторизация нужна один раз: команда `telegram-mcp auth` спрашивает номер телефона и код из Telegram.
Для кого. Для тех, кто тонет в Telegram-чатах и хочет, чтобы Claude или Cursor разбирал непрочитанное и готовил черновики ответов.
Подходит, если
- После отпуска накопились непрочитанные диалоги, и нужна сводка с важным наверху
- Нужны черновики ответов на последние сообщения в рабочих чатах, которые вы просмотрите и отправите сами
- Хочется разложить чаты по папкам, а агент должен предложить схему по их содержанию
- Нужно проверить, остались ли в чатах вопросы, на которые вы не ответили
- Надо следить за обсуждением темы в одном чате и сообщать о новом
Не подходит, если
- Нужен бот: сервер работает через MTProto под вашим номером, API ботов он не использует
- Нужна автоматическая отправка сообщений: `tg_send` оставляет только черновик
- Нельзя давать агенту доступ к личной переписке, рабочим секретам и чужим данным
- Нужны удаление и правка сообщений, поиск по чатам и скачивание файлов: набор из пяти инструментов этого не включает
Пример запроса к агенту
Покажи непрочитанные диалоги в Telegram, выдели рабочие и подготовь черновик ответа на последний вопрос в чате командыMCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
TG_APP_IDобязательная- Идентификатор приложения Telegram с my.telegram.org
TG_API_HASHобязательная, секрет- Хеш API приложения Telegram
TG_SCHEMA_VERSION- Версия JSON Schema, если клиент не принимает 2020-12
Ограничения
Нужны идентификатор приложения и хеш API, которые получают на my.telegram.org, и вход по номеру телефона с кодом. При включенной двухфакторной защите в команду входа добавляют флаг `--password`, для замены сессии флаг `--new`.
Автор просит заранее изучить условия использования API Telegram: неправильное использование может закончиться блокировкой аккаунта. Сервер работает под вашим личным номером, поэтому все действия агента Telegram видит как ваши.
Доступность Telegram из России не проверена.
Как отключить. Удалите блок telegram из настроек клиента и перезапустите его. Чтобы закрыть сессию, откройте в Telegram раздел активных устройств и завершите сеанс программы. При установке через Homebrew сервер снимается командой `brew uninstall telegram-mcp`.
Частые вопросы
Как подключить Telegram MCP к Claude Desktop или Cursor?
Получите идентификатор приложения и хеш API на my.telegram.org и выполните `telegram-mcp auth --app-id <id> --api-hash <hash> --phone <номер>`. Затем добавьте в конфигурацию блок с командой `telegram-mcp` и переменными окружения `TG_APP_ID` и `TG_API_HASH`. Для Claude Desktop укажите еще `PATH` и `HOME`.
Как запустить сервер через npx?
Командой `npx -y @chaindead/telegram-mcp`. Авторизация тогда выглядит как `npx -y @chaindead/telegram-mcp auth ...`, а в конфигурации клиента команда `npx` с аргументами `-y` и `@chaindead/telegram-mcp`. Установщик Homebrew и готовые архивы для macOS, Linux и Windows тоже есть.
Может ли агент отправлять сообщения без меня?
Нет. Инструмент `tg_send` сохраняет черновик в диалоге, а отправляете его вы в приложении Telegram. Прочитанным диалог помечает `tg_read` по запросу агента.
Что делать при включенной двухфакторной защите?
Добавьте в команду авторизации ключ `--password` с вашим облачным паролем. Если нужно заменить уже сохраненную сессию, добавьте ключ `--new`.
Как обновить сервер?
Установленный через Homebrew сервер обновляется командой `brew upgrade chaindead/tap/telegram-mcp`. При запуске через `npx -y @chaindead/telegram-mcp` пакет берется из npm. Готовые архивы скачивают заново со страницы релизов.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
Telegram — все инструментыMCP-сервер на Telethon: агент читает и отправляет сообщения, управляет чатами, контактами и папками вашего аккаунта Telegram
MCP Telegram с записью: агент отправляет, правит и удаляет сообщения, ищет чаты, ведет черновики и скачивает медиа в вашем аккаунте через MTProto
MCP Telegram для чтения: агент получает список диалогов и непрочитанные сообщения вашего аккаунта через MTProto, писать от вашего имени он не умеет
Telegram API MCP
telegram-api-mcp
MCP-сервер для Telegram Bot API: сообщения, каналы, форумы, платежи и длинные посты от имени бота с учетом лимитов Telegram
TGStat MCP
tgstat-mcp
MCP-сервер TGStat: поиск Telegram-каналов и постов, динамика подписчиков и охватов, ERR и упоминания
MCP-сервер для почты Mail.ru в Claude.ai и отдельный Telegram-бот, который каждые 15 минут проверяет ящик и присылает уведомления о важных письмах
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Telegram MCP от chaindead (эта запись) | нет | API-ключ | 350 | |
| Telegram MCP Server | нет | API-ключ | 1 920 | сервер на Telethon, где агент читает, отправляет сообщения и управляет чатами, контактами и папками |
| mcp-telegram (sparfenyuk) | нет | API-ключ | 190 | только чтение: список диалогов и непрочитанные сообщения через MTProto |
| Telegram API MCP | нет | API-ключ | 33 | сервер для Bot API, работает от имени бота |
Коротко о README
Описание объясняет, что такое MCP, и перечисляет возможности с примерами запросов в трех группах: сообщения, организация и общение. Дальше идут способы установки, порядок авторизации, настройка клиентов и переопределение версии JSON Schema.