Lewati ke konten

Hubungkan AI ke Maktabah Syamilah: panduan memulai

Tambahkan server MCP Quran Gallery ke ChatGPT, Claude, Cursor, VS Code, atau Gemini CLI lewat URL. Tanpa akun atau kunci. Jalankan pencarian pertama Anda.

Di halaman ini

Tempel satu URL ke asisten Anda lalu ajukan pertanyaan. Tidak perlu akun maupun kunci untuk memulai; kunci gratis menaikkan batas saat Anda membutuhkannya.

1. Tambahkan server

Server berbicara MCP lewat streamable HTTP di:

https://qurangallery.com/mcp/shamela

URL itu saja sudah cukup bagi klien. Tempat menempelkannya bergantung pada aplikasi:

Anda memakaiTempat URL ditempelkanPanduan
ChatGPTPlugins → Add → Add custom MCP server, Authentication No authenticationLangkah demi langkah, dengan tangkapan layar
Claude (claude.ai, Claude Desktop)Settings → Connectors → + Add → Add custom connectorLangkah demi langkah, dengan tangkapan layar
Claude CodeSatu perintah terminalClaude Code
Gemini CLISatu perintah terminalGemini CLI
Cursor~/.cursor/mcp.jsonCursor
VS Code, GitHub Copilot.vscode/mcp.jsonVS Code, Copilot

ChatGPT: buka ChatGPT Plugins, klik Add → Add custom MCP server, beri nama Quran Gallery dan tempel URL. Atur Authentication ke No authentication, karena kolom itu awalnya diatur ke OAuth dan gagal di sana. Centang I understand and want to continue, klik Create as a plugin, lalu Connect. Akun lama memakai Settings → Apps & Connectors → Advanced settings → Developer mode → Create. Langkah demi langkah.

Claude (claude.ai dan Claude Desktop): buka Settings → Connectors (pada sebagian versi: Customize → Connectors), klik + Add → Add custom connector, beri nama Quran Gallery, tempel URL, lalu klik Continue. Biarkan No sign-in, klik Add, lalu Connect. Aktifkan untuk sebuah obrolan dari + → Connectors. Langkah demi langkah.

Claude Code (detail):

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

Gemini CLI (detail):

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

Cursor (detail) — di ~/.cursor/mcp.json:

{
	"mcpServers": {
		"quran-gallery": { "url": "https://qurangallery.com/mcp/shamela" }
	}
}

VS Code dan GitHub Copilot (VS Code, Copilot) — di .vscode/mcp.json:

{
	"servers": {
		"quran-gallery": { "type": "http", "url": "https://qurangallery.com/mcp/shamela" }
	}
}

Berkas konfigurasi Claude Desktop: Claude Desktop tidak tersambung ke server jarak jauh yang ditulis di claude_desktop_config.json sebagai entri "url", jadi konfigurasi yang disalin dari blok Cursor di atas gagal di sana. Tambahkan server lewat Settings → Connectors (Claude). Bila Anda memerlukan berkas konfigurasi, jalankan melalui jembatan mcp-remote, yang memerlukan Node.js:

{
	"mcpServers": {
		"quran-gallery": {
			"command": "npx",
			"args": ["-y", "mcp-remote", "https://qurangallery.com/mcp/shamela"]
		}
	}
}

Simpan berkas lalu mulai ulang Claude Desktop.

Nama menu berpindah-pindah antarrilis. Bila milik Anda berbeda, cari connectors, integrations, atau MCP servers di pengaturan klien — klien apa pun yang menerima URL MCP jarak jauh bisa dipakai.

Gunakan path lengkap, /mcp/shamela. /mcp saja adalah halaman yang menjelaskan server, bukan endpoint-nya, dan mengarahkan klien ke sana tidak akan berhasil.

2. Ajukan pertanyaan

Mulai ulang klien Anda bila diminta, lalu ajukan pertanyaan yang memerlukan sebuah teks:

Carilah hadis “إنما الأعمال بالنيات” di kitab-kitab hadis primer dan beri tahu saya persis di halaman cetak mana ia berada.

Asisten Anda semestinya memanggil shamela_search_library, dan jawabannya harus menyebut kitab, cetakan, dan halaman — untuk hadis tersebut, صحيح البخاري, ط السلطانية, halaman 1/6.

Bila ia menjawab dari memori alih-alih memanggil alat, katakan langsung: “Gunakan alat perpustakaan Quran Gallery dan kutip halaman cetak yang dikembalikannya.”

3. Periksa koneksi

Klien Anda semestinya menampilkan 15 alat, diawali shamela_search_library (lihat seluruh alat). Bila tidak ada satu pun, server tidak terjangkau — lihat Batas dan galat.

Anda juga bisa memeriksa secara manual:

curl -X POST https://qurangallery.com/mcp/shamela 
  -H "Content-Type: application/json" 
  -H "Accept: application/json, text/event-stream" 
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Ia mengembalikan objek JSON berisi daftar alat, shamela_search_library pertama. Tanpa kunci, menampilkan daftar alat tidak memakai jatah panggilan alat Anda.

4. Opsional: tambahkan kunci untuk batas lebih tinggi

Tanpa kunci Anda mendapat 10 panggilan alat per menit dan 200 per hari per alamat IP, dan dua pembaca rentang halaman mengembalikan beberapa halaman per panggilan (lihat Batas dan galat). Itu cukup untuk mencoba server dan pencarian sesekali. Untuk sesi riset, atau apa pun yang Anda bangun di atasnya, tersedia kunci gratis: 60 panggilan per menit, tanpa batas harian, rentang halaman penuh. Lewati bagian ini sampai Anda menyentuh batas.

Masuk ke akun Quran Gallery Anda, buka Developers, dan buat kunci dengan nama yang deskriptif.

Kunci lengkap ditampilkan sekali, saat dibuat. Salin saat itu — setelahnya hanya beberapa karakter pertama yang terlihat. Bentuk kuncinya:

qg_sk_ghjKm4x…

sk berarti secret key (kunci rahasia). Perlakukan persis seperti kata sandi: ia mengautentikasi sebagai Anda, simpan di pengelola kata sandi atau penyimpanan rahasia, dan jangan pernah di-commit ke git atau ditempel di isu publik.

Kirim sebagai bearer token pada setiap permintaan. Di berkas konfigurasi:

{
	"mcpServers": {
		"quran-gallery": {
			"type": "http",
			"url": "https://qurangallery.com/mcp/shamela",
			"headers": { "Authorization": "Bearer qg_sk_your_key_here" }
		}
	}
}

Atau dengan Claude Code:

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

Kunci hanya berjalan lewat Authorization: Bearer … — tanpa parameter query, tanpa alur OAuth. Klien yang hanya menerima URL polos tetap berada pada batas tanpa kunci.

Rincian lengkap membuat, merotasi, dan mencabut kunci ada di Kunci API.

Langkah berikutnya

Pertanyaan

Bagaimana menyambungkan asisten AI ke perpustakaan Shamela?

Tempel https://qurangallery.com/mcp/shamela ke aplikasi yang menerima server MCP jarak jauh, seperti ChatGPT, Claude, Claude Code, Gemini CLI, Cursor, VS Code, atau GitHub Copilot, lalu ajukan pertanyaan yang membutuhkan teks.

Apakah perlu akun atau kunci API?

Tidak. Kunci gratis bersifat opsional dan menaikkan batas menjadi 60 panggilan per menit bila diperlukan.

Bagaimana menambahkan server ke ChatGPT?

Buka ChatGPT Plugins, pilih Add lalu Add custom MCP server, beri nama Quran Gallery, tempel URL, dan atur Authentication ke No authentication.

Bagaimana menambahkan server ke Claude?

Buka Settings, lalu Connectors, pilih Add lalu Add custom connector, beri nama Quran Gallery, tempel URL, biarkan No sign-in, lalu klik Add dan Connect.

Bagaimana memastikan sambungan berfungsi?

Klien Anda harus menampilkan 15 alat, diawali shamela_search_library. Tanyakan sebuah hadis di kumpulan primer, dan jawabannya harus menyebut kitab, edisi, dan halaman.

Mengapa asisten saya menjawab dari ingatan?

Katakan langsung: gunakan alat perpustakaan Quran Gallery dan kutip halaman cetak yang dikembalikannya.

Berapa batas gratisnya?

Tanpa kunci, 10 panggilan alat per menit dan 200 per hari per alamat IP. Dengan kunci gratis, 60 per menit tanpa batas harian.

Edit halaman ini di GitHub