Server MCP Telegram: userbot vs bot (2026)

Ringkasnya. “Telegram MCP” mengembalikan dua kategori yang tidak berbagi apa pun selain nama. Server userbot — mcp-telegram/mcp-telegram dengan 181 tool, chaindead/telegram-mcp dengan lima — login ke akun Telegram pribadimu lewat MTProto dan menyerahkan kepada agen jangkauan yang sama dengan aplikasi di ponselmu: chat pribadi, grup mana pun, seluruh riwayat. Kamu pasang sendiri, lisensinya MIT, gratis, dan salah satunya memperingatkan di README-nya sendiri bahwa menyalahgunakan API bisa merenggut akunmu. Server bot mencakup jauh lebih sedikit, dan itu disengaja: empat belas tool AdminHub membaca workspace, channel, dan pelanggan lalu menulis postingan, yang diterbitkan oleh bot yang dibuat sendiri oleh pemilik channel — bukan bot bersama milik AdminHub, dan bukan akun pribadimu. Kalau yang kamu mau adalah agen yang membaca DM Telegram-mu, berhenti di sini: itu pekerjaan userbot, dan setiap bagian di bawah mengatakan hal yang sama. Proyek diperiksa 7 September 2026.

Cari “telegram mcp” dan kamu akan mendapat satu halaman penuh repositori yang menggambarkan dirinya dengan cara yang persis sama — hubungkan agen AI-mu ke Telegram. Pasang satu secara acak, dan di sekitar langkah login kamu baru tahu bahwa “hubungkan ke Telegram” ternyata berarti “login ke akun pribadimu dan serahkan akun itu ke agen”. Itu desain yang sah, dan untuk sekelas besar pekerjaan itulah satu-satunya yang jalan. Itu juga sebuah keputusan, dan kebanyakan README menyajikannya sebagai instruksi pemasangan. Tulisan ini memisahkan dua kategorinya lebih dulu dan menyebut nama proyek belakangan, dengan semuanya dibaca langsung dari repositori proyek masing-masing pada 7 September 2026.

Protokolnya adalah seluruh perbedaannya

Telegram punya dua pintu, dan setiap server MCP memilih salah satunya sebelum memilih apa pun yang lain.

Bot API adalah pembungkus HTTP di sekitar identitas sebuah bot. Kamu mengambil token dari BotFather, dan perangkat lunak yang memegang token itu bertindak sebagai bot tersebut — tapi hanya di dalam chat dan channel tempat bot itu ditambahkan. Ia tidak bisa melihat pesan pribadimu, tidak bisa memasukkan dirinya sendiri ke grup, tidak bisa membaca channel yang bukan tempatnya berada. Plafonnya rendah secara bawaan; lantainya adalah bahwa tidak ada yang terpapar kecuali yang kamu sambungkan dengan sengaja.

MTProto adalah protokol klien Telegram sendiri, yang dipakai aplikasi di ponselmu. Program yang login lewat MTProto dengan kredensialmu adalah akunmu, dengan akses yang kamu punya: setiap percakapan pribadi, setiap grup, seluruh riwayat lengkap dengan pencariannya, pesan tersimpan, semuanya. Tidak ada cakupan yang bisa dipersempit, karena akun bukanlah cakupan. Perangkat lunak yang melakukan ini lazim disebut userbot.

Satu pilihan itu menentukan semua yang mengikutinya — berapa banyak tool yang bisa ditawarkan sebuah server, apa yang bisa ia baca, apa yang ia minta darimu saat disiapkan, dan apa yang dipertaruhkan ketika ada yang salah. Baca baris tentang protokol di README sebelum membaca jumlah toolnya.

Yang perlu dicatat, tidak ada pilihan resmi sebagai pembanding. Telegram tidak merilis server MCP apa pun, jadi lapangan ini sepenuhnya milik pihak ketiga, dan sebagian besarnya adalah userbot yang kamu pasang sendiri.

Server-server userbot

mcp-telegram/mcp-telegram

Yang terbesar, dengan jarak jauh. Dokumentasinya menghitung 181 tool — pesan, media, reaksi, polling, stories, dan lainnya — dibangun di atas MTProto lewat GramJS, dan posisinya dinyatakan terus terang: ia bekerja sebagai akun pribadimu, bukan sebagai bot. Menyiapkannya berarti login ke sebuah akun Telegram pribadi, dengan login QR yang didukung, jadi nomor telepon tidak mutlak diperlukan. Kamu bisa menjalankannya sendiri lewat npx, npm, binary siap pakai, Docker, atau dari kode sumber, atau memakai versi hosted di mcp-telegram.com. Lisensinya MIT.

Dokumentasinya menyebut benda itu apa adanya — userbot (personal account), not a bot — respect the Telegram Terms of Service, yaitu “userbot (akun pribadi), bukan bot — hormati Ketentuan Layanan Telegram” — sambil berhenti sebelum peringatan apa pun soal konsekuensi. Satu detail operasional yang perlu diketahui sebelum menyambungkannya ke dua klien sekaligus: satu sesi milik satu proses, dan menjalankan sesi yang sama di dua tempat mengembalikan AUTH_KEY_DUPLICATED.

181 tool itu bukan pengisi ruang. Reaksi, polling, stories, dan pencarian di riwayatmu sendiri adalah permukaan yang nyata, dan tidak ada server Bot API yang menjangkaunya untuk chat sembarang — tidak tahun ini, tidak juga dari vendor lain. Kalau itu pekerjaannya, inilah kategorinya, dan tidak ada satu pun di bagian berikutnya artikel ini yang menyaingi.

chaindead/telegram-mcp

Protokol yang sama, permukaan yang jauh lebih kecil: lima tool — tg_me, tg_dialogs, tg_read, tg_dialog, dan tg_send. Melihat daftar dialogmu, membaca sebuah percakapan, menandainya sudah dibaca, mengirim pesan, mengecek kamu siapa. Juga MIT, juga akun pribadi. Penyiapannya meminta lebih dari sekadar memindai QR: API ID dan hash yang dibuat di my.telegram.org, nomor teleponmu, dan kata sandimu kalau autentikasi dua faktor menyala.

Ini juga proyek yang menuliskan kompromi itu hitam di atas putih: 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 — “Pastikan kamu sudah membaca dan memahami Ketentuan Layanan API Telegram sebelum memakai server ini. Penyalahgunaan API Telegram apa pun bisa berujung pada penangguhan akunmu”. Protokol yang sama dengan server 181 tool, keterpaparan yang sama — hanya saja dinyatakan di tempat yang bisa kamu lihat sebelum mengetikkan nomor teleponmu.

Berapa harga jalur akun pribadi

Bukan “kamu akan diblokir”. Tidak ada orang jujur yang bisa mengatakan itu kepadamu, dan artikel ini tidak akan. Yang tercatat lebih sempit dari itu, dan tetap layak ditimbang.

• Akunmu adalah kredensialnya. Tidak ada izin per chat yang bisa diberikan, dan tidak ada mode baca-saja. File sesi yang sampai ke tangan agen menjangkau semua yang bisa dijangkau akun itu, termasuk chat yang sudah kamu lupa masih ada di sana.
• Otomatisasi tunduk pada ketentuan API Telegram. Salah satu dari dua proyek di sini menyatakan terang-terangan bahwa penyalahgunaan bisa berujung penangguhan. Keduanya sama-sama meminta kamu menerima ketentuan yang sama; hanya satu yang menyebutnya.
• Operatornya adalah kamu. Self-host berarti proses, file sesi, pembaruan, dan mode kegagalan menjadi milikmu — termasuk AUTH_KEY_DUPLICATED ketika dua klien berbagi satu sesi. Varian cloud dari mcp-telegram menghilangkan pekerjaan hosting, bukan pertanyaan soal akun.
• Radius kerusakannya adalah akun itu sendiri. Prompt injection adalah kekhawatiran nyata bagi agen mana pun yang membaca teks tak tepercaya, dan kotak masuk Telegram adalah teks tak tepercaya menurut definisinya. Di jalur userbot, tool yang bisa bertindak atas instruksi bermusuhan termasuk tool yang membaca seluruh percakapan yang kamu punya.

Tidak satu pun dari itu membuat kategori ini salah. Itu membuatnya menjadi pertukaran yang disengaja: kemampuan yang luar biasa besar ditukar dengan menempatkan akunmu sendiri di belakang agen. Orang melakukan pertukaran itu setiap hari dengan mata terbuka, dan itu keputusan yang benar setiap kali pekerjaannya memang menuntut jangkauan pribadi.

Jalur bot: apa yang dilakukan server MCP AdminHub

Sisi lain dari percabangan ini melepaskan jangkauan dan menjaga akun tetap di luar. AdminHub menjalankan server MCP hosted untuk sebuah channel Telegram — tidak ada yang perlu dipasang, tidak ada file sesi, tidak ada login ke akun pribadi di titik mana pun dalam rantainya. Empat belas toolnya adalah 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, dan get_subscriber: membaca workspace, melihat daftar channel, membaca statistik pelanggan, melihat daftar dan isi postingan, melihat daftar dan detail pelanggan satu per satu, lalu membuat, menyunting, menerbitkan, menghapus, atau mengirim ulang sebuah postingan, atau melampirkan gambar padanya.

Penerbitan berjalan lewat bot yang dibuat sendiri oleh pemilik channel untuk channel-nya dalam sekali ketuk — bukan bot bersama milik AdminHub, dan bukan akun pribadimu. Itulah yang membuat pertanyaan soal akun lenyap alih-alih sekadar dikelola: bot hanya bisa bertindak di channel tempat ia ditambahkan sebagai admin, jadi kasus terburuk dari agen yang kebingungan adalah postingan buruk di channel yang memang sudah kamu serahkan padanya, bukan pesan yang terkirim dari dirimu ke orang lain.

Menyambungkannya bisa dua cara, tergantung kliennya. claude.ai dan ChatGPT menerima alamat server sebagai custom connector lalu login dengan Telegram; Claude Code, Cursor, dan klien lain yang berbasis header menerima kunci di header Authorization. Panduan penyiapannya menelusuri kedua jalur itu klien per klien, dan apa yang harus dilakukan ketika sebuah tool menolak. Akses dicabut di pengaturan AdminHub dan langsung berhenti bekerja. Free mencakup satu koneksi dan tiga puluh postingan yang dibuat lewat MCP per bulan; Pro menghapus kedua batas itu.

Apa yang tidak bisa ia lakukan, dinyatakan terang-terangan alih-alih dikubur: tidak ada lampiran video atau dokumen pada postingan, hanya satu gambar, dan membawanya ke sana berarti satu pesan yang diteruskan lewat chat pemilik dengan botnya sendiri; tidak ada pembacaan chat pribadi, chat sembarang, maupun riwayat pesan; tidak ada reaksi dan tidak ada stories; dan sama sekali tidak ada apa-apa tanpa bot yang tersambung ke workspace. Ini permukaan penerbitan channel untuk agen, bukan akses ke Telegram.

Jujurnya, di mana masing-masing mengalahkan kami

• Membaca Telegram-mu, titik. Kedua server userbot bisa melihat daftar dialogmu dan membacanya. Milik AdminHub tidak punya satu pun tool yang menyentuh percakapan — bukan pesan pribadi, bukan grup, bukan channel yang belum kamu sambungkan. Kalau alasanmu datang ke MCP adalah “biar Claude membaca Telegram-ku”, kami bukan versi kecil dari itu; kami barang yang berbeda.
• 181 tool melawan empat belas. mcp-telegram mencakup media, reaksi, polling, dan stories. Empat belas tool mencakup workspace, channel, pelanggan, dan postingan. Tidak ada cara membaca selisih itu yang menguntungkan kami.
• Pencarian di riwayatmu sendiri. Agen yang menjawab “apa yang kita sepakati soal tagihan bulan Maret” butuh seluruh arsip. Itu yang hanya bisa diberikan MTProto.
• Mengirim pesan sebagai dirimu. tg_send menulis dari akunmu ke siapa saja. Bot tidak bisa mengirim pesan ke orang yang belum pernah memulainya, dan memang seharusnya tidak.
• Chat apa pun, tanpa pengaturan awal. Userbot menjangkau setiap dialog di akun itu pada hari kamu memasangnya. Bot menjangkau persis channel tempat ia ditambahkan sebagai admin, dan seseorang harus menambahkannya.
• Self-hosting dan nol biaya berulang. Kedua proyek berlisensi MIT, berjalan di mesinmu sendiri, dan tidak memungut biaya. Server hosted dihosting orang lain dengan ketentuan orang lain; itu perbedaan yang nyata, dan tidak berpihak pada kami baik dari sisi harga maupun kendali.
• Tidak perlu akun AdminHub. Mereka adalah sebuah repositori dan sebuah login. Milik kami butuh workspace dan bot yang tersambung sebelum panggilan tool pertama.

Siapa siapa

Server	Protokol	Identitas	Tool	Pemasangan	Lisensi / biaya
mcp-telegram/mcp-telegram	MTProto (GramJS)	akun pribadimu	181 — pesan, media, reaksi, polling, stories	npx, npm, binary, Docker, kode sumber; ada opsi cloud	MIT, gratis untuk self-host
chaindead/telegram-mcp	MTProto	akun pribadimu	5 — tg_me, tg_dialogs, tg_read, tg_dialog, tg_send	self-host; API ID + hash, nomor telepon, kata sandi 2FA	MIT, gratis
AdminHub	Bot API	bot milik channel-mu sendiri	14 — workspace, channel, pelanggan, postingan	tidak ada yang dipasang, hosted	Free: 1 koneksi, 30 postingan MCP/bulan; Pro: tanpa batas

Kalau… maka…

Kalau…	Maka…
Kamu mau agen membaca DM atau chat grupmu	Server userbot — mcp-telegram untuk keluasan, chaindead untuk permukaan kecil
Kamu mau pencarian di riwayat pesanmu sendiri	mcp-telegram; tidak ada server Bot API yang bisa
Kamu mau reaksi, polling, atau stories	mcp-telegram — dua lainnya tidak punya tool seperti itu
Kamu mau agen mengirim pesan ke orang sebagai dirimu	Server userbot; bot tidak bisa mengirim pesan ke orang yang belum memulainya
Kamu mau menjalankan semuanya di mesin sendiri tanpa biaya	Salah satu dari dua proyek MIT itu, self-host
Pekerjaannya adalah “posting ke channel-ku dan beri tahu hasilnya”	Server AdminHub — empat belas tool, hosted, diterbitkan oleh botmu sendiri
Akun pribadimu harus sepenuhnya tidak terlibat	Jalur bot; userbot tidak punya mode di mana akun bukan kredensialnya
Kamu tidak punya bot Telegram dan tidak mau punya	Server userbot; AdminHub tidak melakukan apa pun tanpa bot di workspace

Mulai dari mana

Jawab satu pertanyaan sebelum membandingkan jumlah tool: identitas siapa yang seharusnya dipakai agen itu?

Kalau jawabannya “punyaku, karena pekerjaannya adalah kotak masukku”, kamu ada di kategori userbot, dan pilihan di dalamnya adalah keluasan melawan luas permukaan. mcp-telegram memberimu 181 tool dan login QR; chaindead memberimu lima dan meminta kredensial API. Baca kedua README itu sampai habis — baris tentang ketentuan layanan hanya satu kalimat, dan itulah kalimat yang paling menanggung beban di kedua berkas tersebut.

Kalau jawabannya “punya bot, karena pekerjaannya adalah sebuah channel”, pertanyaan soal akun tidak pernah muncul dan daftar toolnya pendek dengan sengaja. Mulai dari halaman MCP: paket gratisnya satu koneksi dan tiga puluh postingan per bulan, cukup untuk mengetahui apakah agen yang bisa membaca statistikmu dan memposting untukmu adalah alur kerja yang akan kamu pertahankan. Sisa gambaran penerbitan Telegram — antrean terjadwal, impor RSS, pipeline yang kamu atur sekali alih-alih diminta tiap kali — ada di panduan lengkap autoposting, dan membuat botnya sendiri memakan waktu sekitar semenit kalau kamu belum punya.

Dan kalau kamu belum yakin, perhatikan bahwa keduanya tidak saling meniadakan. Server userbot di laptopmu untuk arsipmu sendiri dan server bot hosted untuk channel tempat kamu memposting adalah dua alat berbeda untuk dua pekerjaan berbeda, dan menjalankan keduanya adalah jawaban yang wajar.

Sumber

Semua diambil pada 7 September 2026. Jumlah tool, basis GramJS dan MTProto, pembingkaian “akun pribadi, bukan bot”, login QR, jalur pemasangan, dan catatan sesi tunggal AUTH_KEY_DUPLICATED: repositori mcp-telegram dan mcp-telegram.com. Kelima tool, syarat API ID dan hash dari my.telegram.org, kata sandi dua faktor, dan peringatan Ketentuan Layanan yang dikutip di atas: repositori chaindead/telegram-mcp. Cakupan Bot API dan model token BotFather: dokumentasi Bot API Telegram. Angka-angka AdminHub — empat belas tool, dua metode koneksi, batas Free dan Pro — berasal dari halaman MCP di situs ini.