Server MCP Telegram: Beri Agen AI Akses Penuh ke Telegram Bot API dengan Aman

Mengapa Agen AI Butuh Jembatan ke Telegram

Agen AI makin piawai mengoperasikan tool sungguhan. Mereka bisa membaca dashboard, memutuskan apa yang penting, lalu mengambil langkah berikutnya. Tetapi untuk bertindak di dalam Telegram, mereka butuh jembatan: sesuatu yang mengubah kalimat seperti "sematkan pengumuman AMA dan buka topik pertanyaan" menjadi panggilan Telegram API yang tepat.

Jembatan itu adalah server MCP Telegram.

Model Context Protocol (MCP) adalah standar terbuka yang memungkinkan klien AI seperti Claude, ChatGPT, Cursor, dan Codex menemukan tool dan memanggilnya. Server MCP Telegram menyediakan aksi Telegram sebagai tool tersebut, lengkap dengan deskripsi yang jelas dan skema input yang bisa diikuti model.

Kini Metricgram menjalankan server tersebut untuk Anda, didukung oleh bot yang sudah mengelola grup Anda.

Apa Sebenarnya Arti "Membungkus Telegram Bot API"

Di atas kertas, membungkus Bot API untuk agen terdengar mudah. Dalam praktiknya, Anda perlu:

• Meng-hosting bot, menjaga tokennya tetap rahasia, dan memastikannya terus berjalan.
• Menerima update melalui webhook atau polling.
• Menulis definisi tool untuk setiap endpoint yang ingin digunakan agen.
• Mencegah agen memposting ke obrolan yang seharusnya tidak pernah disentuhnya.
• Menangani batas rate, supergrup yang dimigrasi, dan pesan error Telegram.
• Membuat percobaan ulang aman, agar satu panggilan jaringan yang gagal tidak memposting pesan yang sama dua kali.
• Mencatat apa yang dilakukan agen, untuk berjaga-jaga jika Anda perlu menjelaskannya nanti.

Sebagian besar tim berhenti di "kirim pesan" karena sisanya membutuhkan banyak pekerjaan infrastruktur. Hasilnya adalah agen yang bisa bicara, tetapi tidak benar-benar bisa mengelola komunitas.

Cara Kerja Server MCP Telegram Metricgram

Metricgram sudah berada di dalam grup Telegram Anda sebagai bot admin (atau sebagai bot kustom Anda sendiri). Server MCP cukup memungkinkan klien AI Anda menggunakan bot tersebut melalui endpoint yang di-hosting:

1. Hubungkan grup Anda ke Metricgram dan berikan hak admin kepada bot.
2. Tambahkan endpoint https://metricgram.com/api/v1/mcp ke klien AI Anda, misalnya sebagai konektor kustom di Claude.
3. Masuk dan setujui akses dengan OAuth. Selesai: tanpa server, webhook, atau token yang harus dikelola. Klien tanpa OAuth dapat memakai kunci API dengan konfigurasi di bawah.

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

Pengguna Claude Desktop dapat menjembatani endpoint yang sama dengan mcp-remote. Cuplikan konfigurasi persis untuk setiap klien tersedia di halaman MCP pada Manager Anda.

Lebih dari 70 Metode Bot API, Dua Cara Memanggilnya

Server ini menyediakan Telegram Bot API dalam dua lapisan.

Tool Bertipe untuk Pekerjaan Sehari-hari

Tugas umum memiliki tool khusus dengan parameter deskriptif, sehingga model mudah menggunakannya dengan benar:

• send_telegram_message dengan topik, balasan, dan tombol URL
• send_telegram_media untuk foto, video, GIF, dokumen, audio, dan stiker
• send_telegram_poll untuk polling dan kuis
• edit_telegram_message, delete_telegram_messages, react_to_telegram_message
• pin_telegram_message dan forward_telegram_message
• manage_forum_topic untuk membuat, mengganti nama, menutup, membuka kembali, atau menghapus topik
• get_telegram_chat dan get_telegram_chat_member untuk data obrolan langsung
• handle_telegram_join_request, create_telegram_invite_link, dan update_telegram_chat_settings

Gateway Bot API Lengkap

Semua hal lainnya melewati telegram_bot_api. Agen meneruskan nama metode resmi Bot API beserta parameternya, misalnya setChatPermissions, banChatSenderChat, editMessageMedia, hideGeneralForumTopic, atau revokeChatInviteLink. Tool pendamping telegram_api_methods menampilkan setiap metode yang dapat digunakan oleh kunci saat ini, sehingga agen selalu tahu apa yang tersedia.

Keamanan: Mengapa Agen Tidak Pernah Memilih chat_id

Keputusan desain terpenting adalah apa yang tidak bisa dilakukan agen.

• Obrolan terkunci. Agen meneruskan group_id Metricgram. Server menurunkan chat_id Telegram dari grup yang Anda miliki dan menolak obrolan lain.
• Penerusan dan kutipan diperiksa. Pesan hanya bisa diteruskan, disalin, atau dikutip dari grup Anda sendiri.
• Aksi tingkat bot dikecualikan. Webhook, pembayaran, perubahan profil bot, dan keluar dari grup tidak disediakan.
• Tombol aman. Tombol inline dapat membuka URL atau menyalin teks, tetapi tidak dapat memicu callback ke bot.
• Izin sesuai tingkat kepercayaan. telegram:read, telegram:write, telegram:moderate, dan telegram:admin terpisah, dan Anda bisa memiliki beberapa kunci dengan kewenangan berbeda.
• Percobaan ulang bersifat idempoten. Tool penulisan menerima idempotency_key, sehingga panggilan yang diulang mengembalikan hasil pertama alih-alih bertindak dua kali.
• Setiap panggilan dicatat beserta tool dan metode Bot API yang digunakan.

Agen bertindak sebagai bot melalui Bot API resmi, tidak pernah sebagai akun Telegram pribadi Anda.

Konteks yang Tidak Dimiliki Bot Biasa

Pembungkus Bot API biasa bisa bertindak, tetapi tidak bisa melihat banyak. Server MCP Metricgram juga menyediakan kecerdasan komunitas:

• Ringkasan analitik dan deret waktu aktivitas
• Anggota aktif, riwayat anggota, dan pesan yang tersimpan
• Peringkat dan hadiah gamifikasi
• Ringkasan AI tentang apa yang terjadi di grup
• Kesehatan pelanggan Stripe dan perpanjangan yang berisiko

Artinya, agen dapat menjawab "siapa yang berhenti berpartisipasi bulan ini?" lalu mengirimi mereka pesan yang penuh perhatian, semuanya dalam satu percakapan.

Contoh Alur Kerja

Pengumuman mingguan. "Posting pengumuman AMA mingguan di Crypto Talk, sematkan tanpa memberi notifikasi ke semua orang, buka topik pertanyaan AMA, dan buat tautan undangan yang kedaluwarsa hari Jumat."

Sapu bersih moderasi. "Periksa 200 pesan terakhir untuk mencari tautan spam, hapus, dan batasi pengirimnya selama 24 jam."

Laporan komunitas. "Bandingkan aktivitas minggu ini dengan minggu lalu, tampilkan lima anggota paling aktif, dan posting pesan terima kasih singkat di topik General."

Penyaringan permintaan bergabung. "Setujui permintaan bergabung yang tertunda dari pengguna yang merupakan pelanggan aktif dan tolak sisanya."

Untuk Siapa Server Ini

• Pemilik komunitas yang menginginkan asisten untuk menangani pekerjaan admin rutin.
• Agensi yang mengelola banyak grup klien dan menginginkan satu agen untuk semuanya.
• Tim dukungan dan customer success yang menjalankan komunitas pelanggan di Telegram.
• Developer yang ingin Telegram ada di dalam stack agen mereka tanpa menjalankan infrastruktur bot.

Cara Memulai

Server MCP sudah termasuk dalam setiap paket Metricgram dan dalam uji coba gratis 14 hari, sehingga Anda dapat menghubungkan agen sebelum membayar. Sebagian besar klien terhubung dengan OAuth: tempel URL server, masuk, lalu setujui akses. Kunci API tetap tersedia untuk klien yang tidak mendukung OAuth.

Baca selengkapnya di halaman server MCP Telegram dan ringkasan fitur MCP, lalu buat kunci pertama Anda dari Manager.