Cursor, MCP Inspector আর অন্যান্য MCP ক্লায়েন্টের জন্য সার্ভার URL, ট্রান্সপোর্ট আর OAuth ফ্লো – ডেভেলপারদের জন্য সব ডিসকভারি ঠিকানাসহ।
Claude আর ChatGPT ছাড়াও যেকোনো MCP ক্লায়েন্ট কাজ করবে, যা HTTP দিয়ে রিমোট সার্ভার আর OAuth সাইন-ইন সমর্থন করে – যেমন Cursor-এর মতো IDE, বা পরীক্ষার জন্য MCP Inspector। এই আর্টিকেলটি তাঁদের জন্য, যাঁরা নিজে এমন কোনো ক্লায়েন্ট সেট আপ করেন বা নিজস্ব ইন্টিগ্রেশন তৈরি করেন।
মূল তথ্য
- সার্ভার URL
- https://dock.at-harbor.com/mcp
- ট্রান্সপোর্ট
- Streamable HTTP, stateless। প্রতিটি অনুরোধ একটি JSON-RPC বার্তা (বা একটি ব্যাচ) সহ একটি POST, আর উত্তর JSON হিসেবে ফেরত আসে। কোনো সেশন ID বা সার্ভার স্ট্রিম নেই।
- প্রোটোকল ভার্সন
- 2025-11-25, 2025-06-18 আর 2025-03-26
- মেথড
- initialize, ping, tools/list আর tools/call। সার্ভার কোনো resources বা prompts দেয় না।
- সাইন-ইন
- PKCE (S256) সহ OAuth 2.1। টোকেন ছাড়া সার্ভার 401 দিয়ে উত্তর দেয় এবং WWW-Authenticate হেডারে তার মেটাডেটার দিকে নির্দেশ করে।
একটি ক্লায়েন্ট সেট আপ করুন
- আপনার ক্লায়েন্টে একটি রিমোট MCP সার্ভার যোগ করুন (প্রায়ই এর নাম “Remote”, “HTTP” বা “Streamable HTTP”)
- URL হিসেবে https://dock.at-harbor.com/mcp লিখুন
- client ID আর secret খালি রাখুন – ক্লায়েন্ট নিজেই নিবন্ধিত হয়
- সংযোগ শুরু করুন; আপনার ব্রাউজারে সাইন-ইন খুলবে, তারপর LinkHarbor-এর সম্মতির পেজ
- ওয়ার্কস্পেস আর অনুমতি বেছে নিয়ে “অনুমতি দিন”-এ ক্লিক করুন
সেটিংটির নাম প্রোগ্রাম ভেদে আলাদা। যেমন MCP Inspector-এ আপনি “Streamable HTTP” ট্রান্সপোর্ট বেছে নেন।
OAuth ফ্লো বিস্তারিত
- ক্লায়েন্ট টোকেন ছাড়া MCP সার্ভারে কল করে এবং রিসোর্স মেটাডেটার নির্দেশসহ 401 পায়
- এটি অথরাইজেশন সার্ভারের মেটাডেটা পড়ে (এন্ডপয়েন্ট, সমর্থিত পদ্ধতি, অনুমতি)
- এটি নিজেকে নিবন্ধন করে: Dynamic Client Registration দিয়ে, অথবা একটি https URL-এ রাখা client metadata document দিয়ে
- এটি অথরাইজেশন অনুরোধসহ ব্রাউজার খোলে, PKCE আর resource=https://dock.at-harbor.com/mcp সহ
- আপনি সাইন ইন করে সম্মতির পেজে সিদ্ধান্ত নেন
- ক্লায়েন্ট কোডটির বদলে একটি access token আর একটি refresh token নেয়
| ধাপ | মেয়াদ |
|---|---|
| সাইন-ইন অনুরোধ থেকে আপনার সিদ্ধান্ত পর্যন্ত | ১০ মিনিট |
| Authorization code | ৬০ সেকেন্ড, একবার ব্যবহারযোগ্য |
| Access token | ১ ঘণ্টা |
| Refresh token | প্রতিবার ব্যবহারে নবায়ন হয়; ৯০ দিন ব্যবহার না হলে মেয়াদ শেষ |
কোনো ক্লায়েন্ট কোনো অনুমতি না চাইলে সব অনুমতিই চাওয়া হয়; সম্মতির পেজে আপনি তবুও সেগুলো কমিয়ে নিতে পারেন। আগেই বদলে যাওয়া কোনো refresh token আবার ব্যবহার হলে LinkHarbor নিরাপত্তার কারণে পুরো সংযোগটি শেষ করে দেয়।
রিডাইরেক্ট ঠিকানার নিয়ম
- https ঠিকানা
- http কেবল আপনার নিজের কম্পিউটারের loopback ঠিকানার জন্য (ডেস্কটপ ক্লায়েন্ট আর IDE-র জন্য)
- রিভার্স ডোমেইন নোটেশনে নিজস্ব অ্যাপ স্কিম
- প্রতি ক্লায়েন্টে সর্বোচ্চ ১০টি ঠিকানা, কোনো ফ্র্যাগমেন্ট ছাড়া
কোনো অ্যাপ যদি এমন ঠিকানা পাঠায়, যা তার জন্য নিবন্ধিত নয়, তাহলে LinkHarbor থেমে যায়: “অ্যাপটি এমন একটি ফেরার ঠিকানা পাঠিয়েছে যা এর জন্য নিবন্ধিত নয়। অনুরোধটি থামানো হয়েছে।”
ডেভেলপারদের জন্য ডিসকভারি ঠিকানা
| ডকুমেন্ট | ঠিকানা |
|---|---|
| রিসোর্স মেটাডেটা (RFC 9728) | https://dock.at-harbor.com/.well-known/oauth-protected-resource/mcp |
| অথরাইজেশন সার্ভার (RFC 8414) | https://dock.at-harbor.com/.well-known/oauth-authorization-server |
| টোকেন বাতিল (RFC 7009) | https://dock.at-harbor.com/oauth/revoke |
| MCP Server Card | https://dock.at-harbor.com/.well-known/mcp/server-card.json |
| এজেন্টদের জন্য নির্দেশনা | https://dock.at-harbor.com/auth.md |
অপরিচিত অ্যাপ
যেসব অ্যাপের সব রিডাইরেক্ট ঠিকানা claude.ai, claude.com, chatgpt.com বা openai.com-এ থাকে, সেগুলো পরিচিত হিসেবে গণ্য হয়। localhost দিয়ে ফেরত আসা আপনার নিজের কম্পিউটারের প্রোগ্রামগুলোর ক্ষেত্রে – যেমন Claude Code, Codex আর IDE – সম্মতির পেজে এই নোটটি দেখায়: “LinkHarbor এই অ্যাপটি চেনে না। এটি আপনার নিজের কম্পিউটারে চলছে। শুধু তখনই এগোন যদি আপনি এইমাত্র নিজে এটি চালু করে থাকেন”, আর নিচে লেখা থাকে “বেছে নেওয়ার পর আপনি আপনার কম্পিউটারের অ্যাপে ফিরে যাবেন”। অন্যান্য অচেনা ওয়েব অ্যাপের ক্ষেত্রে দেখায় “LinkHarbor এই অ্যাপটি চেনে না। শুধু তখনই এগোন যদি আপনি নিজে এটি শুরু করে থাকেন এবং …-কে বিশ্বাস করেন”, যেখানে …-এর জায়গায় তাদের ঠিকানা থাকে। আপনি যদি এইমাত্র নিজে ক্লায়েন্টটি সেট আপ করে থাকেন, তাহলে দুটো নোটই স্বাভাবিক। লোগো কেবল তখনই দেখা যায়, যদি অ্যাপটি একটি লোগো পাঠায়। আপনি নিজে সাইন-ইন শুরু না করে থাকলে “প্রত্যাখ্যান করুন”-এ ক্লিক করুন।
এগুলোও কাজে আসতে পারে
কিছু খুঁজে পাননি?
আপনার কী দরকার তা আমাদের জানান, আমাদের সাপোর্ট টিম ব্যক্তিগতভাবে আপনাকে সাহায্য করবে।