İçeriğe geç
Search docs
Search docs…

Bir yapay zekâyı Şamile kütüphanesine bağlayın: başlangıç

Quran Gallery MCP sunucusunu ChatGPT, Claude, Cursor, VS Code veya Gemini CLI'a URL ile ekleyin. Hesap ve anahtar gerekmez. İlk kaynaklı aramanızı yapın.

Bu sayfada

Asistanınıza tek bir URL yapıştırın ve bir soru sorun. Başlamak için hesap ve anahtar gerekmez; daha fazlasına ihtiyaç duyduğunuzda ücretsiz bir anahtar sınırları yükseltir.

1. Sunucuyu ekleyin

Sunucu, MCP’yi şu adreste streamable HTTP üzerinden konuşur:

https://qurangallery.com/mcp/shamela

Bir istemcinin ihtiyaç duyduğu tek şey bu URL’dir. Nereye yapıştırılacağı:

Claude (claude.ai ve Claude Desktop): Customize → Connectors → + Add → Add custom connector (eski sürümlerde: Settings → Connectors). Adını Quran Gallery yapın, URL’yi yapıştırın ve gelişmiş ayarları boş bırakın. Ardından araçlar menüsünden bir sohbet için etkinleştirin. Adım adım.

ChatGPT: ChatGPT Plugins sayfasını açın, + → Add custom MCP server seçeneğini seçin, yukarıdaki URL’yi yapıştırın, kimlik doğrulamasını yok olarak seçin ve oluşturun. Eski hesaplar Settings → Apps & Connectors → Advanced settings → Developer mode → Create yolunu kullanır. Adım adım.

Claude Code (ayrıntılar):

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

Gemini CLI (ayrıntılar) — ~/.gemini/settings.json içinde:

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

Cursor (ayrıntılar) — ~/.cursor/mcp.json içinde:

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

VS Code ve GitHub Copilot (VS Code, Copilot) — .vscode/mcp.json içinde:

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

Menü adları sürümler arasında değişir. Sizinkiler farklıysa istemcinin ayarlarında connectors, integrations veya MCP servers ifadelerini arayın; uzak bir MCP URL’si kabul eden her istemci çalışır.

Tam yolu kullanın: /mcp/shamela. Yalın /mcp, sunucuyu anlatan sayfadır, uç nokta değildir; bir istemciyi oraya yönlendirmek çalışmaz.

2. Bir şey sorun

İstemciniz isterse yeniden başlatın, ardından bir metin gerektiren soru sorun:

«إنما الأعمال بالنيات» hadisini birincil derlemelerde bul ve tam olarak hangi basılı sayfada olduğunu söyle.

Asistanınız search_library aracını çağırmalı ve yanıt bir kitap, bir baskı ve bir sayfa belirtmelidir — bu hadis için صحيح البخاري, ط السلطانية, sayfa 1/6.

Aracı çağırmak yerine hafızasından yanıt verirse bunu doğrudan söyleyin: “Quran Gallery kütüphane aracını kullan ve döndürdüğü basılı sayfayı alıntıla.”

3. Bağlantıyı denetleyin

İstemciniz search_library ile başlayan 39 aracı listelemelidir (araçların tam listesi). Hiçbirini listelemiyorsa sunucuya ulaşılamamıştır; bkz. Sınırlar ve hatalar.

Elle de denetleyebilirsiniz:

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"}'

Araçları listeleyen bir JSON nesnesi döndürür; search_library ilk sıradadır. Anahtar olmadan araç listelemek, araç çağrısı hakkınızdan harcamaz.

4. İsteğe bağlı: daha yüksek sınırlar için anahtar ekleyin

Anahtarsız kullanımda IP adresi başına dakikada 10 ve günde 200 araç çağrısı alırsınız ve iki sayfa aralığı okuyucusu çağrı başına birkaç sayfa döndürür (bkz. Sınırlar ve hatalar). Bu, sunucuyu denemeye ve ara sıra yapılan sorgulamalara yeter. Araştırma oturumları veya üzerine bir şey inşa etmek için ücretsiz bir anahtar vardır: dakikada 60 çağrı, günlük üst sınır yok, tam sayfa aralıkları. Bir sınıra takılana kadar bu bölümü atlayın.

Quran Gallery hesabınızda oturum açın, Developers sayfasına gidin ve açıklayıcı bir adla bir anahtar oluşturun.

Anahtarın tamamı oluşturulurken yalnızca bir kez gösterilir. O anda kopyalayın; sonradan yalnızca ilk birkaç karakteri görünür. Anahtarlar şöyle görünür:

qg_sk_ghjKm4x…

sk, secret key (gizli anahtar) anlamına gelir. Ona tam olarak bir parola gibi davranın: sizin adınıza kimlik doğrular, bir parola yöneticisinde veya gizli bilgi deposunda durmalıdır ve asla git’e commit edilmemeli ya da herkese açık bir issue’ya yapıştırılmamalıdır.

Her istekte bearer token olarak gönderin. Bir yapılandırma dosyasında:

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

Ya da Claude Code ile:

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

Anahtar yalnızca Authorization: Bearer … içinde taşınır — sorgu parametresi yok, OAuth akışı yok. Yalnızca düz bir URL kabul eden bir istemci anahtarsız sınırlarda kalır.

Anahtarları oluşturma, yenileme ve iptal etme konusunun tüm ayrıntıları API anahtarları sayfasındadır.

Bu sayfayı GitHub'da düzenle