MCP-сервери для Telegram: юзербот чи бот (2026)
Підключити ШІ-агента до Telegram можна двома шляхами: юзербот-сервер на особистому акаунті або розміщений сервер, що публікує через бота вашого каналу.
Коротко. Запит «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-telegram | MTProto (GramJS) | ваш особистий акаунт | 181 — повідомлення, медіа, реакції, опитування, історії | npx, npm, збірки, Docker, вихідні коди; є хмара | MIT, у себе безкоштовно |
| chaindead/telegram-mcp | MTProto | ваш особистий акаунт | 5 — tg_me, tg_dialogs, tg_read, tg_dialog, tg_send | у себе; API ID і хеш, телефон, пароль 2FA | MIT, безкоштовно |
| AdminHub | Bot 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 обох обмежень немає.