İçeriğe geç

Claude'u İslami kütüphaneye bağlayın (MCP)

Quran Gallery MCP sunucusunu Claude'a (claude.ai ve Desktop) özel bağlayıcı olarak ekleyin. Hesap yok, anahtar yok, 8.594 klasik Arapça eser.

Bu sayfada

Hesap, oturum açma, anahtar yok. Claude’da şu URL ile tek bir özel bağlayıcı ekleyin:

https://qurangallery.com/mcp/shamela

Adımlar claude.ai’de ve Claude Desktop’ta aynıdır. Ücretsiz planlarda bir özel bağlayıcı eklenebilir. Team ve Enterprise planlarında bir Owner bunu Organization settings → Connectors altından ekler, ardından her üye kendisi için etkinleştirir.

1. Connectors sayfasını açın ve özel bağlayıcı ekleyin

Settings → Connectors yolunu açın (claude.ai/settings/connectors). Bazı sürümlerde Customize → Connectors altındadır. + Add, ardından Add custom connector seçeneğine tıklayın.

Claude'un Connectors ayarları; Add menüsü açık ve Add custom connector seçeneğinde.

2. Adını verin ve URL’yi yapıştırın

Adını Quran Gallery yapın, https://qurangallery.com/mcp/shamela adresini yapıştırın ve Continue düğmesine tıklayın.

Add custom connector iletişim kutusu; ad Quran Gallery, URL https://qurangallery.com/mcp/shamela.

3. No sign-in seçili kalsın, ardından ekleyin ve bağlayın

Claude sunucuyu denetler ve Detected etiketiyle işaretli No sign-in seçeneğini seçer. Seçili bırakın. Bir anahtarınız yoksa Request headers bölümünü yok sayabilirsiniz (bu sayfanın sonuna bakın). Add, ardından Connect düğmesine tıklayın. Bir ileti, Connected to Quran Gallery ifadesiyle bağlantıyı doğrular.

Authentication adımı: Sign in now, Sign in when needed ve Detected rozetiyle seçili No sign-in.

4. Claude’un araçları ne zaman kullanabileceğini seçin

Bağlayıcı sayfası, varsayılan olarak Needs approval ayarlı 15 salt okunur aracı listeler. Her çağrıyı onaylamak için bunu olduğu gibi bırakın veya istemleri atlamak için Read-only tools ayarını Always allow yapın.

Quran Gallery bağlayıcı sayfası: Needs approval ayarlı salt okunur araçları.

5. Bir sohbette etkinleştirin

Bir sohbette + düğmesine tıklayın, Connectors menüsünü açın ve Quran Gallery seçeneğini açın.

Bir Claude sohbetinin + menüsü, Connectors alt menüsü; Quran Gallery açık.

6. Sorun ve ilk çağrıyı onaylayın

Claude bir aracı ilk kez kullanırken sorar. Allow once düğmesine tıklayın veya o araç için Always allow seçin.

Claude, Quran Gallery'den Identify a cited work aracını kullanmak için izin istiyor; Decline, Always allow ve Allow once seçenekleriyle.

Yanıt, her basılı baskıyı cilt ve sayfasıyla birlikte belirtir:

Quran Gallery kullanan bir Claude yanıtı: Sahih al-Bukhari hadis 1; Sultaniyya baskısında cilt 1 sayfa 6'da, al-Bugha baskısında cilt 1 sayfa 3'te basılı.

Denenecek ilk istem

«إنما الأعمال بالنيات» hadisini birincil derlemelerde bul ve hangi kitapta, hangi baskıda, hangi cilt ve sayfada basılı olduğunu söyle. Arapça metni birebir alıntıla.

Asistanınız shamela_search_library aracını (veya search, ardından fetch) çağırmalıdır. Sonuçlar, Maktabah okuyucusundaki sayfa bağlantısıyla birlikte صحيح البخاري, ط السلطانية, sayfa 1/6 içerir. Asistan bunun yerine hafızasından yanıt verirse şunu söyleyin: “Quran Gallery kütüphane aracını kullan ve döndürdüğü metni alıntıla.”

Arama sorguları Arapça olmalıdır; asistanınız İngilizce terimleri önce Arapçaya çevirir (ayrıntılar). Tahrîc, bir pasajı kaynak gösterme ve tefsir karşılaştırma için hazır istemler araçların tam listesinde yer alır.

Sorun giderme

  • 429, “Keyless limit reached”. Anahtarsız kullanımda IP adresi başına dakikada 10, günde 200 araç çağrısına izin verilir. Retry-After başlığındaki süre kadar bekleyin veya ücretsiz bir anahtar ekleyin (aşağıda). Bkz. Sınırlar ve hatalar.
  • 503. Sunucu veya arkasındaki kütüphane kısa süreliğine kullanılamıyor. Retry-After başlığındaki süreden sonra yeniden deneyin. Bağlayıcı sıfır araç listeliyorsa bir dakika bekleyin ve araç listesini yenileyin.
  • Araçlar görünmüyor veya beklediğiniz bir araç eksik. Bağlayıcı sayfasında ⋮ menüsünü açın ve Refresh tools list seçeneğini seçin, ardından yeni bir sohbet başlatın.
  • Claude kütüphaneyi kullanmadan yanıt veriyor. Bağlayıcının bu sohbet için açık olduğunu denetleyin (5. adım) ve ondan Quran Gallery araçlarını kullanmasını isteyin.
  • Bağlantı hemen başarısız oluyor. Uç nokta /mcp/shamela adresidir; yalın /mcp bir web sayfasıdır, sunucu değildir.

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

Anahtar hiçbir zaman zorunlu değildir. Ücretsiz bir anahtar sınırı dakikada 60 çağrıya çıkarır ve anahtarsız kullanımdaki sayfa aralığı kısıtlarını kaldırır. Quran Gallery hesabınızın Developers sayfasında bir anahtar oluşturun (anahtarlar nasıl çalışır).

Anahtarı 3. adımda ekleyin. No sign-in seçili kalsın ve Request headers altında adı Authorization, değeri Bearer qg_sk_your_key_here olan bir başlık ekleyin. Yer tutucunun yerine kendi anahtarınızı kullanın. Bağlayıcı zaten varsa ⋮ menüsünden kaldırın ve başlıkla yeniden ekleyin.

Sonraki adımlar

Bu sayfayı GitHub'da düzenle