Telegram MCP sunucusu: Yapay zeka ajanlarına tam Telegram Bot API erişimini güvenle verin

Yapay zeka ajanları neden Telegram için bir köprüye ihtiyaç duyar?

Yapay zeka ajanları gerçek araçları kullanmakta giderek daha iyi hale geliyor. Bir paneli okuyabilir, neyin önemli olduğuna karar verebilir ve bir sonraki adımı atabilirler. Ancak Telegram içinde işlem yapabilmeleri için bir köprüye ihtiyaçları var: "AMA duyurusunu sabitle ve sorular için bir konu aç" gibi bir cümleyi doğru Telegram API çağrılarına dönüştüren bir katman.

Bu köprü bir Telegram MCP sunucusudur.

Model Context Protocol (MCP), Claude, ChatGPT, Cursor ve Codex gibi yapay zeka istemcilerinin araçları keşfetmesini ve çağırmasını sağlayan açık bir standarttır. Bir Telegram MCP sunucusu, Telegram işlemlerini modelin takip edebileceği net açıklamalar ve girdi şemalarıyla bu araçlar olarak sunar.

Metricgram artık bunu sizin için, gruplarınızı zaten yöneten bot üzerinden çalıştırıyor.

"Telegram Bot API'yi sarmalamak" gerçekte ne gerektirir?

Kağıt üzerinde Bot API'yi bir ajan için hazırlamak kolay görünür. Pratikte şunları yapmanız gerekir:

• Bir bot barındırmak, token'ını gizli tutmak ve sürekli çalışır durumda tutmak.
• Güncellemeleri webhook veya polling ile almak.
• Ajanın kullanmasını istediğiniz her uç nokta için bir araç tanımı yazmak.
• Ajanın asla dokunmaması gereken sohbetlere paylaşım yapmasını engellemek.
• Hız sınırlarını, taşınmış süper grupları ve Telegram hata mesajlarını yönetmek.
• Yeniden denemeleri güvenli hale getirmek, böylece kararsız bir ağ çağrısı aynı mesajı iki kez göndermez.
• Daha sonra açıklamanız gerekebileceği için ajanın ne yaptığını kaydetmek.

Çoğu ekip "mesaj gönder" adımında durur, çünkü geri kalan her şey ciddi bir altyapı işidir. Sonuç, konuşabilen ama bir topluluğu gerçekten yönetemeyen bir ajandır.

Metricgram Telegram MCP sunucusu nasıl çalışır?

Metricgram zaten Telegram gruplarınızda yönetici bot olarak (veya kendi özel botunuz olarak) bulunuyor. MCP sunucusu, yapay zeka istemcinizin bu botu barındırılan bir uç nokta üzerinden kullanmasını sağlar:

1. Gruplarınızı Metricgram'a bağlayın ve bota yönetici yetkisi verin.
2. Uç noktayı (https://metricgram.com/api/v1/mcp) yapay zeka istemcinize ekleyin, örneğin Claude'da özel bağlayıcı olarak.
3. OAuth ile oturum açın ve erişimi onaylayın. Hepsi bu: yönetmeniz gereken sunucu, webhook veya token yok. OAuth desteklemeyen istemciler bunun yerine aşağıdaki yapılandırmayla bir API anahtarı kullanabilir.

{
  "mcpServers": {
    "metricgram": {
      "url": "https://metricgram.com/api/v1/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Claude Desktop kullanıcıları aynı uç noktayı mcp-remote ile bağlayabilir. Her istemci için hazır kod parçacıkları Manager'ınızdaki MCP sayfasında yer alır.

70'ten fazla Bot API yöntemi, iki çağırma yolu

Sunucu, Telegram Bot API'yi iki katmanda sunar.

Günlük işler için tipli araçlar

Yaygın işlerin, modellerin doğru kullanmasını kolaylaştıran açıklayıcı parametrelere sahip özel araçları vardır:

• Konular, yanıtlar ve URL butonlarıyla send_telegram_message
• Fotoğraf, video, GIF, belge, ses ve çıkartmalar için send_telegram_media
• Anketler ve testler için send_telegram_poll
• edit_telegram_message, delete_telegram_messages, react_to_telegram_message
• pin_telegram_message ve forward_telegram_message
• Konu oluşturmak, yeniden adlandırmak, kapatmak, yeniden açmak veya silmek için manage_forum_topic
• Canlı sohbet verileri için get_telegram_chat ve get_telegram_chat_member
• handle_telegram_join_request, create_telegram_invite_link ve update_telegram_chat_settings

Tam bir Bot API geçidi

Geri kalan her şey telegram_bot_api üzerinden yapılır. Ajan resmi bir Bot API yöntem adını ve parametrelerini iletir; örneğin setChatPermissions, banChatSenderChat, editMessageMedia, hideGeneralForumTopic veya revokeChatInviteLink. Yardımcı araç telegram_api_methods, mevcut anahtarın kullanabileceği tüm yöntemleri listeler; böylece ajan neyin kullanılabilir olduğunu her zaman bilir.

Güvenlik: Ajan neden hiçbir zaman chat_id seçmez?

En önemli tasarım kararı, ajanın neleri yapamayacağıdır.

• Sohbet kilitlidir. Ajan bir Metricgram group_id değeri iletir. Sunucu, Telegram chat_id değerini sahip olduğunuz bir gruptan türetir ve diğer tüm sohbetleri reddeder.
• İletmeler ve alıntılar kontrol edilir. Bir mesaj yalnızca kendi gruplarınızdan iletilebilir, kopyalanabilir veya alıntılanabilir.
• Bot genelindeki işlemler hariç tutulur. Webhook'lar, ödemeler, bot profili değişiklikleri ve gruptan ayrılma sunulmaz.
• Butonlar güvenlidir. Satır içi butonlar URL açabilir veya metin kopyalayabilir, ancak bota callback tetikleyemez.
• Kapsamlar güvene göre ayrılır. telegram:read, telegram:write, telegram:moderate ve telegram:admin ayrıdır ve farklı yetkilere sahip birden fazla anahtar tutabilirsiniz.
• Yeniden denemeler idempotenttir. Yazma araçları bir idempotency_key kabul eder; böylece yeniden denenen bir çağrı işlemi ikinci kez yapmak yerine ilk sonucu döndürür.
• Her çağrı kaydedilir; kullanılan araç ve Bot API yöntemiyle birlikte.

Ajan, resmi Bot API üzerinden bot olarak hareket eder; asla kişisel Telegram hesabınız olarak değil.

Sıradan bir botta olmayan bağlam

Basit bir Bot API sarmalayıcısı işlem yapabilir ama pek bir şey göremez. Metricgram MCP sunucusu topluluk bilgilerini de sunar:

• Analitik özeti ve aktivite zaman serileri
• Aktif üyeler, üye geçmişi ve kaydedilen mesajlar
• Oyunlaştırma sıralamaları ve ödüller
• Grupta neler olduğuna dair yapay zeka özetleri
• Stripe abone sağlığı ve risk altındaki yenilemeler

Bu sayede bir ajan "bu ay kimler katılımı bıraktı?" sorusunu yanıtlayabilir ve ardından bu kişilere düşünceli bir mesaj gönderebilir; hepsi tek bir konuşmada.

Örnek iş akışları

Haftalık duyuru. "Haftalık AMA duyurusunu Crypto Talk'ta paylaş, herkese bildirim göndermeden sabitle, AMA soruları için bir konu aç ve cuma günü sona eren bir davet bağlantısı oluştur."

Moderasyon taraması. "Son 200 mesajı spam bağlantıları için kontrol et, bunları sil ve gönderenleri 24 saat boyunca kısıtla."

Topluluk raporu. "Bu haftanın aktivitesini geçen haftayla karşılaştır, en aktif beş üyeyi listele ve General konusunda kısa bir teşekkür mesajı paylaş."

Katılma isteklerini ayıklama. "Aktif abone olan kullanıcıların bekleyen katılma isteklerini onayla, geri kalanını reddet."

Kimler için?

• Rutin yönetim işlerini üstlenecek bir asistan isteyen topluluk sahipleri.
• Birçok müşteri grubunu yöneten ve hepsi için tek bir ajan isteyen ajanslar.
• Müşteri topluluklarını Telegram'da yürüten destek ve müşteri başarısı ekipleri.
• Bot altyapısı çalıştırmadan Telegram'ı ajan yığınlarına eklemek isteyen geliştiriciler.

Başlarken

MCP sunucusu her Metricgram planına ve 14 günlük ücretsiz denemeye dahildir; böylece ödeme yapmadan önce bir ajan bağlayabilirsiniz. Çoğu istemci OAuth ile bağlanır: sunucu URL'sini yapıştırın, oturum açın ve erişimi onaylayın. OAuth desteklemeyen istemciler için API anahtarları kullanılabilir olmaya devam ediyor.

Daha fazlası için Telegram MCP sunucusu sayfasına ve MCP özelliklerine genel bakışa göz atın, ardından Manager'dan ilk anahtarınızı oluşturun.