İçeriğe geç

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. URL’yi nereye yapıştıracağınız uygulamaya bağlıdır:

KullandığınızURL’nin gireceği yerKılavuz
ChatGPTPlugins → Add → Add custom MCP server, Authentication No authenticationEkran görüntüleriyle adım adım
Claude (claude.ai, Claude Desktop)Settings → Connectors → + Add → Add custom connectorEkran görüntüleriyle adım adım
Claude CodeTek bir terminal komutuClaude Code
Gemini CLITek bir terminal komutuGemini CLI
Cursor~/.cursor/mcp.jsonCursor
VS Code, GitHub Copilot.vscode/mcp.jsonVS Code, Copilot

ChatGPT: ChatGPT Plugins sayfasını açın, Add → Add custom MCP server seçeneğine tıklayın, adını Quran Gallery yapın ve URL’yi yapıştırın. Authentication alanını No authentication olarak ayarlayın; çünkü alan OAuth ile başlar ve orada başarısız olur. I understand and want to continue kutusunu işaretleyin, Create as a plugin düğmesine tıklayın, ardından Connect düğmesine tıklayın. Eski hesaplar Settings → Apps & Connectors → Advanced settings → Developer mode → Create yolunu kullanır. Adım adım.

Claude (claude.ai ve Claude Desktop): Settings → Connectors yolunu açın (bazı sürümlerde: Customize → Connectors), + Add → Add custom connector seçeneğine tıklayın, adını Quran Gallery yapın, URL’yi yapıştırın ve Continue düğmesine tıklayın. No sign-in seçili kalsın, Add düğmesine, ardından Connect düğmesine tıklayın. Bir sohbette + → Connectors üzerinden etkinleştirin. 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 mcp add --transport http quran-gallery 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" }
	}
}

Claude Desktop yapılandırma dosyası: Claude Desktop, claude_desktop_config.json içine "url" girdisi olarak yazılmış uzak bir sunucuya bağlanmaz; yukarıdaki Cursor bloğundan kopyalanan bir yapılandırma orada başarısız olur. Sunucuyu bunun yerine Settings → Connectors altından ekleyin (Claude). Yapılandırma dosyasına ihtiyacınız varsa sunucuyu Node.js gerektiren mcp-remote köprüsüyle çalıştırın:

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

Dosyayı kaydedin ve Claude Desktop’ı yeniden başlatın.

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 shamela_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 shamela_search_library ile başlayan 15 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; shamela_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.

Sonraki adımlar

Sorular

Yapay zeka asistanını Şamile kütüphanesine nasıl bağlarım?

https://qurangallery.com/mcp/shamela adresini ChatGPT, Claude, Claude Code, Gemini CLI, Cursor, VS Code veya GitHub Copilot gibi uzak MCP sunucusu kabul eden bir uygulamaya yapıştırın, sonra bir metin gerektiren soru sorun.

Hesap veya API anahtarı gerekir mi?

Hayır. Ücretsiz anahtar isteğe bağlıdır ve daha fazlası gerektiğinde sınırı dakikada 60 çağrıya çıkarır.

Sunucuyu ChatGPT'ye nasıl eklerim?

ChatGPT Plugins'i açın, Add ardından Add custom MCP server seçin, adını Quran Gallery yapın, URL'yi yapıştırın ve Authentication'ı No authentication yapın.

Sunucuyu Claude'a nasıl eklerim?

Settings, ardından Connectors'ı açın, Add ve Add custom connector seçin, adını Quran Gallery yapın, URL'yi yapıştırın, No sign-in seçili kalsın, sonra Add ve Connect'e tıklayın.

Bağlantının çalıştığını nasıl anlarım?

İstemciniz shamela_search_library ile başlayan 15 araç listelemelidir. Birincil derlemelerde bir hadis sorun; yanıt bir kitap, baskı ve sayfa belirtmelidir.

Asistanım neden hafızadan yanıt veriyor?

Doğrudan söyleyin: Quran Gallery kütüphane aracını kullan ve döndürdüğü basılı sayfayı alıntıla.

Ücretsiz sınırlar nelerdir?

Anahtarsız IP adresi başına dakikada 10, günde 200 araç çağrısı. Ücretsiz anahtarla dakikada 60 ve günlük sınır yok.

Bu sayfayı GitHub'da düzenle