Lewati ke konten

Hubungkan ChatGPT ke Maktabah Syamilah

Tambahkan server MCP Quran Gallery ke ChatGPT dengan tangkapan layar: satu URL, No authentication, lalu cari 8.594 kitab klasik, kutipan berhalaman cetak.

Di halaman ini

Tanpa akun, tanpa masuk, tanpa kunci. Tambahkan URL ini ke ChatGPT sebagai server MCP kustom dan atur Authentication ke No authentication:

https://qurangallery.com/mcp/shamela

Pengaturannya memakan waktu sekitar satu menit. Cara ini berhasil di akun ChatGPT Free saat panduan ini ditulis (Oktober 2026). Pada workspace Business atau Enterprise, admin mungkin harus mengizinkan server MCP kustom lebih dulu.

1. Buka Plugins dan tambahkan server kustom

Buka chatgpt.com/plugins. Di kanan atas, klik Add, lalu Add custom MCP server.

Menu Add di kanan atas halaman ChatGPT Plugins: Create plugin, Upload plugin archive, Add custom MCP server.

2. Isi formulir

KolomIsi
Icon (optional)quran-gallery-icon.png: unduh, lalu klik + dan pilih berkasnya
NameQuran Gallery
Description (optional)Search classical Arabic Islamic books with printed-page citations
ConnectionBiarkan Server URL terpilih dan tempel https://qurangallery.com/mcp/shamela
AuthenticationNo authentication

Centang I understand and want to continue, lalu klik Create as a plugin.

Dialog Add custom MCP server yang sudah terisi: ikon, nama, dan deskripsi Quran Gallery, Server URL https://qurangallery.com/mcp/shamela, Authentication diatur ke No authentication, dan kotak I understand tercentang.

Ketik URL sendiri atau salin dari halaman ini. Tautan yang disalin dari email bisa berupa pengalihan google.com/url?q=…, bukan alamat aslinya, dan ChatGPT menolaknya.

3. Connect

ChatGPT menampilkan apa saja yang boleh dilakukan plugin. Klik Connect. Sebuah pesan mengonfirmasi Quran Gallery is now connected.

Layar Connect Quran Gallery dengan tombol Connect.

4. Pastikan sudah terpasang

Buka Settings → Plugins. Quran Gallery muncul dalam daftar beserta ikonnya. Semua alatnya bersifat hanya-baca.

Pengaturan plugin ChatGPT, dengan Quran Gallery dalam daftar plugin yang terpasang.

5. Pakai dalam obrolan

Mulai obrolan baru. Klik + di kotak pesan dan pilih Quran Gallery. Setelah itu ajukan pertanyaan Anda.

Menu + pada obrolan ChatGPT baru, dengan Quran Gallery dalam daftar.

Jawabannya menyebut edisi, jilid, dan halaman cetak, serta menautkan ke halaman itu di pembaca Maktabah:

Jawaban ChatGPT yang memakai Quran Gallery: Sahih al-Bukhari, edisi Sultaniyya, jilid 1 halaman 6, hadis 1, dengan tautan ke halaman di Shamela.

Kelola, segarkan, atau hapus

Buka Settings → Plugins dan klik Quran Gallery. Di bawah Manage app Anda bisa mengganti nama, menjalankan Refresh tools setelah server kami menambah alat, atau memilih Delete app.

Bagian Manage app pada plugin: App name, App description, Refresh tools, dan Delete app.

URL server dan ikon tidak bisa diubah setelah plugin dibuat. Untuk mengubah salah satunya, hapus plugin lalu tambahkan lagi.

Deep research

ChatGPT deep research dan company knowledge memerlukan dua alat hanya-baca bernama search dan fetch. Server ini menyediakan keduanya, dan menampilkannya kepada semua klien bersama alat lainnya. search menerima satu kueri dan mengembalikan results berisi id, title, dan url; fetch menerima sebuah id dan mengembalikan id, title, text, url, dan metadata. url setiap hasil adalah halaman di pembaca Maktabah.

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

  • “Some app settings were rejected. Check the server URL or tunnel ID, icon, and authentication settings.” Periksa tiga hal. URL harus persis https://qurangallery.com/mcp/shamela, bukan tautan pengalihan dari email. Authentication harus No authentication. Ikon harus berupa PNG minimal 256×256 piksel dan di bawah 10 KB; ikon kami memenuhi syarat itu, atau Anda boleh tidak memakai ikon. Bila Anda mencoba sebelum perbaikan kami, tambahkan server itu lagi.
  • “Couldn’t discover OAuth settings.” Authentication dibiarkan pada OAuth. Ubah ke No authentication.
  • “An app with this name already exists.” Anda pernah menambahkannya. Hapus plugin lama terlebih dahulu (lihat Kelola, segarkan, atau hapus), atau pilih nama lain.
  • Create as a plugin tidak merespons. Centang dulu kotak I understand and want to continue.
  • Tidak ada halaman Plugins atau tidak ada Add custom MCP server. Akun lama mencapai formulir yang sama lewat Settings → Apps & Connectors → Advanced settings → Developer mode → Create. Gunakan URL yang sama dan No authentication. Pada akun kerja, minta admin workspace Anda mengizinkan server MCP kustom.
  • 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. Lihat Batas dan galat.
  • 503. Server atau perpustakaan di baliknya sementara tidak tersedia. Coba lagi setelah header Retry-After. Bila plugin menampilkan nol alat, tunggu semenit lalu klik Refresh tools.
  • Alat tidak muncul, atau alat yang Anda harapkan tidak ada. ChatGPT membaca daftar alat saat Anda membuat plugin. Klik Refresh tools, lalu mulai percakapan baru.
  • 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. Formulir server kustom ChatGPT hanya menawarkan OAuth atau tanpa autentikasi, tanpa kolom untuk header bearer, sehingga ChatGPT tetap berada pada tingkat tanpa kunci. Bila Anda membutuhkan kunci, gunakan Claude, Claude Code, Cursor, VS Code, atau Gemini CLI. Buat kunci di halaman Developers pada akun Quran Gallery Anda (cara kerja kunci).

Langkah berikutnya

Edit halaman ini di GitHub