Lewati ke konten

Hubungkan Claude ke perpustakaan Islam (MCP)

Tambahkan server MCP Quran Gallery ke Claude sebagai konektor kustom, dengan tangkapan layar. Tanpa akun, tanpa kunci, 8.594 karya Arab klasik.

Di halaman ini

Tanpa akun, tanpa masuk, tanpa kunci. Di Claude, tambahkan satu konektor kustom dengan URL ini:

https://qurangallery.com/mcp/shamela

Langkahnya sama di claude.ai dan di Claude Desktop. Paket gratis dapat menambahkan satu konektor kustom. Pada paket Team dan Enterprise, seorang Owner menambahkannya di Organization settings → Connectors, lalu setiap anggota mengaktifkannya.

1. Buka Connectors dan tambahkan konektor kustom

Buka Settings → Connectors (claude.ai/settings/connectors). Pada sebagian versi, menunya ada di Customize → Connectors. Klik + Add, lalu Add custom connector.

Pengaturan Connectors di Claude dengan menu Add terbuka pada Add custom connector.

2. Beri nama dan tempel URL

Beri nama Quran Gallery, tempel https://qurangallery.com/mcp/shamela, lalu klik Continue.

Dialog Add custom connector dengan nama Quran Gallery dan URL https://qurangallery.com/mcp/shamela.

3. Biarkan No sign-in, lalu tambahkan dan hubungkan

Claude memeriksa server dan memilih No sign-in, ditandai Detected. Biarkan tetap terpilih. Abaikan bagian Request headers kecuali Anda memiliki kunci (lihat bagian akhir halaman ini). Klik Add, lalu Connect. Sebuah pesan mengonfirmasi Connected to Quran Gallery.

Langkah Authentication: Sign in now, Sign in when needed, dan No sign-in terpilih dengan lencana Detected.

4. Pilih kapan Claude boleh memakai alat

Halaman konektor mencantumkan 15 alat hanya-baca, yang secara bawaan diatur ke Needs approval. Biarkan begitu untuk menyetujui setiap panggilan, atau atur Read-only tools ke Always allow untuk melewati permintaan persetujuan.

Halaman konektor Quran Gallery: alat-alat hanya-bacanya, diatur ke Needs approval.

5. Aktifkan dalam obrolan

Dalam obrolan, klik +, buka Connectors, lalu aktifkan Quran Gallery.

Menu + pada obrolan Claude, submenu Connectors, dengan Quran Gallery diaktifkan.

6. Bertanya, dan setujui panggilan pertama

Saat Claude pertama kali memakai sebuah alat, ia meminta izin. Klik Allow once, atau Always allow untuk alat tersebut.

Claude meminta izin memakai Identify a cited work dari Quran Gallery, dengan pilihan Decline, Always allow, dan Allow once.

Jawabannya menyebut setiap edisi cetak beserta jilid dan halamannya:

Jawaban Claude yang memakai Quran Gallery: Sahih al-Bukhari hadis 1, dicetak dalam edisi Sultaniyya di jilid 1 halaman 6 dan dalam edisi al-Bugha di jilid 1 halaman 3.

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 konektor menampilkan nol alat, tunggu semenit lalu segarkan daftar alat.
  • Alat tidak muncul, atau alat yang Anda harapkan tidak ada. Di halaman konektor, buka menu ⋮ dan pilih Refresh tools list, lalu mulai obrolan baru.
  • Claude menjawab tanpa perpustakaan. Pastikan konektor diaktifkan untuk obrolan ini (langkah 5), dan minta Claude memakai alat Quran Gallery.
  • 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).

Tambahkan kunci pada langkah 3. Biarkan No sign-in tetap terpilih, dan di bawah Request headers tambahkan header bernama Authorization dengan nilai Bearer qg_sk_your_key_here. Gunakan kunci Anda sendiri sebagai pengganti placeholder. Bila konektor sudah ada, hapus lewat menu ⋮ lalu tambahkan lagi dengan header tersebut.

Langkah berikutnya

Edit halaman ini di GitHub