Lewati ke konten

Tambahkan server MCP perpustakaan Islam ke Claude Code

Satu perintah menambahkan server MCP Quran Gallery ke Claude Code: kitab klasik Arab, kutipan halaman cetak, tanpa akun dan tanpa kunci.

Di halaman ini

Tanpa akun, tanpa masuk, tanpa kunci. Satu perintah:

claude mcp add --transport http quran-gallery https://qurangallery.com/mcp/shamela

Langkah

  1. Jalankan perintah di atas di terminal Anda. Ia mendaftarkan server di cakupan lokal; tambahkan --scope user agar tersedia di setiap proyek, atau --scope project untuk dibagikan lewat .mcp.json.

  2. Jalankan claude mcp list, atau mulai claude lalu jalankan /mcp. quran-gallery semestinya tampil terhubung.

    Terminal: claude mcp add mendaftarkan quran-gallery, dan claude mcp list menampilkannya sebagai Connected.

  3. Ajukan pertanyaan yang memerlukan sebuah teks (di bawah). Claude Code meminta izin sebelum menjalankan setiap alat untuk pertama kalinya. Setujui.

Jawabannya memberikan setiap edisi beserta jilid, halaman cetak, dan tautan Maktabah, serta mengutip teks Arabnya:

Terminal: Claude Code menemukan hadis di Sahih al-Bukhari, edisi Sultaniyya, 1/6, dan di Sunan Ibn Majah, edisi al-Arnaut, 5/305, masing-masing dengan tautan shamela.ws dan teks Arabnya.

Untuk menghapusnya: claude mcp remove quran-gallery.

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. Jalankan /mcp dan sambungkan ulang server, atau mulai ulang claude; daftar alat dibaca saat server terhubung.
  • 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 dengan --header:

claude mcp add --transport http quran-gallery 
  https://qurangallery.com/mcp/shamela 
  --header "Authorization: Bearer qg_sk_your_key_here"

Perlakukan kunci seperti kata sandi dan jauhkan dari git.

Langkah berikutnya

Pertanyaan

Bagaimana menambahkan server MCP ke Claude Code?

Jalankan claude mcp add --transport http quran-gallery https://qurangallery.com/mcp/shamela di terminal. Tidak perlu akun, login, atau kunci.

Bagaimana memastikan server MCP terhubung di Claude Code?

Jalankan claude mcp list, atau mulai claude lalu jalankan /mcp. quran-gallery harus tampil terhubung. Jika alat tidak muncul, sambungkan ulang dari /mcp atau mulai ulang claude.

Bagaimana agar server tersedia di semua proyek?

Tambahkan --scope user pada perintah. Bawaannya cakupan lokal, dan --scope project membagikannya ke tim lewat .mcp.json.

Bagaimana menambahkan kunci API di Claude Code?

Tambahkan --header "Authorization: Bearer qg_sk_your_key_here" pada perintah claude mcp add. Kunci bersifat opsional dan menaikkan batas menjadi 60 panggilan per menit.

Mengapa muncul galat 429 Keyless limit reached?

Tanpa kunci diizinkan 10 panggilan alat per menit dan 200 per hari untuk tiap alamat IP. Tunggu sesuai header Retry-After atau tambahkan kunci gratis.

Bagaimana menghapus server dari Claude Code?

Jalankan claude mcp remove quran-gallery.

Edit halaman ini di GitHub