Hubungkan Cursor ke server MCP teks Islam
Tambahkan server MCP Quran Gallery ke Cursor lewat mcp.json: cari kitab klasik Arab dengan kutipan halaman cetak, tanpa perlu kunci.
Di halaman ini
Tanpa akun, tanpa masuk, tanpa kunci. Cursor membaca server MCP dari mcp.json.
Langkah
- Buka
~/.cursor/mcp.json(semua proyek) atau.cursor/mcp.jsondi sebuah proyek (hanya proyek itu). Buat berkasnya bila belum ada. - Tambahkan server:
{
"mcpServers": {
"quran-gallery": { "url": "https://qurangallery.com/mcp/shamela" }
}
}- Simpan. Cursor mendaftar server MCP di halaman Customize;
quran-gallerysemestinya tampil aktif beserta alat-alatnya. - Buka obrolan dalam mode Agent dan ajukan pertanyaan yang memerlukan sebuah teks (di bawah).
Halaman /mcp juga memiliki tombol pasang satu klik untuk Cursor.
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
- 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. Matikan lalu nyalakan lagi server di daftar MCP Cursor, atau mulai ulang Cursor; daftar alat di-cache per sesi.
- 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 entri headers:
{
"mcpServers": {
"quran-gallery": {
"url": "https://qurangallery.com/mcp/shamela",
"headers": { "Authorization": "Bearer qg_sk_your_key_here" }
}
}
}Jauhkan berkas yang memuat kunci dari git.