Lewati ke konten

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

  1. Buka ~/.cursor/mcp.json (semua proyek) atau .cursor/mcp.json di sebuah proyek (hanya proyek itu). Buat berkasnya bila belum ada.
  2. Tambahkan server:
{
	"mcpServers": {
		"quran-gallery": { "url": "https://qurangallery.com/mcp/shamela" }
	}
}
  1. Simpan. Cursor mendaftar server MCP di halaman Customize; quran-gallery semestinya tampil aktif beserta alat-alatnya.
  2. 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; /mcp saja 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.

Langkah berikutnya

Edit halaman ini di GitHub