মূল বিষয়বস্তুতে যান
Search docs
Search docs…

AI-কে শামেলা লাইব্রেরির সাথে সংযুক্ত করুন: শুরু করার গাইড

URL দিয়ে ChatGPT, Claude, Cursor, VS Code বা Gemini CLI-তে Quran Gallery MCP সার্ভার যোগ করুন। অ্যাকাউন্ট বা কী লাগবে না। প্রথম উদ্ধৃতিসহ সার্চ চালান।

এই পাতায়

আপনার অ্যাসিস্ট্যান্টে একটি URL পেস্ট করুন এবং একটি প্রশ্ন করুন। শুরু করতে কোনো অ্যাকাউন্ট বা কী লাগে না; বেশি দরকার হলে একটি বিনামূল্যের কী সীমা বাড়ায়।

১. সার্ভার যোগ করুন

সার্ভারটি streamable HTTP-এর মাধ্যমে MCP বলে, এই ঠিকানায়:

https://qurangallery.com/mcp/shamela

একটি ক্লায়েন্টের জন্য শুধু এই URL-ই যথেষ্ট। কোথায় পেস্ট করবেন:

Claude (claude.ai ও Claude Desktop): Customize → Connectors → + Add → Add custom connector (পুরোনো সংস্করণে: Settings → Connectors)। নাম দিন Quran Gallery, URL পেস্ট করুন এবং অ্যাডভান্সড সেটিংস খালি রাখুন। তারপর টুল মেনু থেকে একটি চ্যাটে এটি চালু করুন। ধাপে ধাপে।

ChatGPT: ChatGPT Plugins খুলুন, + → Add custom MCP server বেছে নিন, উপরের URL পেস্ট করুন, অথেনটিকেশন নেই বেছে নিন এবং তৈরি করুন। পুরোনো অ্যাকাউন্টে Settings → Apps & Connectors → Advanced settings → Developer mode → Create ব্যবহার করুন। ধাপে ধাপে।

Claude Code (বিস্তারিত):

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

Gemini CLI (বিস্তারিত) — ~/.gemini/settings.json-এ:

{
  "mcpServers": {
    "quran-gallery": { "httpUrl": "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" }
  }
}

মেনুর নাম রিলিজ ভেদে বদলায়। আপনার ক্লায়েন্টে নাম আলাদা হলে ক্লায়েন্টের সেটিংসে connectors, integrations বা MCP servers খুঁজুন — রিমোট MCP URL গ্রহণ করে এমন যেকোনো ক্লায়েন্ট কাজ করে।

পূর্ণ পাথ /mcp/shamela ব্যবহার করুন। শুধু /mcp হলো সার্ভারের বিবরণের পৃষ্ঠা, এন্ডপয়েন্ট নয়, এবং ক্লায়েন্টকে সেখানে নির্দেশ করলে কাজ করবে না।

২. কিছু জিজ্ঞাসা করুন

ক্লায়েন্ট বললে সেটি পুনরায় চালু করুন, তারপর এমন একটি প্রশ্ন করুন যার জন্য কোনো গ্রন্থের পাঠ দরকার:

Find the hadith “إنما الأعمال بالنيات” in the primary collections and tell me exactly which printed page it’s on.

আপনার অ্যাসিস্ট্যান্ট search_library কল করবে, এবং উত্তরে একটি বই, একটি মুদ্রণ ও একটি পৃষ্ঠার নাম থাকবে — ওই হাদীসের জন্য: صحيح البخاري, ط السلطانية, page 1/6।

যদি সে টুল কল না করে স্মৃতি থেকে উত্তর দেয়, সরাসরি বলুন: “Use the Quran Gallery library tool and quote the printed page it returns.”

৩. সংযোগ যাচাই করুন

আপনার ক্লায়েন্টে ৩৯টি টুল দেখা উচিত, 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 অবজেক্ট ফেরত দেয়, search_library প্রথমে। কী ছাড়া টুল তালিকা দেখলে আপনার টুল-কলের বরাদ্দ খরচ হয় না।

৪. ঐচ্ছিক: বেশি সীমার জন্য কী যোগ করুন

কী ছাড়া আপনি প্রতি IP ঠিকানায় মিনিটে ১০টি এবং দিনে ২০০টি টুল কল পান, এবং দুটি পৃষ্ঠা-পরিসর রিডার প্রতি কলে কয়েকটি পৃষ্ঠা ফেরত দেয় (দেখুন সীমা ও ত্রুটি)। সার্ভার চেষ্টা করা ও মাঝেমধ্যে খোঁজার জন্য এটি যথেষ্ট। গবেষণা সেশন বা এর ওপর কিছু তৈরির জন্য একটি বিনামূল্যের কী আছে: মিনিটে ৬০ কল, দৈনিক সীমা নেই, পূর্ণ পৃষ্ঠা-পরিসর। সীমায় না পৌঁছানো পর্যন্ত এই অংশ বাদ দিন।

আপনার Quran Gallery অ্যাকাউন্টে সাইন ইন করুন, 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 প্রক্রিয়া নেই। যে ক্লায়েন্ট শুধু খালি URL গ্রহণ করে, সে কী-বিহীন সীমাতেই থাকে।

কী তৈরি, ঘোরানো ও বাতিল করার পূর্ণ বিবরণ API কী-তে আছে।

GitHub-এ এই পাতা সম্পাদনা করুন