رابط الخادم والنقل وتدفق OAuth لـ Cursor وMCP Inspector وعملاء MCP آخرين، مع كل عناوين الاكتشاف للمطوّرين.
إلى جانب Claude وChatGPT يعمل أي عميل MCP يدعم الخوادم البعيدة عبر HTTP وتسجيل الدخول عبر OAuth، مثل بيئات التطوير كـ Cursor، أو MCP Inspector للاختبار. هذه المقالة لكل من يعدّ مثل هذا العميل بنفسه أو يبني تكامله الخاص.
حقائق أساسية
- رابط الخادم
- https://dock.at-harbor.com/mcp
- النقل
- Streamable HTTP، دون حالة (stateless). كل طلب هو POST برسالة JSON-RPC (أو دفعة)، وتعود الاستجابة بصيغة JSON. لا يوجد معرّف جلسة ولا تدفق من الخادم.
- إصدارات البروتوكول
- 2025-11-25 و2025-06-18 و2025-03-26
- الطرق
- initialize وping وtools/list وtools/call. ولا يقدّم الخادم resources ولا prompts.
- تسجيل الدخول
- OAuth 2.1 مع PKCE (S256). دون رمز يستجيب الخادم بـ 401 ويشير إلى بياناته الوصفية في الترويسة WWW-Authenticate.
إعداد عميل
- في عميلك أضف خادم MCP بعيدًا (غالبًا يُسمّى «Remote» أو «HTTP» أو «Streamable HTTP»)
- أدخل https://dock.at-harbor.com/mcp كرابط
- اترك Client ID والسر فارغين؛ فالعميل يسجّل نفسه
- ابدأ الاتصال؛ يُفتح تسجيل الدخول في متصفحك، تليه صفحة الموافقة في LinkHarbor
- اختر مساحة العمل والأذونات وانقر «السماح»
يختلف اسم الإعداد من برنامج لآخر. في MCP Inspector مثلًا تختار النقل «Streamable HTTP».
تدفق OAuth بالتفصيل
- يستدعي العميل خادم MCP دون رمز فيحصل على 401 مع إشارة إلى البيانات الوصفية للمورد
- يقرأ البيانات الوصفية لخادم التفويض (نقاط النهاية والطرق المدعومة والأذونات)
- يسجّل نفسه: عبر Dynamic Client Registration أو بمستند بيانات وصفية للعميل على رابط https
- يفتح المتصفح بطلب التفويض، بما في ذلك PKCE وresource=https://dock.at-harbor.com/mcp
- تسجّل الدخول وتقرر في صفحة الموافقة
- يبدّل العميل الرمز (code) برمز وصول (access token) ورمز تحديث (refresh token)
| الخطوة | مدة الصلاحية |
|---|---|
| طلب تسجيل الدخول حتى قرارك | 10 دقائق |
| رمز التفويض | 60 ثانية، استخدام واحد |
| رمز الوصول | ساعة واحدة (1) |
| رمز التحديث | يتجدد مع كل استخدام؛ وتنتهي صلاحيته بعد 90 يومًا دون استخدام |
إذا لم يطلب العميل أي أذونات، تُطلب كلها؛ ويمكنك مع ذلك تضييقها في صفحة الموافقة. وإذا استُخدم رمز تحديث سبق استبداله مرة أخرى، ينهي LinkHarbor الاتصال كله لأسباب أمنية.
قواعد عناوين إعادة التوجيه
- عناوين https
- http فقط لعناوين loopback على حاسوبك (لعملاء سطح المكتب وبيئات التطوير)
- مخططات تطبيقات مخصصة بصيغة النطاق المعكوس
- 10 عناوين كحد أقصى لكل عميل، دون أجزاء (fragments)
إذا أرسل تطبيق عنوانًا غير مسجّل له، يتوقف 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 وبيئات التطوير، فتعرض في صفحة الموافقة الملاحظة «لا يعرف LinkHarbor هذا التطبيق. إنه يعمل على جهازك أنت. تابع فقط إذا كنت قد شغّلته بنفسك للتو»، وفي الأسفل «بعد اختيارك ستعود إلى التطبيق على جهازك». وتعرض تطبيقات الويب الأخرى غير المعروفة الملاحظة «لا يعرف LinkHarbor هذا التطبيق. تابع فقط إذا بدأت ذلك بنفسك وتثق في …» مع عنوانها مكان النقاط. والملاحظتان طبيعيتان إذا كنت قد أعددت العميل بنفسك للتو. ولا يظهر شعار إلا إذا أرسله التطبيق. وإذا لم تبدأ تسجيل الدخول بنفسك، فانقر «الرفض».
قد يفيدك أيضًا
لم تجد ما تبحث عنه؟
أخبرنا بما تحتاج إليه، وسيساعدك فريق الدعم لدينا شخصيًا.