Server MCP Telegram untuk agen AI

Metricgram membungkus Telegram Bot API menjadi server MCP yang di-hosting, sehingga agen AI Anda dapat membaca, memposting, memoderasi, dan mengelola grup Telegram Anda dengan kunci berizin terbatas, tanpa kode bot yang perlu dirawat.

  • Lebih dari 70 metode Telegram Bot API sebagai tool MCP
  • Bekerja dengan Claude, ChatGPT, Cursor, dan Codex
  • Setiap panggilan terkunci pada grup milik Anda sendiri
  • Analitik, anggota, dan pelanggan dalam server yang sama
Tidak perlu kartu kredit Siap dalam 2 menit

Cara kerja

1

Tambahkan bot dan hubungkan grup Anda

Tambahkan bot Metricgram (atau bot kustom Anda sendiri) ke grup Telegram sebagai admin. Tidak ada server, webhook, atau polling yang perlu dijalankan.

2

Buat kunci API berizin terbatas

Buat kunci API Elite dan tentukan dengan tepat apa yang boleh dilakukan agen, mulai dari akses baca saja di Telegram hingga memposting, moderasi, dan pengaturan obrolan.

3

Pasang ke klien AI Anda

Tempel satu blok konfigurasi ke Claude, Cursor, Codex, atau klien MCP apa pun. Kini agen Anda melihat setiap aksi Telegram yang diizinkan sebagai tool.

Satu perintah, aksi nyata di Telegram

Agen Anda memilih panggilan Bot API yang tepat, Metricgram menjalankannya di grup yang benar dan mengembalikan hasil yang terstruktur.

metricgram · mcp

Anda meminta

Posting pengumuman AMA minggu ini di Crypto Talk, sematkan tanpa notifikasi, buka topik "Pertanyaan AMA", dan beri saya tautan undangan yang kedaluwarsa hari Jumat.

Agen memanggil

  • send_telegram_message(group_id: 42, text: "…", buttons: [{ url: "…" }])
  • pin_telegram_message(group_id: 42, action: "pin", disable_notification: true)
  • manage_forum_topic(group_id: 42, action: "create", name: "…")
  • create_telegram_invite_link(group_id: 42, expire_date: "2026-10-23T23:59:00Z")

Hubungkan klien MCP apa pun

Gunakan endpoint yang di-hosting dengan kunci API Anda. Pengguna Claude Desktop dapat menjembataninya dengan mcp-remote.

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

Tool yang didapat agen Anda

Pesan dan media

send_telegram_message send_telegram_media send_telegram_poll edit_telegram_message delete_telegram_messages forward_telegram_message react_to_telegram_message

Sematan dan topik forum

pin_telegram_message manage_forum_topic createForumTopic closeGeneralForumTopic unpinAllForumTopicMessages

Moderasi dan permintaan bergabung

ban_member restrict_member promote_member handle_telegram_join_request banChatSenderChat setChatAdministratorCustomTitle

Pengaturan obrolan dan tautan undangan

update_telegram_chat_settings create_telegram_invite_link revokeChatInviteLink setChatPermissions setChatStickerSet

Analitik dan data komunitas

analytics_overview active_users list_members list_messages gamification_rankings get_subscriber_health

Metode Bot API apa pun yang didukung

telegram_api_methods telegram_bot_api get_telegram_chat get_telegram_chat_member

Telegram Bot API, siap pakai untuk agen AI

Membangun integrasi Telegram untuk agen biasanya berarti meng-hosting bot, menangani webhook, menyimpan token, dan menulis tool untuk setiap endpoint. Metricgram sudah menjalankan bot di dalam grup Anda, sehingga agen Anda langsung mendapatkan Bot API sebagai tool MCP siap pakai dari satu endpoint yang di-hosting.
01

Tool bertipe ditambah gateway Bot API lengkap

Tugas umum seperti mengirim pesan, media, polling, sematan, topik, dan tautan undangan memiliki tool khusus dengan deskripsi yang jelas. Semua hal lainnya melewati telegram_bot_api, yang menerima nama metode dan parameter resmi Bot API, sehingga tidak ada yang berada di luar jangkauan dalam katalog yang didukung.
02

Terkunci pada grup Anda sendiri

Agen tidak pernah memilih chat_id. Metricgram menurunkannya dari grup yang Anda miliki, memeriksa pesan yang diteruskan dan dikutip terhadap grup Anda yang lain, dan menolak apa pun yang bisa menjangkau obrolan lain.
03

Izin untuk setiap tingkat kepercayaan

Berikan telegram:read untuk agen riset, telegram:write untuk memposting dan topik, telegram:moderate untuk ban dan permintaan bergabung, serta telegram:admin untuk gelar, izin, dan tautan undangan. Kunci dapat dicabut kapan saja.
04

Percobaan ulang yang aman dan error yang jelas

Tool penulisan menerima kunci idempotensi, sehingga panggilan yang diulang tidak pernah memposting dua kali. Error dan batas rate Telegram dikembalikan sebagai hasil terstruktur dengan retry_after, yang dapat ditangani agen sendiri.
05

Konteks yang tidak dimiliki bot biasa

Server yang sama menyediakan analitik Metricgram, riwayat anggota, pesan yang tersimpan, gamifikasi, ringkasan AI, dan kesehatan pelanggan Stripe, sehingga agen Anda dapat memutuskan apa yang harus dilakukan sebelum bertindak.

Metricgram vs. Manajemen Manual

Metricgram Manual
Endpoint MCP yang di-hosting, tanpa server bot
Lebih dari 70 metode Telegram Bot API sebagai tool
chat_id terkunci pada grup Anda sendiri
Kunci API per izin yang dapat Anda cabut
Percobaan ulang idempoten untuk tool penulisan
Analitik dan riwayat anggota sebagai konteks
Data obrolan langsung, admin, dan izin
Bekerja dengan bot kustom Anda sendiri

Pertanyaan yang Sering Diajukan

Apa itu server MCP Telegram?
Server Model Context Protocol yang menyediakan aksi Telegram sebagai tool yang dapat dipanggil agen AI. Metricgram meng-hosting server ini untuk Anda, didukung oleh bot yang sudah mengelola grup Anda.
Klien AI apa saja yang didukung?
Klien apa pun yang mendukung MCP melalui HTTP, termasuk Claude Code, Claude Desktop (melalui mcp-remote), Cursor, Codex, dan agen kustom yang dibangun dengan SDK OpenAI atau Anthropic.
Apakah mencakup seluruh Telegram Bot API?
Mencakup lebih dari 70 metode terkait grup, termasuk pesan, media, polling, pengeditan, reaksi, sematan, topik forum, moderasi, permintaan bergabung, pengaturan obrolan, dan tautan undangan. Metode yang dapat memengaruhi obrolan lain atau bot itu sendiri, seperti webhook, pembayaran, atau keluar dari grup, sengaja tidak disertakan.
Bisakah agen memposting di grup yang bukan milik saya?
Tidak. Setiap panggilan terikat pada salah satu grup Anda yang terhubung. chat_id ditetapkan oleh Metricgram, dan pesan yang diteruskan atau balasan hanya dapat merujuk ke grup Anda sendiri.
Apakah ini API pengguna Telegram (MTProto)?
Bukan. Server ini menggunakan Bot API resmi melalui bot grup Anda, sehingga agen bertindak sebagai bot, tidak pernah sebagai akun Telegram pribadi Anda.
Paket mana yang menyertakan server MCP?
Akses MCP dan API adalah bagian dari paket Elite. Uji coba gratis 14 hari memberikan akses setara Elite, sehingga Anda dapat menghubungkan agen sebelum membayar.
Bisakah saya membatasi apa yang boleh dilakukan agen?
Bisa. Setiap kunci API memiliki izinnya sendiri, dan Anda dapat membuat kunci terpisah untuk riset baca saja, memposting, moderasi, dan administrasi.

Mulai dalam hitungan menit

Hubungkan grup Telegram Anda dalam hitungan menit dan coba semua fitur gratis selama 14 hari.

Lihat harga