تخطَّ إلى المحتوى

ربط الذكاء الاصطناعي بالمكتبة الشاملة: البدء

أضف خادم MCP لمعرض القرآن إلى ChatGPT أو Claude أو Cursor أو VS Code أو Gemini CLI برابط واحد، بلا حساب ولا مفتاح، وجرّب أول بحث موثّق.

في هذه الصفحة

الصق رابطًا واحدًا في مساعدك واسأل سؤالًا. لا حاجة إلى حساب ولا مفتاح للبدء؛ والمفتاح المجاني يرفع الحدود حين تحتاج المزيد.

1. أضف الخادم

يتحدث الخادم بروتوكول MCP عبر streamable HTTP على:

https://qurangallery.com/mcp/shamela

هذا الرابط هو كل ما يحتاجه العميل. ومكان لصقه يعتمد على التطبيق:

تستعملأين يوضع الرابطالدليل
ChatGPTPlugins → Add → Add custom MCP server، وAuthentication No authenticationخطوة بخطوة، مع لقطات الشاشة
Claude (claude.ai وClaude Desktop)Settings → Connectors → + Add → Add custom connectorخطوة بخطوة، مع لقطات الشاشة
Claude Codeأمر واحد في الطرفيةClaude Code
Gemini CLIأمر واحد في الطرفيةGemini CLI
Cursor~/.cursor/mcp.jsonCursor
VS Code وGitHub Copilot.vscode/mcp.jsonVS Code، Copilot

ChatGPT: افتح إضافات ChatGPT، واضغط Add → Add custom MCP server، وسمّه Quran Gallery والصق الرابط. اضبط Authentication على No authentication، لأن الحقل يبدأ على OAuth ويفشل الإعداد معها. ضع علامة على I understand and want to continue، واضغط Create as a plugin، ثم Connect. وتستعمل الحسابات الأقدم Settings → Apps & Connectors → Advanced settings → Developer mode → Create. خطوة بخطوة.

Claude (claude.ai وClaude Desktop): افتح Settings → Connectors (وفي بعض الإصدارات: Customize → Connectors)، واضغط + Add → Add custom connector، وسمّه Quran Gallery، والصق الرابط، واضغط Continue. أبقِ No sign-in، واضغط Add، ثم Connect. وفعّله في المحادثة من + → Connectors. خطوة بخطوة.

Claude Code (التفاصيل):

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

Gemini CLI (التفاصيل):

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

Cursor (التفاصيل) — في ~/.cursor/mcp.json:

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

VS Code وGitHub Copilot (VS Code، Copilot) — في .vscode/mcp.json:

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

ملف إعدادات Claude Desktop: لا يتصل Claude Desktop بخادم بعيد مكتوب في claude_desktop_config.json على هيئة مُدخل "url"، فالإعداد المنسوخ من كتلة Cursor أعلاه يفشل هناك. أضف الخادم بدلًا من ذلك من Settings → Connectors (Claude). وإن احتجت إلى ملف الإعدادات فشغّله عبر جسر mcp-remote، وهو يتطلب Node.js:

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

احفظ الملف ثم أعد تشغيل Claude Desktop.

تتغير أسماء القوائم بين الإصدارات. فإن اختلفت عندك فابحث عن connectors أو integrations أو MCP servers في إعدادات العميل — فأي عميل يقبل رابط MCP بعيدًا يعمل.

استعمل المسار الكامل /mcp/shamela. أما /mcp وحده فهو الصفحة التي تصف الخادم لا نقطة الاتصال، ولن يعمل توجيه العميل إليه.

2. اسأل شيئًا

أعد تشغيل العميل إن طلب منك ذلك، ثم اسأل سؤالًا يحتاج إلى نص:

ابحث عن حديث “إنما الأعمال بالنيات” في المجاميع الأصلية، وأخبرني بالضبط في أي صفحة مطبوعة هو.

ينبغي أن يستدعي مساعدك shamela_search_library، وأن تذكر الإجابة كتابًا وطبعة وصفحة — وهي لهذا الحديث صحيح البخاري، ط السلطانية، الصفحة 1/6.

فإن أجاب من ذاكرته بدل استدعاء الأداة فقل له ذلك صراحة: «استعمل أداة مكتبة معرض القرآن وانقل رقم الصفحة المطبوعة الذي تعيده.»

3. تحقق من الاتصال

ينبغي أن يعرض عميلك 15 أداة، أولها shamela_search_library (انظر قائمة الأدوات الكاملة). فإن لم يعرض شيئًا فتعذّر الوصول إلى الخادم — انظر الحدود والأخطاء.

ويمكنك التحقق يدويًا:

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

يعيد كائن JSON يسرد الأدوات، وshamela_search_library أولها. وبلا مفتاح، لا يستهلك سرد الأدوات من حصة استدعاءاتك.

4. اختياري: أضف مفتاحًا لحدود أعلى

بلا مفتاح تحصل على 10 استدعاءات للأدوات في الدقيقة و200 في اليوم لكل عنوان IP، وتعيد أداتا قراءة نطاق الصفحات بضع صفحات في كل استدعاء (انظر الحدود والأخطاء). وهذا يكفي لتجربة الخادم والبحث العارض. أما لجلسات البحث، أو أي شيء تبنيه عليه، فيتوفر مفتاح مجاني: 60 استدعاءً في الدقيقة، بلا سقف يومي، ونطاقات صفحات كاملة. تخطَّ هذا القسم حتى تبلغ أحد الحدود.

سجّل الدخول إلى حسابك في معرض القرآن، وادخل المطوّرين (Developers)، وأنشئ مفتاحًا باسم وصفي.

يظهر المفتاح كاملًا مرة واحدة عند إنشائه. انسخه حينها — فلا يظهر بعد ذلك إلا أول بضعة أحرف. وهذه صورة المفاتيح:

qg_sk_ghjKm4x…

الرمز sk اختصار secret key أي المفتاح السري. عامله تمامًا كأنه كلمة مرور: فهو يصادق باسمك أنت، ومكانه مدير كلمات المرور أو مخزن أسرار، ولا يجوز إيداعه في git ولا لصقه في بلاغ عام.

أرسله رمز bearer مع كل طلب. في ملف إعدادات:

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

أو مع Claude Code:

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

ينتقل المفتاح عبر Authorization: Bearer … فقط — لا معامل في الاستعلام ولا مسار OAuth. والعميل الذي يقبل رابطًا مجردًا فقط يبقى على حدود الاستخدام بلا مفتاح.

تفاصيل إنشاء المفاتيح وتدويرها وإبطالها في مفاتيح API.

الخطوات التالية

أسئلة

كيف أربط مساعد الذكاء الاصطناعي بالمكتبة الشاملة؟

الصق https://qurangallery.com/mcp/shamela في أي تطبيق يقبل خادم MCP بعيدًا، مثل ChatGPT وClaude وClaude Code وGemini CLI وCursor وVS Code وGitHub Copilot، ثم اسأل سؤالًا يحتاج إلى نص.

هل أحتاج إلى حساب أو مفتاح API؟

لا. المفتاح المجاني اختياري ويرفع الحد إلى 60 استدعاءً في الدقيقة إذا احتجت المزيد.

كيف أضيف الخادم إلى ChatGPT؟

افتح ChatGPT Plugins واختر Add ثم Add custom MCP server، وسمِّه Quran Gallery والصق العنوان واجعل المصادقة No authentication.

كيف أضيف الخادم إلى Claude؟

افتح Settings ثم Connectors واختر Add ثم Add custom connector، وسمِّه Quran Gallery والصق العنوان وأبقِ No sign-in، ثم اضغط Add ثم Connect.

كيف أتحقق من عمل الاتصال؟

ينبغي أن يعرض العميل 15 أداة تبدأ بـ shamela_search_library. اسأل عن حديث في المجاميع الأساسية فتسمّي الإجابة كتابًا وطبعة وصفحة.

لماذا يجيب مساعدي من الذاكرة؟

قل له صراحة: استخدم أداة مكتبة Quran Gallery واقتبس الصفحة المطبوعة التي تعيدها.

ما الحدود المجانية؟

بلا مفتاح 10 استدعاءات للأدوات في الدقيقة و200 في اليوم لكل عنوان IP. ومع مفتاح مجاني 60 في الدقيقة بلا سقف يومي.

عدّل هذه الصفحة على GitHub