Гайд

MCP-серверы для Telegram: юзербот или бот (2026)

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

AdminHub

Короче. Запрос «telegram mcp» выдаёт две категории, у которых общего только название. Юзербот-серверы — mcp-telegram/mcp-telegram со 181 инструментом и chaindead/telegram-mcp с пятью — входят в ваш личный аккаунт Telegram по MTProto и дают агенту тот же охват, что есть у приложения в вашем телефоне: личные переписки, любая группа, вся история. Ставите их вы сами, лицензия MIT, денег не стоят, и один из двух предупреждает в своём README, что злоупотребление API может стоить аккаунта. Серверы на боте покрывают намного меньше, и это сделано намеренно: четырнадцать инструментов AdminHub читают воркспейс, каналы и подписчиков и пишут посты, а публикует их бот, которого владелец канала завёл сам, — никогда общий бот AdminHub и никогда ваш личный аккаунт. Если вам нужен агент, читающий вашу личку в Telegram, дальше можно не читать: это работа юзербота, и об этом говорит каждый раздел ниже. Проекты сверены 7 сентября 2026 года.

Поищите «telegram mcp» — и получите страницу репозиториев, которые описывают себя одинаково: подключите своего ИИ-агента к Telegram. Поставьте наугад любой, и где-то на шаге входа выяснится, что «подключить к Telegram» означало «войти в свой личный аккаунт и отдать его агенту». Это законный инженерный выбор, и для целого класса задач — единственный работающий. Это ещё и решение, а большинство README подают его как пункт инструкции по установке. Ниже сначала разведены две категории и только потом названы проекты, и всё прочитано в репозиториях самих проектов 7 сентября 2026 года.

Вся разница — в протоколе

У Telegram две двери, и любой MCP-сервер выбирает одну из них раньше, чем что-либо ещё.

Bot API — это HTTP-обёртка вокруг личности бота. Вы берёте токен у BotFather, и программа с этим токеном действует как этот бот — но только внутри тех чатов и каналов, куда бота добавили. Она не видит ваши личные сообщения, не может завести себя в группу, не может прочитать канал, где её нет. Потолок здесь низкий по устройству; зато пол — в том, что наружу не выставлено ничего, что вы не подключили осознанно.

MTProto — собственный клиентский протокол Telegram, тот самый, на котором говорит приложение в вашем телефоне. Программа, вошедшая по MTProto с вашими данными, и есть ваш аккаунт, с вашим же доступом: каждая личная переписка, каждая группа, вся история с поиском по ней, избранное, всё. Сузить область нельзя, потому что аккаунт — это не область. Такие программы принято называть юзерботами.

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

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

Юзербот-серверы

mcp-telegram/mcp-telegram

Самый крупный с большим отрывом. Документация насчитывает 181 инструмент — сообщения, медиа, реакции, опросы, истории и другое, — всё это на MTProto через GramJS, и позиция изложена прямо: сервер работает как ваш личный аккаунт, а не как бот. Настройка означает вход в личный аккаунт Telegram, вход по QR-коду поддерживается, так что номер телефона строго обязательным не является. Запустить можно у себя — через npx, npm, готовые сборки, Docker или из исходников — либо взять размещённую версию на mcp-telegram.com. Лицензия MIT.

Документация называет вещь своим именем — userbot (personal account), not a bot — respect the Telegram Terms of Service, то есть «юзербот (личный аккаунт), а не бот — соблюдайте условия использования Telegram», — но останавливается, не доходя до предупреждения о последствиях. Одна эксплуатационная деталь, которую стоит знать до того, как подключать сервер сразу к двум клиентам: сессия принадлежит одному процессу, и запуск одной сессии в двух возвращает AUTH_KEY_DUPLICATED.

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

chaindead/telegram-mcp

Тот же протокол, площадь несравнимо меньше: пять инструментовtg_me, tg_dialogs, tg_read, tg_dialog и tg_send. Перечислить диалоги, прочитать переписку, отметить её прочитанной, отправить сообщение, узнать, кто вы. Тоже MIT, тоже личный аккаунт. Настройка просит больше, чем сканирование QR-кода: API ID и хеш, созданные на my.telegram.org, ваш номер телефона и пароль, если включена двухфакторная аутентификация.

Это ещё и проект, который проговаривает компромисс письменно: Ensure that you have read and understood the Telegram API Terms of Service before using this server. Any misuse of the Telegram API may result in the suspension of your account — «Убедитесь, что прочитали и поняли условия использования API Telegram, прежде чем пользоваться этим сервером. Любое злоупотребление Telegram API может привести к блокировке вашего аккаунта». Тот же протокол, что у сервера со 181 инструментом, та же открытость — просто сказанная там, где вы это увидите до того, как введёте номер телефона.

Чего стоит путь через личный аккаунт

Не «вас заблокируют». Честно этого никто вам сказать не может, и эта статья не будет. Задокументировано меньшее, и взвесить его всё равно стоит.

  • Ваш аккаунт и есть ключ доступа. Нет ни разрешений по отдельным чатам, ни режима «только чтение». Файл сессии, попавший к агенту, дотягивается до всего, до чего дотягивается аккаунт, — включая чаты, о которых вы забыли, что они на нём есть.
  • Автоматизация подпадает под условия API Telegram. Один из двух проектов прямо пишет, что злоупотребление может кончиться блокировкой. Принять эти условия просят оба; упоминает их один.
  • Оператор — вы. Хостинг у себя означает, что на вас процесс, файл сессии, обновления и сценарии отказа — включая AUTH_KEY_DUPLICATED, когда два клиента делят одну сессию. Облачный вариант mcp-telegram снимает заботу о хостинге, а не вопрос об аккаунте.
  • Радиус поражения — весь аккаунт. Инъекция промпта — живая проблема для любого агента, читающего недоверенный текст, а входящие в Telegram — недоверенный текст по определению. На пути юзербота в число инструментов, которыми может воспользоваться враждебная инструкция, входят и те, что читают все ваши переписки.

Ничто из этого не делает категорию неправильной. Это делает её осознанной сделкой: огромные возможности в обмен на то, что за агентом стоит ваш собственный аккаунт. Люди совершают эту сделку каждый день с открытыми глазами, и она верна всегда, когда задача действительно требует личного охвата.

Путь через бота: что умеет MCP-сервер AdminHub

Вторая сторона развилки отказывается от охвата и оставляет аккаунт в стороне. AdminHub держит размещённый MCP-сервер для Telegram-канала: ставить нечего, файла сессии нет, входа в личный аккаунт нет нигде в цепочке. Четырнадцать инструментов — это get_workspace, list_channels, get_channel_stats, list_posts, get_post, create_post, publish_post, cancel_post, update_post, edit_published_post, retry_post_delivery, add_post_image, list_subscribers и get_subscriber: прочитать воркспейс, перечислить каналы, прочитать статистику подписчиков, перечислить и прочитать посты, перечислить и прочитать отдельных подписчиков, а затем создать, отредактировать, опубликовать, удалить или переотправить пост либо приложить к нему картинку.

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

Подключаются двумя способами, в зависимости от клиента. claude.ai и ChatGPT принимают адрес сервера как пользовательский коннектор и проводят вход через Telegram; Claude Code, Cursor и другие клиенты, работающие заголовком, принимают ключ в заголовке Authorization. Руководство по подключению разбирает оба пути по клиентам и объясняет, что делать, когда инструмент отказал. Доступ отзывается в настройках AdminHub и перестаёт работать сразу. На Free доступны одно подключение и тридцать постов, созданных через MCP, в месяц; на Pro обоих ограничений нет.

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

Честно: где каждый из них сильнее нас

  • Чтение вашего Telegram как таковое. Оба юзербот-сервера умеют перечислить ваши диалоги и прочитать их. У AdminHub нет ни одного инструмента, который касается переписки, — ни личных сообщений, ни групп, ни канала, который вы не подключили. Если вы пришли к MCP ради «пусть Claude читает мой Telegram», мы не уменьшенная версия этого; мы другая вещь.
  • 181 инструмент против четырнадцати. mcp-telegram покрывает медиа, реакции, опросы и истории. Четырнадцать инструментов покрывают воркспейс, каналы, подписчиков и посты. Прочитать эту разницу в нашу пользу нельзя никак.
  • Поиск по собственной истории. Агенту, который отвечает на вопрос «о чём мы договорились по счёту в марте», нужен весь архив. Это может дать только MTProto.
  • Отправить сообщение от вашего имени. tg_send пишет с вашего аккаунта кому угодно. Бот не может написать человеку, который сам его не запустил, и не должен.
  • Любой чат, без договорённостей. Юзерботы дотягиваются до каждого диалога на аккаунте в тот же день, когда вы их поставили. Бот дотягивается ровно до тех каналов, куда его добавили администратором, — и добавлять его должен человек.
  • Хостинг у себя и ноль постоянных расходов. Оба проекта под MIT, работают на вашей машине и не стоят ничего. Размещённый сервер размещён кем-то другим и на чужих условиях; это настоящая разница, и она не в нашу пользу ни по цене, ни по контролю.
  • Аккаунт AdminHub не нужен. У них — репозиторий и вход. У нас до первого вызова инструмента нужны воркспейс и подключённый бот.

Кто есть кто

СерверПротоколЛичностьИнструментыУстановкаЛицензия и цена
mcp-telegram/mcp-telegramMTProto (GramJS)ваш личный аккаунт181 — сообщения, медиа, реакции, опросы, историиnpx, npm, сборки, Docker, исходники; есть облакоMIT, у себя бесплатно
chaindead/telegram-mcpMTProtoваш личный аккаунт5 — tg_me, tg_dialogs, tg_read, tg_dialog, tg_sendу себя; API ID и хеш, телефон, пароль 2FAMIT, бесплатно
AdminHubBot APIсобственный бот вашего канала14 — воркспейс, каналы, подписчики, постыставить нечего, размещённыйFree: 1 подключение, 30 постов через MCP в месяц; Pro: без лимита

Если… то…

Если…То…
Нужен агент, читающий вашу личку или групповые чатыЮзербот-сервер: mcp-telegram ради широты, chaindead ради малой площади
Нужен поиск по собственной истории сообщенийmcp-telegram; ни один сервер на Bot API так не умеет
Нужны реакции, опросы или историиmcp-telegram — у двух других таких инструментов нет
Нужно, чтобы агент написал человеку от вашего имениЮзербот-сервер; бот не может написать тому, кто сам его не запустил
Хочется держать всё на своей машине и бесплатноЛюбой из двух проектов под MIT, у себя
Задача звучит как «опубликуй в мой канал и расскажи, как зашло»Сервер AdminHub — четырнадцать инструментов, размещённый, публикует ваш собственный бот
Личный аккаунт не должен участвовать вовсеПуть через бота; у юзербота нет режима, в котором аккаунт не является ключом доступа
У вас нет бота в Telegram и заводить его вы не хотитеЮзербот-сервер; AdminHub без бота в воркспейсе не делает ничего

С чего начать

Ответьте на один вопрос раньше, чем начнёте сравнивать число инструментов: чьей личностью должен пользоваться агент?

Если ответ — «моей, потому что задача про мои входящие», вы в категории юзерботов, и выбор внутри неё — широта против площади. mcp-telegram даёт 181 инструмент и вход по QR-коду; chaindead даёт пять и просит данные API. Прочитайте оба README до конца: строчка про условия использования — это одно предложение, и в обоих файлах оно несёт наибольший вес.

Если ответ — «личностью бота, потому что задача про канал», вопрос об аккаунте не возникает вовсе, а список инструментов короток намеренно. Начните со страницы MCP: бесплатного тарифа — одно подключение и тридцать постов в месяц — хватает, чтобы понять, останется ли у вас в работе агент, который читает вашу статистику и публикует за вас. Остальная картина публикации в Telegram — очереди по расписанию, импорт RSS, конвейеры, которые настраивают один раз, а не просят каждый раз, — собрана в полном руководстве по автопостингу, а завести самого бота — это минута, если его ещё нет.

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

Источники

Всё прочитано 7 сентября 2026 года. Число инструментов, основа из GramJS и MTProto, формулировка про «личный аккаунт, а не бот», вход по QR-коду, способы установки и заметка про одну сессию с AUTH_KEY_DUPLICATEDрепозиторий mcp-telegram и mcp-telegram.com. Пять инструментов, требование API ID и хеша с my.telegram.org, пароль двухфакторной аутентификации и процитированное выше предупреждение об условиях использования — репозиторий chaindead/telegram-mcp. Область действия Bot API и модель токена от BotFather — документация Bot API Telegram. Числа AdminHub — четырнадцать инструментов, два способа подключения, лимиты Free и Pro — со страницы MCP на этом сайте.

Что обычно спрашивают

Есть ли официальный MCP-сервер Telegram?
Нет. Telegram не выпускает собственного сервера Model Context Protocol, поэтому любой вариант — сторонний. Почти всё, что лежит на GitHub, — юзерботы: они говорят на MTProto, том самом протоколе, на котором работают приложения самого Telegram, и действуют от вашего личного аккаунта, а не от бота. Меньшая часть работает через Bot API и достаёт только те каналы и группы, куда бота добавили. Сверено 7 сентября 2026 года.
Чем юзербот-сервер отличается от сервера на боте?
Охватом и радиусом поражения, и они меняются вместе. Юзербот-сервер входит в ваш личный аккаунт и наследует всё, что тот видит: каждую личную переписку, каждую группу, всю историю сообщений. Сервер на Bot API достаёт только те чаты, куда бота добавили, и вашу личную переписку не читает вовсе. Путь юзербота покупает несравнимо больше возможностей; путь бота покупает несравнимо меньшую площадь отказа.
Может ли ИИ-агент читать мои личные сообщения в Telegram через MCP?
Только через юзербот-сервер, вошедший в ваш аккаунт, — и тогда да, ровно для этого он и нужен. chaindead/telegram-mcp даёт пять инструментов: перечислить диалоги, прочитать их и отправить сообщение; mcp-telegram/mcp-telegram даёт 181 — сообщения, медиа, реакции, опросы, истории. Сервер AdminHub не может этого вовсе: у него нет инструментов ни для личных переписок, ни для произвольных чатов, ни для истории сообщений.
Заблокируют ли мой аккаунт Telegram за использование MCP-сервера?
Это компромисс, который надо взвесить, а не предсказание, которое кто-то может дать вам за Telegram. Автоматизация личного аккаунта подпадает под условия использования API Telegram, и chaindead/telegram-mcp говорит об этом в своём же README: any misuse of the Telegram API may result in the suspension of your account — любое злоупотребление Telegram API может привести к блокировке вашего аккаунта. У сервера, который работает через бота, этот вопрос не возникает вовсе: никакой личный аккаунт нигде не залогинен.
Что на самом деле умеет MCP-сервер AdminHub?
Четырнадцать инструментов: читать воркспейс, каналы и подписчиков, перечислять и читать посты, а также создать, отредактировать, опубликовать, удалить или переотправить пост — плюс приложить картинку, один раз пересланную через личку владельца с ботом, чтобы получить file id. Сервер размещённый, ставить ничего не нужно, а публикует он через бота, которого вы завели для своего канала. Приложить что-то кроме картинки он не может и читать чаты не может. На Free доступны одно подключение и тридцать постов, созданных через MCP, в месяц; на Pro обоих ограничений нет.