دوسرے MCP کلائنٹس کو جوڑنا

Claude اور ChatGPT کے علاوہ ہر وہ MCP کلائنٹ کام کرے گا جو HTTP پر ریموٹ سرورز اور OAuth سائن اِن کو سپورٹ کرتا ہو – مثلاً Cursor جیسے IDEs، یا ٹیسٹنگ کے لیے MCP Inspector۔ یہ مضمون ان سب کے لیے ہے جو ایسا کلائنٹ خود سیٹ کرتے ہیں یا اپنی انٹیگریشن بناتے ہیں۔

#اہم حقائق

سرور URL

https://dock.at-harbor.com/mcp

ٹرانسپورٹ

Streamable HTTP، اسٹیٹ لیس۔ ہر درخواست ایک POST ہوتی ہے جس میں JSON-RPC پیغام (یا بیچ) ہوتا ہے، اور جواب 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 ہیڈر میں اپنے میٹا ڈیٹا کی طرف اشارہ کرتا ہے۔

#کلائنٹ سیٹ کریں

1. اپنے کلائنٹ میں ایک ریموٹ MCP سرور شامل کریں (اسے اکثر “Remote”، “HTTP” یا “Streamable HTTP” کہا جاتا ہے)
2. URL کے طور پر https://dock.at-harbor.com/mcp درج کریں
3. کلائنٹ ID اور سیکرٹ خالی چھوڑ دیں – کلائنٹ خود کو رجسٹر کر لیتا ہے
4. کنکشن شروع کریں؛ آپ کے براؤزر میں سائن اِن کھلتا ہے، اور اس کے بعد LinkHarbor کا رضامندی کا صفحہ
5. ورک اسپیس اور اجازتیں منتخب کریں اور “اجازت دیں” پر کلک کریں

اس سیٹنگ کا نام ہر پروگرام میں مختلف ہوتا ہے۔ مثلاً MCP Inspector میں آپ “Streamable HTTP” ٹرانسپورٹ منتخب کرتے ہیں۔

#OAuth فلو تفصیل سے

1. کلائنٹ ٹوکن کے بغیر MCP سرور کو کال کرتا ہے اور ریسورس میٹا ڈیٹا کے حوالے کے ساتھ 401 پاتا ہے
2. وہ authorization سرور کا میٹا ڈیٹا پڑھتا ہے (اینڈپوائنٹس، سپورٹ شدہ طریقے، اجازتیں)
3. وہ خود کو رجسٹر کرتا ہے: Dynamic Client Registration کے ذریعے یا کسی https URL پر موجود کلائنٹ میٹا ڈیٹا دستاویز کے ساتھ
4. وہ براؤزر میں authorization درخواست کھولتا ہے، جس میں PKCE اور resource=https://dock.at-harbor.com/mcp شامل ہیں
5. آپ سائن اِن کرتے ہیں اور رضامندی کے صفحے پر فیصلہ کرتے ہیں
6. کلائنٹ کوڈ کے بدلے ایک access ٹوکن اور ایک refresh ٹوکن حاصل کرتا ہے

اگر کوئی کلائنٹ کوئی اجازت نہیں مانگتا تو تمام اجازتیں مانگی جاتی ہیں؛ آپ پھر بھی رضامندی کے صفحے پر انہیں محدود کر سکتے ہیں۔ اگر کوئی refresh ٹوکن جو پہلے ہی بدلا جا چکا ہو دوبارہ استعمال کیا جائے تو LinkHarbor سیکیورٹی کی وجہ سے پورا کنکشن ختم کر دیتا ہے۔

#ری ڈائریکٹ پتوں کے قواعد

• https پتے
• http صرف آپ کے اپنے کمپیوٹر کے loopback پتوں کے لیے (ڈیسک ٹاپ کلائنٹس اور IDEs کے لیے)
• ریورس ڈومین نوٹیشن میں ایپ کی اپنی اسکیمیں
• ہر کلائنٹ کے لیے زیادہ سے زیادہ 10 پتے، fragments کے بغیر

اگر کوئی ایپ ایسا پتہ بھیجے جو اس کے لیے رجسٹرڈ نہیں تو LinkHarbor رک جاتا ہے: “ایپ نے واپسی کا ایسا پتہ بھیجا جو اس کے لیے رجسٹرڈ نہیں۔ درخواست روک دی گئی۔”

#ڈیولپرز کے لیے ڈسکوری پتے

#نامعلوم ایپس

جن ایپس کے تمام ری ڈائریکٹ پتے claude.ai، claude.com، chatgpt.com یا openai.com پر ہوں، وہ معروف سمجھی جاتی ہیں۔ آپ کے اپنے کمپیوٹر کے وہ پروگرام جو localhost کے ذریعے واپس آتے ہیں – جیسے Claude Code، Codex اور IDEs – رضامندی کے صفحے پر یہ نوٹ دکھاتے ہیں: “LinkHarbor اس ایپ کو نہیں جانتا۔ یہ آپ کے اپنے کمپیوٹر پر چل رہی ہے۔ صرف تب جاری رکھیں جب آپ نے ابھی خود اسے شروع کیا ہو”، اور نیچے “انتخاب کے بعد آپ اپنے کمپیوٹر پر موجود ایپ پر واپس جائیں گے”۔ باقی نامعلوم ویب ایپس یہ نوٹ دکھاتی ہیں: “LinkHarbor اس ایپ کو نہیں جانتا۔ صرف تب جاری رکھیں جب آپ نے خود یہ شروع کیا ہو اور … پر بھروسا ہو”، جس میں … کی جگہ ان کا پتا ہوتا ہے۔ اگر آپ نے ابھی خود کلائنٹ سیٹ کیا ہے تو دونوں نوٹ معمول کی بات ہیں۔ لوگو صرف تب نظر آتا ہے جب ایپ اسے بھیجے۔ اگر سائن اِن آپ نے خود شروع نہیں کیا تو “مسترد کریں” پر کلک کریں۔