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

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

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

এই পাতায়

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

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

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

https://qurangallery.com/mcp/shamela

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

আপনি যা ব্যবহার করেনURL যেখানে যায়গাইড
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 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/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_config.json-এ "url" এন্ট্রি হিসেবে লেখা রিমোট সার্ভারে Claude Desktop সংযুক্ত হয় না, তাই ওপরের 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 হলো সার্ভারের বিবরণের পৃষ্ঠা, এন্ডপয়েন্ট নয়, এবং ক্লায়েন্টকে সেখানে নির্দেশ করলে কাজ করবে না।

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

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

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

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

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

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

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

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

কী ছাড়া আপনি প্রতি 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 কী-তে আছে।

পরবর্তী ধাপ

প্রশ্ন

AI সহকারীকে শামেলা লাইব্রেরির সঙ্গে কীভাবে যুক্ত করব?

ChatGPT, Claude, Claude Code, Gemini CLI, Cursor, VS Code বা GitHub Copilot-এর মতো যে অ্যাপ রিমোট MCP সার্ভার নেয় তাতে https://qurangallery.com/mcp/shamela বসান, তারপর পাঠ লাগে এমন একটি প্রশ্ন করুন।

অ্যাকাউন্ট বা API কী লাগবে কি?

না। বিনামূল্যের কী ঐচ্ছিক; বেশি দরকার হলে সীমা বাড়িয়ে প্রতি মিনিটে ৬০ কল করে।

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 দিয়ে শুরু হওয়া ১৫টি টুল দেখাবে। প্রাথমিক সংকলনে একটি হাদিস সম্পর্কে জিজ্ঞাসা করুন; উত্তরে বই, সংস্করণ ও পৃষ্ঠার নাম থাকবে।

আমার সহকারী স্মৃতি থেকে উত্তর দেয় কেন?

সরাসরি বলুন: Quran Gallery লাইব্রেরি টুল ব্যবহার করুন এবং এটি যে মুদ্রিত পৃষ্ঠা ফেরত দেয় তা উদ্ধৃত করুন।

বিনামূল্যের সীমা কত?

কী ছাড়া প্রতি IP ঠিকানায় মিনিটে ১০ ও দিনে ২০০টি টুল কল। বিনামূল্যের কী নিয়ে মিনিটে ৬০, দৈনিক সীমা নেই।

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