إضافة خادم المكتبة الإسلامية MCP إلى Claude Code
أمر واحد يضيف خادم MCP لمعرض القرآن إلى Claude Code: كتب عربية تراثية، وتوثيق برقم الصفحة المطبوعة، بلا حساب ولا مفتاح.
في هذه الصفحة
بلا حساب ولا تسجيل دخول ولا مفتاح. أمر واحد:
claude mcp add --transport http quran-gallery https://qurangallery.com/mcp/shamelaالخطوات
شغّل الأمر أعلاه في الطرفية. يسجّل لك الخادم في النطاق المحلي؛ أضف
--scope userليتوفر في كل مشروع، أو--scope projectلمشاركته عبر.mcp.json.شغّل
claude mcp list، أو شغّلclaudeثم نفّذ/mcp. ينبغي أن يظهرquran-galleryمتصلًا.
اسأل سؤالًا يحتاج إلى نص (أدناه). يسألك Claude Code قبل أن يشغّل كل أداة أول مرة. وافق عليه.
تذكر الإجابة كل طبعة مع مجلدها وصفحتها المطبوعة ورابط المكتبة، وتنقل النص العربي:

لإزالته: claude mcp remove quran-gallery.
أول سؤال تجرّبه
ابحث عن حديث «إنما الأعمال بالنيات» في المجاميع الأصلية، وأخبرني في أي كتاب وطبعة ومجلد وصفحة طُبع. انقل النص العربي بحروفه.
ينبغي أن يستدعي مساعدك shamela_search_library (أو search ثم fetch). وتتضمن النتائج صحيح البخاري، ط السلطانية، الصفحة 1/6، مع رابط إلى تلك الصفحة في قارئ المكتبة. فإن أجاب من ذاكرته بدل ذلك فقل له: «استعمل أداة مكتبة معرض القرآن وانقل ما تعيده.»
يجب أن تكون استعلامات البحث بالعربية؛ فيترجم مساعدك المصطلحات الإنجليزية أولًا (التفاصيل). وتجد أسئلة جاهزة لـ«تخريج الحديث» وتوثيق النصوص ومقارنة التفاسير في قائمة الأدوات الكاملة.
حل المشكلات
- 429، «Keyless limit reached». يتيح الاستخدام بلا مفتاح 10 استدعاءات للأدوات في الدقيقة و200 في اليوم لكل عنوان IP. انتظر حسب ترويسة
Retry-After، أو أضف مفتاحًا مجانيًا (أدناه). انظر الحدود والأخطاء. - 503. الخادم أو المكتبة خلفه غير متاح لوقت وجيز. أعد المحاولة بعد المدة في ترويسة
Retry-After؛ وإن عرض العميل صفر أدوات فانتظر دقيقة ثم أعد الاتصال. - الأدوات لا تظهر، أو تنقصك أداة متوقعة. نفّذ
/mcpوأعد توصيل الخادم، أو أعد تشغيلclaude؛ فقائمة الأدوات تُقرأ عند اتصال الخادم. - يفشل الاتصال فورًا. نقطة الاتصال هي
/mcp/shamela؛ أما/mcpوحده فصفحة ويب لا الخادم.
اختياري: مفتاح مجاني لحدود أعلى
المفتاح ليس مطلوبًا أبدًا. المفتاح المجاني يرفع الحد إلى 60 استدعاءً في الدقيقة ويرفع سقوف نطاق الصفحات المفروضة على الاستخدام بلا مفتاح. أنشئ مفتاحًا من صفحة المطوّرين (Developers) في حسابك بمعرض القرآن (كيف تعمل المفاتيح)، ثم أرسله رمزًا من نوع bearer.
أضفه بالخيار --header:
claude mcp add --transport http quran-gallery
https://qurangallery.com/mcp/shamela
--header "Authorization: Bearer qg_sk_your_key_here"عامل المفتاح كأنه كلمة مرور، وأبقِه خارج git.
الخطوات التالية
أسئلة
كيف أضيف خادم MCP إلى Claude Code؟
نفّذ في الطرفية: claude mcp add --transport http quran-gallery https://qurangallery.com/mcp/shamela. لا حاجة إلى حساب ولا تسجيل دخول ولا مفتاح.
كيف أتأكد أن الخادم متصل في Claude Code؟
نفّذ claude mcp list أو شغّل claude ثم /mcp، فيظهر quran-gallery متصلًا. وإن غابت الأدوات فأعد الاتصال من /mcp أو أعد تشغيل claude.
كيف أجعل الخادم متاحًا في كل مشروع؟
أضف --scope user إلى الأمر. النطاق الافتراضي محلي، وتشاركه مع فريقك عبر --scope project في ملف .mcp.json.
كيف أضيف مفتاح API في Claude Code؟
أضف --header "Authorization: Bearer qg_sk_your_key_here" إلى أمر claude mcp add. المفتاح اختياري ويرفع الحد إلى 60 استدعاءً في الدقيقة.
لماذا يظهر خطأ 429 «Keyless limit reached»؟
يتيح الاستخدام بلا مفتاح 10 استدعاءات للأدوات في الدقيقة و200 في اليوم لكل عنوان IP. انتظر مدة ترويسة Retry-After أو أضف مفتاحًا مجانيًا.
كيف أزيل الخادم من Claude Code؟
نفّذ claude mcp remove quran-gallery.