AI کو مکتبہ شاملہ سے جوڑیں: شروعات
قرآن گیلری MCP سرور کو URL سے ChatGPT، Claude، Cursor، VS Code یا Gemini CLI میں شامل کریں۔ اکاؤنٹ یا کلید درکار نہیں۔ پہلی حوالہ شدہ تلاش چلائیں۔
اس صفحے پر
اپنے اسسٹنٹ میں ایک URL چسپاں کریں اور سوال پوچھیں۔ شروع کرنے کے لیے نہ اکاؤنٹ چاہیے نہ کلید؛ جب زیادہ ضرورت ہو تو ایک مفت کلید حدیں بڑھا دیتی ہے۔
1. سرور شامل کریں
سرور MCP کو streamable HTTP پر اس پتے پر چلاتا ہے:
https://qurangallery.com/mcp/shamelaکلائنٹ کو بس یہی URL چاہیے۔ اسے کہاں چسپاں کرنا ہے، یہ ایپ پر منحصر ہے:
| آپ کیا استعمال کرتے ہیں | URL کہاں جاتا ہے | گائیڈ |
|---|---|---|
| ChatGPT | Plugins → 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.json | Cursor |
| VS Code، GitHub Copilot | .vscode/mcp.json | VS Code، Copilot |
ChatGPT: ChatGPT Plugins کھولیں، Add → Add custom MCP server پر کلک کریں، اس کا نام Quran Gallery رکھیں اور URL چسپاں کریں۔ 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 رکھیں، URL چسپاں کریں اور Continue پر کلک کریں۔ No sign-in برقرار رکھیں، Add پر کلک کریں، پھر Connect پر۔ کسی چیٹ کے لیے اسے + → Connectors سے آن کریں۔ مرحلہ وار۔
Claude Code (تفصیل):
claude mcp add --transport http quran-gallery https://qurangallery.com/mcp/shamelaGemini CLI (تفصیل):
gemini mcp add --transport http quran-gallery https://qurangallery.com/mcp/shamelaCursor (تفصیل) — ~/.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 URL قبول کرے۔
مکمل راستہ
/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. اختیاری: زیادہ حدوں کے لیے کلید شامل کریں
کلید کے بغیر آپ کو فی IP ایڈریس فی منٹ 10 ٹول کالز اور روزانہ 200 ملتی ہیں، اور صفحات کی حد پڑھنے والے دونوں ٹولز ہر کال میں چند صفحات لوٹاتے ہیں (حدود اور غلطیاں دیکھیں)۔ یہ سرور آزمانے اور کبھی کبھار تلاش کے لیے کافی ہے۔ تحقیقی نشستوں یا اس پر بنائی گئی کسی بھی چیز کے لیے مفت کلید دستیاب ہے: فی منٹ 60 کالز، روزانہ کوئی حد نہیں، مکمل صفحات کی حد۔ جب تک کسی حد تک نہ پہنچیں، یہ حصہ چھوڑ دیں۔
اپنے قرآن گیلری اکاؤنٹ میں سائن ان کریں، Developers پر جائیں اور بامعنی نام کے ساتھ کلید بنائیں۔
مکمل کلید بنانے کے وقت صرف ایک بار دکھائی جاتی ہے۔ اسی وقت کاپی کر لیں — بعد میں صرف پہلے چند حروف نظر آتے ہیں۔ کلیدیں ایسی نظر آتی ہیں:
qg_sk_ghjKm4x…sk کا مطلب secret key ہے۔ اسے بالکل پاس ورڈ کی طرح سمجھیں: یہ آپ کے طور پر تصدیق کرتی ہے، اسے پاس ورڈ مینیجر یا سیکرٹ اسٹور میں رہنا چاہیے، اور اسے کبھی git میں کمٹ نہیں کرنا چاہیے نہ کسی عوامی issue میں چسپاں کرنا چاہیے۔
اسے ہر درخواست پر 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 … میں سفر کرتی ہے — نہ کوئی query پیرامیٹر، نہ OAuth کا عمل۔ جو کلائنٹ صرف سادہ URL قبول کرتا ہے وہ بغیر کلید والی حدوں پر ہی رہتا ہے۔
کلیدیں بنانے، بدلنے اور منسوخ کرنے کی مکمل تفصیل API keys میں ہے۔
اگلے مراحل
سوالات
AI اسسٹنٹ کو شامیلہ لائبریری سے کیسے جوڑیں؟
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 رکھیں، URL چسپاں کریں اور Authentication کو No authentication پر رکھیں۔
Claude میں سرور کیسے شامل کریں؟
Settings پھر Connectors کھولیں، Add اور Add custom connector چنیں، نام Quran Gallery رکھیں، URL چسپاں کریں، No sign-in رہنے دیں، پھر Add اور Connect دبائیں۔
کنکشن کے کام کرنے کی تصدیق کیسے کریں؟
آپ کے کلائنٹ میں shamela_search_library سے شروع ہونے والے 15 ٹولز نظر آنے چاہییں۔ بنیادی مجموعوں میں کسی حدیث کے بارے میں پوچھیں؛ جواب میں کتاب، ایڈیشن اور صفحہ کا نام ہوگا۔
میرا اسسٹنٹ یادداشت سے جواب کیوں دیتا ہے؟
اسے صاف کہیں: Quran Gallery لائبریری ٹول استعمال کرو اور جو چھپا صفحہ وہ لوٹائے اسے نقل کرو۔
مفت حدیں کیا ہیں؟
کلید کے بغیر ہر IP ایڈریس پر 10 ٹول کالز فی منٹ اور 200 روزانہ۔ مفت کلید کے ساتھ 60 فی منٹ اور روزانہ کوئی حد نہیں۔