Cara Menghubungkan Google Gemini ke Chat Telegram Anda

Anda menghubungkan Google Gemini ke chat Telegram dengan mendaftarkan server MCP hosted milik Entergram, https://mcp.entergram.com/mcp, di Gemini CLI, lalu login ke Entergram satu kali di browser. Setelah itu, Gemini dapat membaca chat, kontak, dan data CRM Anda melalui akun Telegram pribadi Anda yang asli, serta bertindak atasnya dalam batas scope yang Anda berikan. Pengaturannya tiga langkah dan satu blok JSON kecil, seperti yang ditunjukkan di bawah.

Gemini CLI adalah jalur yang didokumentasikan lengkap di halaman Gemini Telegram MCP. Klien lain yang kompatibel dengan MCP dan menjalankan model Gemini dapat memakai URL yang sama, didaftarkan sesuai cara yang diharapkan klien tersebut.

• Workspace Pro. API & MCP adalah fitur paket Pro. Pada paket yang lebih rendah, CLI tetap akan menampilkan server, tetapi setiap panggilan akan ditolak. Ini terlihat seperti konfigurasi yang rusak, padahal bukan.
• Minimal satu akun Telegram yang terhubung di seat Anda. Konektor pribadi hanya dapat memakai akun Telegram yang tercantum di Settings → Accounts (Pengaturan → Akun) untuk member Anda sendiri.
• Browser di mesin tersebut untuk login pertama. Layar persetujuan membutuhkan browser, jadi server headless harus diotorisasi dari workstation terlebih dahulu.

Langkah 1: Salin URL MCP Anda di Entergram

Buka Settings → Workspace → Connectors → MCP (Pengaturan → Workspace → Konektor → MCP) dan salin URL server MCP. URL ini sama untuk setiap klien:

https://mcp.entergram.com/mcp

Langkah 2: Daftarkan server di Gemini CLI

Tambahkan Entergram di bawah mcpServers dalam ~/.gemini/settings.json. Karena servernya HTTPS jarak jauh, kuncinya adalah httpUrl, bukan entri berupa command dan args:

{
  "mcpServers": {
    "entergram": {
      "httpUrl": "https://mcp.entergram.com/mcp"
    }
  }
}

File di direktori home Anda berlaku untuk setiap proyek di mesin tersebut. Untuk membatasi akses Telegram ke satu repositori saja, letakkan blok yang sama di .gemini/settings.json di dalam repositori tersebut.

Langkah 3: Jalankan ulang CLI dan berikan otorisasi

CLI membaca konfigurasinya saat startup, jadi keluar sepenuhnya dari sesi lalu mulai lagi. Login ke Entergram di jendela browser yang terbuka dan berikan scope yang ingin Anda izinkan untuk Gemini. Tidak ada kredensial di dalam settings.json: file itu hanya menyebutkan lokasi server, dan akses berasal dari login OAuth tersebut.

Setelah diotorisasi, tampilkan daftar server MCP yang terdaftar di CLI, dan alat-alat Entergram akan muncul di bawah entergram.

Apa yang bisa dilakukan Gemini bergantung pada jenis klien yang Anda otorisasi, seperti dijelaskan di halaman bantuan konektor MCP:

Agen pribadi tidak bisa mengirim pesan Telegram. Jika pembacaan berhasil tetapi pengiriman ditolak, itu batas scope, bukan error. Owner atau admin harus mengotorisasi konektor workspace, lalu Anda menjalankan alur persetujuan lagi untuk konektor tersebut. Apa pun pilihannya, berikan kumpulan scope terkecil yang dibutuhkan tugas itu: messages.write memungkinkan agen mengirim pesan atas nama Anda.

Untuk memutus akses, cabut klien di Entergram melalui Settings → Workspace → Connectors → MCP. Menghapus entri mcpServers hanya menghentikan CLI memanggil server; tindakan itu tidak membatalkan izin yang sudah diberikan.

Server MCP Entergram terhubung ke akun Telegram pribadi Anda, bukan bot, sehingga Gemini bekerja dengan chat yang sama dengan yang Anda lihat. Prompt yang bekerja baik di CLI:

• "Chat mana yang punya pertanyaan belum terjawab dari tiga hari terakhir?"
• "Tampilkan kontak di grup pelanggan saya yang tidak ada di grup komunitas."
• "Posting catatan rilis dari CHANGELOG.md ke channel beta." (butuh konektor workspace)
• "Saya salah ketik nomor versi di pengumuman itu, perbaiki." (butuh konektor workspace)
• "Berikan jumlah tiket minggu ini per penanggung jawab dalam format TSV."

CLI menampilkan setiap panggilan alat yang dilakukannya, sehingga Anda bisa mengamati mekanismenya pada tugas baca-saja sebelum memercayakan tugas penulisan.

• Alat pesan membutuhkan akun yang eksplisit. Tidak ada default implisit, jadi skrip harus mengambil daftar akun terlebih dahulu lalu meneruskan id akun.
• Tidak ada yang datang tanpa diminta. MCP bekerja dengan pola permintaan dan respons. Gemini baru tahu tentang pesan baru ketika Anda, atau tugas terjadwal milik Anda, memintanya memeriksa.
• Tidak ada akses yang ditingkatkan. Gemini melihat persis apa yang dilihat akun Telegram Anda yang terhubung. Grup yang sudah Anda tinggalkan adalah grup yang tidak bisa dibacanya, dan chat yang Anda kecualikan di Accounts → Exclude chats (Akun → Kecualikan chat) tetap berada di luar hasil MCP.

• Server tidak pernah muncul di daftar MCP. Biasanya karena JSON yang salah format: satu koma berlebih di akhir membuat CLI mengabaikan seluruh file pengaturan. Pastikan entri memakai httpUrl dan berada di dalam mcpServers.
• Perubahan di settings.json seolah tidak berpengaruh. Keluar dari sesi sepenuhnya lalu jalankan ulang. Proses yang sedang berjalan tetap memakai daftar alat yang dibuatnya saat startup.
• Berfungsi di satu direktori tetapi tidak di direktori lain. Anda punya dua file pengaturan. Periksa apakah entri entergram berada di ~/.gemini atau di folder .gemini milik sebuah repositori.
• Setiap panggilan mengembalikan 403. Periksa paket terlebih dahulu (MCP butuh Pro), lalu peran: apa pun di luar kumpulan scope agen pribadi membutuhkan owner atau admin.

Server MCP Entergram sama untuk setiap klien. Atur sekali, lalu Anda bisa menghubungkan klien AI mana pun yang Anda sukai, atau beberapa sekaligus:

• Hubungkan Claude ke Telegram melalui Entergram
• Hubungkan ChatGPT ke Telegram melalui Entergram
• Hubungkan alat AI apa pun ke Telegram MCP

Untuk daftar lengkap alat Gemini, contoh cakupan proyek, dan tugas terjadwal, lihat halaman Gemini Telegram MCP. Untuk apa yang dilakukan server ini di setiap klien, mulailah dari halaman server Telegram MCP.