İçeriğe geç

İslami kütüphane MCP sunucusunu Claude Code'a ekleyin

Tek komutla Quran Gallery MCP sunucusunu Claude Code'a ekleyin: klasik Arapça kitaplar, basılı sayfa atıfları, hesap ve anahtar gerekmez.

Bu sayfada

Hesap, oturum açma, anahtar yok. Tek komut:

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

Adımlar

  1. Yukarıdaki komutu terminalinizde çalıştırın. Sunucuyu sizin için yerel kapsamda kaydeder; her projede kullanılabilmesi için --scope user, .mcp.json üzerinden paylaşmak için --scope project ekleyin.

  2. claude mcp list komutunu çalıştırın veya claude komutunu başlatıp /mcp çalıştırın. quran-gallery bağlı görünmelidir.

    Bir terminal: claude mcp add quran-gallery'yi kaydeder ve claude mcp list onu Connected olarak gösterir.

  3. Bir metin gerektiren soru sorun (aşağıda). Claude Code her aracı ilk kez çalıştırmadan önce sorar. Onaylayın.

Yanıt her baskıyı cildi, basılı sayfası ve Maktabah bağlantısıyla birlikte verir ve Arapça metni alıntılar:

Bir terminal: Claude Code hadisi Sahih al-Bukhari'de (Sultaniyya baskısı, 1/6) ve Sunan Ibn Majah'ta (al-Arnaut baskısı, 5/305) buluyor; her biri shamela.ws bağlantısı ve Arapça metniyle.

Kaldırmak için: claude mcp remove quran-gallery.

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; istemci sıfır araç listeliyorsa bir dakika bekleyip yeniden bağlanın.
  • Araçlar görünmüyor veya beklediğiniz bir araç eksik. /mcp çalıştırıp sunucuyu yeniden bağlayın veya claude komutunu yeniden başlatın; araç listesi sunucu bağlandığında okunur.
  • 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), ardından bunu bearer token olarak gönderin.

--header ile ekleyin:

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

Anahtara bir parola gibi davranın ve git dışında tutun.

Sonraki adımlar

Sorular

Claude Code'a MCP sunucusu nasıl eklenir?

Terminalde claude mcp add --transport http quran-gallery https://qurangallery.com/mcp/shamela komutunu çalıştırın. Hesap, oturum açma veya anahtar gerekmez.

Claude Code'da sunucunun bağlı olduğunu nasıl anlarım?

claude mcp list komutunu çalıştırın ya da claude'u açıp /mcp yazın. quran-gallery bağlı görünmelidir. Araçlar eksikse /mcp üzerinden yeniden bağlanın veya claude'u yeniden başlatın.

Sunucuyu her projede nasıl kullanılabilir yaparım?

Komuta --scope user ekleyin. Varsayılan yerel kapsamdır; --scope project sunucuyu .mcp.json üzerinden ekibinizle paylaşır.

Claude Code'da API anahtarı nasıl eklenir?

claude mcp add komutuna --header "Authorization: Bearer qg_sk_your_key_here" ekleyin. Anahtar isteğe bağlıdır ve sınırı dakikada 60 çağrıya çıkarır.

Neden 429 Keyless limit reached hatası alıyorum?

Anahtarsız kullanımda IP adresi başına dakikada 10, günde 200 araç çağrısı yapılabilir. Retry-After başlığındaki süreyi bekleyin veya ücretsiz bir anahtar ekleyin.

Sunucuyu Claude Code'dan nasıl kaldırırım?

claude mcp remove quran-gallery komutunu çalıştırın.

Bu sayfayı GitHub'da düzenle