Telegram MCP sunucuları: userbot mu, bot mu (2026)

Özet. “Telegram MCP” araması, adından başka ortak yanı olmayan iki kategori döndürüyor. Userbot sunucuları — 181 araçlı mcp-telegram/mcp-telegram ve beş araçlı chaindead/telegram-mcp — MTProto üzerinden kişisel Telegram hesabına giriş yapar ve ajana telefonundaki uygulamanın sahip olduğu erişimin aynısını verir: özel sohbetler, herhangi bir grup, tüm geçmiş. Kendin kurarsın, lisansları MIT, ücretsizdirler ve ikisinden biri kendi README dosyasında API’yi kötüye kullanmanın hesabına mal olabileceği uyarısını taşır. Bot sunucuları çok daha azını kapsar, hem de bilerek: AdminHub’ın on dört aracı çalışma alanını, kanalları ve aboneleri okur, gönderi yazar; yayını ise kanal sahibinin kendi kurduğu bot yapar — asla ortak bir AdminHub botu ve asla senin kişisel hesabın değil. İstediğin şey Telegram özel mesajlarını okuyan bir ajansa burada durabilirsin: o iş userbot işidir ve aşağıdaki her bölüm aynı şeyi söylüyor. Projeler 7 Eylül 2026’da doğrulandı.

“telegram mcp” diye ara, hepsi kendini aynı şekilde tarif eden bir sayfa dolusu depo çıksın: yapay zeka ajanını Telegram’a bağla. Rastgele birini kur, giriş adımı civarında bir yerde “Telegram’a bağlan” ifadesinin aslında “kişisel hesabına gir ve onu ajana bırak” demek olduğunu fark edersin. Bu meşru bir tasarım ve koca bir iş sınıfı için işe yarayan tek tasarım. Aynı zamanda bir karar — README dosyalarının çoğu ise bunu bir kurulum talimatı gibi sunuyor. Bu yazı önce iki kategoriyi ayırıyor, projeleri sonra adlandırıyor; her şey 7 Eylül 2026’da projelerin kendi depolarından okundu.

Bütün fark protokolde

Telegram’ın iki kapısı var ve her MCP sunucusu, başka hiçbir şeyi seçmeden önce birini seçiyor.

Bot API, bir bot kimliğinin etrafına sarılmış bir HTTP katmanıdır. BotFather’dan bir token alırsın ve o token’ı taşıyan yazılım o bot olarak davranır — ama yalnızca botun eklendiği sohbetlerin ve kanalların içinde. Özel mesajlarını göremez, kendini bir gruba sokamaz, üyesi olmadığı bir kanalı okuyamaz. Tavan yapısı gereği alçaktır; buna karşılık zemin, bilerek bağlamadığın hiçbir şeyin açığa çıkmamasıdır.

MTProto, Telegram’ın kendi istemci protokolü — telefonundaki uygulamanın konuştuğu protokol. MTProto üzerinden senin kimlik bilgilerinle giriş yapan bir program, senin sahip olduğun erişimle birlikte senin hesabındır: her özel konuşma, her grup, arama yapılabilen tüm geçmiş, kayıtlı mesajlar, hepsi. Daraltılacak bir kapsam yoktur, çünkü hesap bir kapsam değildir. Bunu yapan yazılıma alışılageldiği üzere userbot denir.

Bu tek seçim, sonrasındaki her şeyi belirler: bir sunucunun kaç araç sunabileceğini, neyi okuyabileceğini, kurulumda senden ne isteyeceğini ve bir şey ters gittiğinde nelerin tehlikeye gireceğini. Bir README’de araç sayısını okumadan önce protokol satırını oku.

Üstelik karşılaştırılacak resmî bir seçenek de yok. Telegram kendi MCP sunucusunu çıkarmıyor, yani alan tamamen üçüncü taraflara ait ve büyük çoğunluğu kendi kurduğun userbot’lar.

Userbot sunucuları

mcp-telegram/mcp-telegram

Farkla en büyüğü. Belgeleri 181 araç sayıyor — mesajlar, medya, tepkiler, anketler, hikâyeler ve dahası — hepsi GramJS aracılığıyla MTProto üzerine kurulu; ve duruşunu açıkça söylüyor: bot olarak değil, senin kişisel hesabın olarak çalışıyor. Kurulum, kişisel bir Telegram hesabına giriş yapmak anlamına geliyor; QR ile giriş destekleniyor, dolayısıyla telefon numarası kesin bir zorunluluk değil. Kendin npx, npm, hazır ikili dosyalar, Docker ya da kaynaktan çalıştırabilir veya mcp-telegram.com’daki barındırılan sürümü kullanabilirsin. Lisans MIT.

Belgeler nesneyi adıyla anıyor — userbot (personal account), not a bot — respect the Telegram Terms of Service, yani “userbot (kişisel hesap), bot değil — Telegram Hizmet Şartları’na uy” — ama sonuçlarla ilgili herhangi bir uyarıya varmadan duruyor. İki istemciye aynı anda bağlamadan önce bilinmesi gereken bir işletim ayrıntısı: bir oturum tek bir sürece aittir ve aynı oturumu ikide birden çalıştırmak AUTH_KEY_DUPLICATED döndürür.

181 araç dolgu malzemesi değil. Tepkiler, anketler, hikâyeler ve kendi geçmişinde arama gerçek yüzeylerdir ve hiçbir Bot API sunucusu rastgele sohbetlerde bunlara ulaşamaz — bu yıl da ulaşamaz, başka bir sağlayıcıyla da. İş buysa, kategori budur ve bu yazının devamındaki hiçbir şey onunla yarışmaz.

chaindead/telegram-mcp

Aynı protokol, çok daha küçük bir yüzey: beş araç — tg_me, tg_dialogs, tg_read, tg_dialog ve tg_send. Sohbetlerini listele, bir konuşmayı oku, okundu işaretle, mesaj gönder, kim olduğunu kontrol et. O da MIT, o da kişisel hesap. Kurulum bir QR taramaktan fazlasını istiyor: my.telegram.org’da oluşturulan bir API ID ve hash, telefon numaran ve iki adımlı doğrulama açıksa parolan.

Ödünleşimi yazıya döken proje de bu: 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 — “Bu sunucuyu kullanmadan önce Telegram API Hizmet Şartları’nı okuduğundan ve anladığından emin ol. Telegram API’nin herhangi bir kötüye kullanımı hesabının askıya alınmasıyla sonuçlanabilir”. 181 araçlı sunucuyla aynı protokol, aynı maruziyet — sadece telefon numaranı yazmadan önce görebileceğin bir yerde söylenmiş.

Kişisel hesap yolunun bedeli

“Hesabın kapatılacak” değil. Dürüst hiç kimse bunu sana söyleyemez, bu yazı da söylemeyecek. Kayda geçmiş olan daha dar bir şey, ve yine de tartmaya değer.

• Kimlik bilgin hesabının kendisi. Verilecek sohbet bazlı bir izin de yok, salt okunur bir mod da. Bir ajana ulaşan oturum dosyası, hesabın ulaşabildiği her şeye ulaşır — o hesapta olduğunu unuttuğun sohbetler dahil.
• Otomasyon, Telegram’ın API şartları kapsamında çalışır. Buradaki iki projeden biri kötüye kullanımın askıya alınmayla sonuçlanabileceğini açıkça yazıyor. İkisi de aynı şartları kabul etmeni istiyor; yalnızca biri bundan söz ediyor.
• İşletmecisi sensin. Kendi sunucunda barındırmak; süreç, oturum dosyası, güncellemeler ve hata durumları senindir demektir — iki istemci bir oturumu paylaştığında çıkan AUTH_KEY_DUPLICATED dahil. mcp-telegram’ın bulut sürümü barındırma yükünü kaldırır, hesap sorusunu değil.
• Etki alanı hesabın tamamı. Prompt injection, güvenilmeyen metin okuyan her ajan için canlı bir mesele ve bir Telegram gelen kutusu tanımı gereği güvenilmeyen metindir. Userbot yolunda, düşmanca bir talimatla harekete geçebilecek araçların arasında sahip olduğun bütün konuşmaları okuyanlar da vardır.

Bunların hiçbiri kategoriyi yanlış yapmaz. Onu bilinçli bir takasa dönüştürür: ajanın arkasına kendi hesabını koymak karşılığında muazzam bir yetenek. İnsanlar bu takası her gün gözleri açık yapıyor ve iş gerçekten kişisel erişim gerektiriyorsa doğru karar da budur.

Bot yolu: AdminHub’ın MCP sunucusu ne yapıyor

Çatalın diğer tarafı erişim genişliğinden vazgeçip hesabı işin dışında tutuyor. AdminHub bir Telegram kanalı için barındırılan bir MCP sunucusu işletiyor — kurulacak bir şey yok, oturum dosyası yok, zincirin hiçbir yerinde kişisel bir hesaba giriş yok. On dört araç şunlar: 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 ve get_subscriber — çalışma alanını okumak, kanalları listelemek, abone istatistiklerini okumak, gönderileri listelemek ve okumak, aboneleri tek tek listelemek ve okumak, ardından bir gönderiyi oluşturmak, düzenlemek, yayınlamak, silmek veya yeniden göndermek ya da ona bir görsel eklemek.

Yayın, kanal sahibinin kendi kanalı için tek dokunuşla kurduğu bottan geçer — asla ortak bir AdminHub botundan ve asla senin kişisel hesabından değil. Hesap sorusunu yönetilen bir riske dönüştürmek yerine ortadan kaldıran şey budur: bot yalnızca yönetici olarak eklendiği kanallarda hareket edebilir, dolayısıyla kafası karışmış bir ajanın en kötü ihtimali, zaten ona verdiğin bir kanaldaki kötü bir gönderidir — senin adına başka birine gitmiş bir mesaj değil.

Bağlanmanın iki yolu var, istemciye göre değişiyor. claude.ai ve ChatGPT sunucu adresini özel bağlayıcı olarak alıp Telegram ile giriş yapıyor; Claude Code, Cursor ve başlık tabanlı diğer istemciler Authorization başlığında bir anahtar alıyor. Kurulum rehberi her iki yolu istemci istemci anlatıyor ve bir araç reddettiğinde ne yapılacağını da. Erişim AdminHub ayarlarından iptal ediliyor ve anında çalışmayı bırakıyor. Free planı ayda bir bağlantı ve MCP üzerinden oluşturulan otuz gönderi kapsıyor; Pro her iki sınırı da kaldırıyor.

Yapamadıkları, gömülmek yerine açıkça söyleniyor: bir gönderiye video veya belge eklenmiyor, yalnızca tek bir görsel — onu oraya götürmek de sahibin kendi botuyla olan sohbetinden geçen bir mesaj demek; özel sohbetlerin, rastgele sohbetlerin veya mesaj geçmişinin okunması yok; tepki yok, hikâye yok; ve çalışma alanına bağlı bir bot olmadan hiçbir şey yok. Bu, bir ajan için kanal yayınlama yüzeyidir, Telegram erişimi değil.

Dürüstçe, her biri bizi nerede geçiyor

• Telegram’ını okumak, hepsi bu. İki userbot sunucusu da sohbetlerini listeleyip okuyabiliyor. AdminHub’ınkinin bir konuşmaya dokunan tek bir aracı bile yok — ne özel mesajlar, ne gruplar, ne de bağlamadığın bir kanal. MCP’ye gelme sebebin “Claude Telegram’ımı okusun” ise, biz bunun küçük bir sürümü değiliz; başka bir şeyiz.
• 181 araca karşı on dört. mcp-telegram medyayı, tepkileri, anketleri ve hikâyeleri kapsıyor. On dört araç bir çalışma alanını, kanalları, aboneleri ve gönderileri kapsıyor. Bu farkı bizim lehimize okumanın hiçbir yolu yok.
• Kendi geçmişinde arama. “Mart’ta faturayla ilgili neye karar vermiştik” sorusunu yanıtlayan bir ajanın bütün arşive ihtiyacı var. Onu verebilecek olan MTProto’dur.
• Senin adına mesaj göndermek. tg_send senin hesabından herkese yazar. Bir bot, kendisini hiç başlatmamış bir kişiye yazamaz — ve yazmamalı.
• Herhangi bir sohbet, önceden anlaşmadan. Userbot’lar kurduğun gün hesaptaki her sohbete ulaşır. Bir bot tam olarak yönetici olarak eklendiği kanallara ulaşır ve onu birinin eklemesi gerekir.
• Kendi sunucunda barındırma ve sıfır düzenli maliyet. İki proje de MIT, kendi makinende çalışıyorlar ve hiçbir ücreti yok. Barındırılan bir sunucuyu başka biri kendi şartlarıyla barındırır; bu gerçek bir farktır ve ne fiyatta ne de kontrolde bizim lehimize işler.
• AdminHub hesabı gerekmiyor. Onlar bir depo ve bir giriş. Bizimki ilk araç çağrısından önce bir çalışma alanı ve bağlı bir bot istiyor.

Kim kimdir

Sunucu	Protokol	Kimlik	Araçlar	Kurulum	Lisans / maliyet
mcp-telegram/mcp-telegram	MTProto (GramJS)	senin kişisel hesabın	181 — mesajlar, medya, tepkiler, anketler, hikâyeler	npx, npm, ikili dosyalar, Docker, kaynak; bulut seçeneği var	MIT, kendi sunucunda ücretsiz
chaindead/telegram-mcp	MTProto	senin kişisel hesabın	5 — tg_me, tg_dialogs, tg_read, tg_dialog, tg_send	kendi sunucunda; API ID + hash, telefon, 2FA parolası	MIT, ücretsiz
AdminHub	Bot API	kendi kanalının botu	14 — çalışma alanı, kanallar, aboneler, gönderiler	kurulacak bir şey yok, barındırılıyor	Free: 1 bağlantı, ayda 30 MCP gönderisi; Pro: sınırsız

Eğer… o zaman…

Eğer…	O zaman…
Ajanın özel mesajlarını veya grup sohbetlerini okumasını istiyorsan	Bir userbot sunucusu — genişlik için mcp-telegram, küçük yüzey için chaindead
Kendi mesaj geçmişinde arama istiyorsan	mcp-telegram; hiçbir Bot API sunucusu bunu yapamaz
Tepkiler, anketler veya hikâyeler istiyorsan	mcp-telegram — diğer ikisinde böyle araçlar yok
Ajanın senin adına bir kişiye yazmasını istiyorsan	Bir userbot sunucusu; bot, kendisini hiç başlatmamış birine yazamaz
Her şeyi kendi makinende bedavaya çalıştırmak istiyorsan	İki MIT projesinden herhangi biri, kendi sunucunda
İş “kanalıma gönder ve nasıl gittiğini söyle” ise	AdminHub’ın sunucusu — on dört araç, barındırılıyor, kendi botunla yayınlanıyor
Kişisel hesabın tamamen dışarıda kalmalıysa	Bot yolu; userbot’un hesabın kimlik bilgisi olmadığı bir modu yok
Telegram botun yoksa ve istemiyorsan	Bir userbot sunucusu; AdminHub çalışma alanında bot olmadan hiçbir şey yapmaz

Nereden başlamalı

Araç sayılarını karşılaştırmadan önce tek bir soruyu yanıtla: ajan kimin kimliğini kullanmalı?

Yanıt “benim, çünkü iş benim gelen kutum” ise userbot kategorisindesin ve oradaki seçim genişliğe karşı yüzey alanı. mcp-telegram sana 181 araç ve QR ile giriş veriyor; chaindead beş araç veriyor ve API kimlik bilgileri istiyor. İki README’yi de sonuna kadar oku — hizmet şartları satırı tek bir cümledir ve her iki dosyada da en çok yük taşıyan cümle odur.

Yanıt “bir botun kimliği, çünkü iş bir kanal” ise hesap sorusu hiç gündeme gelmez ve araç listesi bilerek kısadır. MCP sayfasından başla: ücretsiz plan bir bağlantı ve ayda otuz gönderi, ki bu da istatistiklerini okuyup senin yerine yayın yapan bir ajanın kalıcı bir akış olup olmadığını anlamaya yeter. Telegram’da yayının geri kalan resmi — zamanlanmış kuyruklar, RSS içe aktarımları, her seferinde istemek yerine bir kez kurduğun boru hatları — eksiksiz otomatik paylaşım rehberinde, ve botun kendisini kurmak henüz botun yoksa yaklaşık bir dakika sürüyor.

Emin değilsen de şunu not et: ikisi birbirini dışlamıyor. Kendi arşivin için dizüstü bilgisayarındaki bir userbot sunucusu ile yayın yaptığın kanal için barındırılan bir bot sunucusu, farklı işler için farklı araçlardır ve ikisini birden çalıştırmak gayet normal bir yanıttır.

Kaynaklar

Hepsi 7 Eylül 2026’da alındı. Araç sayısı, GramJS ve MTProto temeli, “kişisel hesap, bot değil” çerçevesi, QR ile giriş, kurulum yolları ve AUTH_KEY_DUPLICATED tek oturum notu: mcp-telegram deposu ve mcp-telegram.com. Beş araç, my.telegram.org’dan API ID ve hash gerekliliği, iki adımlı doğrulama parolası ve yukarıda alıntılanan Hizmet Şartları uyarısı: chaindead/telegram-mcp deposu. Bot API kapsamı ve BotFather token modeli: Telegram Bot API belgeleri. AdminHub rakamları — on dört araç, iki bağlantı yöntemi, Free ve Pro sınırları — bu sitedeki MCP sayfasından.