Hubungkan Gemini CLI ke server MCP teks Islam
Tambahkan server MCP Quran Gallery ke Gemini CLI dengan satu perintah atau settings.json: kitab klasik Arab, kutipan halaman cetak, tanpa perlu kunci.
Di halaman ini
Tanpa akun, tanpa masuk, tanpa kunci. Satu perintah:
gemini mcp add --transport http quran-gallery https://qurangallery.com/mcp/shamelaLangkah
Jalankan perintah di atas di dalam folder proyek Anda. Perintah ini menulis server ke
.gemini/settings.jsondi folder itu. Tambahkan--scope useruntuk menulisnya ke~/.gemini/settings.json, sehingga berfungsi di setiap proyek.Jalankan
gemini mcp list.quran-gallerysemestinya tampil sebagai Connected.
Mulai
geminidan ajukan pertanyaan yang memerlukan sebuah teks (di bawah). Gemini CLI meminta izin sebelum setiap panggilan alat untuk pertama kalinya. Setujui.
Jawabannya memberikan edisi, jilid, dan halaman cetak, serta tautan ke halaman itu di pembaca Maktabah. Tautannya berbentuk https://qurangallery.com/maktabah/book/{bookId}/{pageId}, misalnya qurangallery.com/maktabah/book/1681/10 untuk Sahih al-Bukhari, sehingga halaman terbuka di Quran Gallery:

Untuk menghapusnya: gemini mcp remove quran-gallery.
Atau edit settings.json sendiri
Tambahkan server ke ~/.gemini/settings.json (semua proyek) atau .gemini/settings.json (satu proyek):
{
"mcpServers": {
"quran-gallery": {
"url": "https://qurangallery.com/mcp/shamela",
"type": "http"
}
}
}Inilah yang ditulis oleh perintah tadi. "httpUrl": "https://qurangallery.com/mcp/shamela" juga berfungsi. Pertahankan "type": "http" di samping url, karena Gemini CLI versi lama membaca url polos sebagai endpoint SSE.
Prompt pertama untuk dicoba
Carilah hadis «إنما الأعمال بالنيات» di kitab-kitab hadis primer dan beri tahu saya di kitab, edisi, jilid, dan halaman mana ia dicetak. Kutip teks Arabnya persis.
Asisten Anda semestinya memanggil shamela_search_library (atau search lalu fetch). Hasilnya mencakup صحيح البخاري, ط السلطانية, halaman 1/6, dengan tautan ke halaman itu di pembaca Maktabah. Bila ia menjawab dari memori, katakan: “Gunakan alat perpustakaan Quran Gallery dan kutip apa yang dikembalikannya.”
Kueri pencarian harus berbahasa Arab; asisten Anda menerjemahkan istilah berbahasa Indonesia lebih dulu (detail). Prompt siap pakai untuk takhrīj, mengutip kutipan, dan membandingkan tafsir tercantum di seluruh alat.
Pemecahan masalah
- 400, “schema at properties.transmission.items.items must be a boolean or an object”. Versi server kami sebelumnya mengirim skema alat yang ditolak Gemini API, dan setiap prompt gagal dengan galat ini. Masalahnya sudah diperbaiki. Mulai ulang
gemini. - 429, “Keyless limit reached”. Pemakaian tanpa kunci mengizinkan 10 panggilan alat per menit dan 200 per hari per alamat IP. Tunggu sesuai header
Retry-After, atau tambahkan kunci gratis (di bawah). Lihat Batas dan galat. - 503. Server atau perpustakaan di baliknya sementara tidak tersedia. Coba lagi setelah header
Retry-After. Bila klien menampilkan nol alat, tunggu semenit lalu sambungkan ulang. - Alat tidak muncul, atau alat yang Anda harapkan tidak ada. Mulai ulang
geminidan jalankan/mcp list. Daftar alat dibaca saat startup. gemini mcp listmenampilkan server sebagai Disabled, atau muncul “Gemini CLI is not running in a trusted directory”. Gemini CLI menonaktifkan server MCP di folder yang belum Anda percayai, dangemini mcp removejuga tidak menemukannya di sana. Bukageminisekali di folder itu dan percayai. Dalam skrip atau dengan-p, Anda bisa menyertakan--skip-trustsebagai gantinya.- Koneksi langsung gagal. Endpoint-nya
/mcp/shamela./mcpsaja adalah halaman web, bukan server.
Opsional: kunci gratis untuk batas lebih tinggi
Kunci tidak pernah wajib. Kunci gratis menaikkan batas menjadi 60 panggilan per menit dan mencabut batas rentang halaman tanpa kunci. Buat kunci di halaman Developers pada akun Quran Gallery Anda (cara kerja kunci), lalu kirim sebagai bearer token.
Tambahkan dengan --header (atau -H):
gemini mcp add --transport http quran-gallery
https://qurangallery.com/mcp/shamela
--header "Authorization: Bearer qg_sk_your_key_here"Di settings.json, kunci yang sama ditaruh dalam objek headers di samping url:
{
"mcpServers": {
"quran-gallery": {
"url": "https://qurangallery.com/mcp/shamela",
"type": "http",
"headers": { "Authorization": "Bearer qg_sk_your_key_here" }
}
}
}Jauhkan kunci dari berkas pengaturan apa pun yang Anda commit.