Gemini Telegram MCP - untuk Gemini dan CLI

Gemini CLI, cakupan pengguna

Jalur utama, dan yang biasanya dimaksud orang dengan Gemini MCP. Tambahkan server ke ~/.gemini/settings.json di bawah mcpServers dengan httpUrl yang mengarah ke endpoint yang di-hosting, mulai ulang CLI, dan tool tersedia di setiap proyek di mesin itu. Karena berupa HTTPS jarak jauh, tidak ada wrapper npx atau jembatan stdio yang perlu dijaga tetap hidup.

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

Gemini CLI, cakupan proyek

Blok yang sama di .gemini/settings.json di dalam repositori hanya berlaku untuk checkout itu. Berguna ketika satu repo adalah pipeline deploy yang mengumumkan rilis ke kanal Telegram, sementara pekerjaan Anda yang lain tidak perlu menyentuh chat. Konfigurasinya juga tersimpan di version control, tempat rekan tim bisa membacanya.

mkdir -p .gemini && $EDITOR .gemini/settings.json

Klien apa pun yang menjalankan model Gemini

Endpoint ini tidak bergantung pada model. Agen IDE, harness berbasis skrip, atau tool internal yang menjalankan Gemini di baliknya mendaftarkan Entergram sesuai format konfigurasi MCP masing-masing dan menerima daftar tool yang sama persis. Layar persetujuan milik Entergram, jadi siapa pun yang menjalankan klien memberi izin atas namanya sendiri, bukan mewarisi izin orang lain.

Tampilkan semua 78 alat dalam 9 kelompok →

• Mendaftarkan server tidak sama dengan memberi izin. Setiap mesin melewati layar persetujuan sendiri pada kali pertama, sehingga laptop baru atau container yang dibangun ulang membutuhkan browser setidaknya sekali.
• Workspace Entergram harus berada di paket Pro. Jika paketnya lebih rendah, CLI tetap menampilkan server lalu menerima penolakan dari setiap panggilan. Kelihatannya seperti konfigurasi rusak, padahal bukan.
• Tidak ada akun bawaan. Tool pesan membutuhkan account_id yang eksplisit, jadi setiap skrip harus mengambil daftar akun lebih dulu. Di chat hampir tidak terasa, di pipeline menjadi satu hal lagi yang harus diingat. Ambil sekali di awal skrip lalu teruskan ke bawah.
• Agen pribadi tidak bisa mengirim dan tidak bisa mengelola grup. Otomatisasi yang memposting catatan rilis atau membuat kanal membutuhkan konektor workspace yang diberi izin oleh owner atau admin.
• Protokolnya berbentuk permintaan dan respons, bukan langganan. Tidak ada yang masuk ke terminal Anda tanpa diminta; Gemini baru tahu ada pesan baru ketika sesuatu menyuruhnya melihat. Apa pun yang menyerupai pemantauan harus berupa tugas terjadwal milik Anda.
• CLI tidak menaikkan hak akses apa pun. Ia melihat persis chat yang dilihat akun Telegram Anda, dan grup yang sudah Anda tinggalkan adalah grup yang tidak bisa ia baca.

Server tidak pernah muncul di daftar MCP

Hampir selalu karena JSON yang rusak. Satu koma di akhir membuat CLI diam-diam mengabaikan seluruh file pengaturan. Validasi file-nya, pastikan kuncinya httpUrl untuk server HTTPS jarak jauh, bukan entri stdio berupa command dan args, dan periksa bahwa entri benar-benar berada di dalam mcpServers.

Perubahan di settings.json seolah tidak berpengaruh

Konfigurasi dibaca saat startup. Keluar dari sesi sepenuhnya lalu jalankan lagi. Proses yang sedang berjalan tetap memakai daftar tool yang dibuatnya saat diluncurkan, jadi file bisa saja benar tetapi terlihat diabaikan.

OAuth tidak bisa selesai di mesin tanpa layar

Layar persetujuan membutuhkan browser. Beri izin dari workstation yang bisa Anda lihat, atau teruskan port callback melalui SSH. Build agent tanpa layar tidak bisa menyelesaikan prosesnya sendiri.

Berfungsi di satu direktori, tidak di direktori lain

Anda punya dua file pengaturan. File di ~/.gemini berlaku di mana saja, file di .gemini dalam repositori hanya berlaku di sana. Periksa mana yang benar-benar berisi entri entergram sebelum mengedit hal lain.

Setiap panggilan mengembalikan 403

Periksa paket lebih dulu, lalu peran. Akses MCP membutuhkan Pro, dan apa pun di luar set cakupan agen pribadi membutuhkan hak owner atau admin di workspace Entergram.

Membaca berhasil, tetapi pengiriman ditolak

Itu batas agen pribadi, bukan error sementara. Pengiriman sama sekali tidak ada di set cakupannya, jadi mencoba ulang tidak akan membantu. Owner atau admin harus memberi izin konektor workspace, lalu Anda menjalankan ulang alur persetujuan untuk konektor itu.