مواد پر جائیں

Claude Code میں اسلامی کتب کا MCP سرور شامل کریں

ایک کمانڈ سے قرآن گیلری MCP سرور Claude Code میں شامل کریں: عربی کلاسیکی کتب، چھپے صفحے کے حوالے، نہ اکاؤنٹ نہ کلید۔

اس صفحے پر

نہ اکاؤنٹ، نہ سائن اِن، نہ کلید۔ ایک کمانڈ:

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

مراحل

  1. اوپر والی کمانڈ اپنے ٹرمنل میں چلائیں۔ یہ سرور کو آپ کے لیے مقامی دائرے (local scope) میں رجسٹر کر دیتی ہے؛ ہر پروجیکٹ میں دستیاب کرنے کے لیے --scope user، یا .mcp.json کے ذریعے شیئر کرنے کے لیے --scope project شامل کریں۔

  2. claude mcp list چلائیں، یا claude شروع کر کے /mcp چلائیں۔ quran-gallery کنیکٹڈ دکھنا چاہیے۔

    ٹرمنل: claude mcp add quran-gallery کو رجسٹر کرتا ہے، اور claude mcp list اسے Connected دکھاتا ہے۔

  3. ایسا سوال پوچھیں جس کے لیے کسی متن کی ضرورت ہو (نیچے)۔ Claude Code ہر ٹول کو پہلی بار چلانے سے پہلے پوچھتا ہے۔ اسے منظور کریں۔

جواب میں ہر ایڈیشن اس کی جلد، چھپے صفحے اور مکتبہ لنک کے ساتھ دیا جاتا ہے، اور عربی عبارت نقل کی جاتی ہے:

ٹرمنل: Claude Code حدیث کو صحيح البخاري، ط السلطانية، 1/6 میں، اور سنن ابن ماجه، ط الأرنؤوط، 5/305 میں تلاش کرتا ہے، ہر ایک اپنے shamela.ws لنک اور عربی متن کے ساتھ۔

ہٹانے کے لیے: claude mcp remove quran-gallery۔

پہلا پرامپٹ جو آزمائیں

«إنما الأعمال بالنيات» والی حدیث بنیادی مجموعوں میں تلاش کریں اور بتائیں کہ وہ کس کتاب، ایڈیشن، جلد اور صفحے پر چھپی ہے۔ عربی عبارت بالکل ویسی ہی نقل کریں۔

آپ کے اسسٹنٹ کو shamela_search_library (یا search پھر fetch) کال کرنا چاہیے۔ نتائج میں صحيح البخاري، ط السلطانية، صفحہ 1/6 شامل ہے، مکتبہ ریڈر میں اس صفحے کے لنک کے ساتھ۔ اگر وہ یادداشت سے جواب دے تو کہیں: “قرآن گیلری لائبریری ٹول استعمال کریں اور جو وہ لوٹائے اسے نقل کریں۔”

تلاش کے سوالات عربی میں ہونے چاہییں؛ آپ کا اسسٹنٹ انگریزی الفاظ کا پہلے ترجمہ کرتا ہے (تفصیل)۔ تخریج، عبارت کا حوالہ دینے اور تفاسیر کے موازنے کے لیے تیار پرامپٹس مکمل ٹول فہرست میں درج ہیں۔

مسائل کا حل

  • 429، “Keyless limit reached”۔ بغیر کلید استعمال میں فی IP ایڈریس فی منٹ 10 ٹول کالز اور روزانہ 200 کی اجازت ہے۔ 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 سے باہر رکھیں۔

اگلے مراحل

سوالات

Claude Code میں MCP سرور کیسے شامل کریں؟

ٹرمینل میں 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 کے ذریعے ٹیم سے بانٹتا ہے۔

Claude Code میں API کلید کیسے شامل کریں؟

claude mcp add کمانڈ میں --header "Authorization: Bearer qg_sk_your_key_here" شامل کریں۔ کلید اختیاری ہے اور حد 60 کالز فی منٹ کر دیتی ہے۔

429 Keyless limit reached کی خرابی کیوں آتی ہے؟

کلید کے بغیر ہر IP ایڈریس پر 10 ٹول کالز فی منٹ اور 200 روزانہ کی اجازت ہے۔ Retry-After ہیڈر کے مطابق انتظار کریں یا مفت کلید شامل کریں۔

Claude Code سے سرور کیسے ہٹائیں؟

claude mcp remove quran-gallery چلائیں۔

اس صفحے کو GitHub پر ایڈٹ کریں