خوادم MCP
أدوات MCP الخاصة بـ Wink منشورة كـ مجموعات أدوات — نقاط نهاية مركزة، كل منها يغطي وظيفة واحدة. تقوم بربط عميل الذكاء الاصطناعي الخاص بك بالنقطة أو النقطتين اللتين تتناسبان مع عملك، وليس بكلها.
كل نقطة نهاية تستخدم تسجيل دخول OAuth2 تفاعلي (تدفق رمز التفويض PKCE): يفتح وكيل الذكاء الاصطناعي لديك تبويب متصفح، تقوم بتسجيل الدخول بحساب Wink الخاص بك، وهذا كل شيء. لا حاجة لإدارة أسرار العميل.
claude mcp add wink-channel-manager https://integrations.wink.travel/mcp/channel-manager --transport httpclaude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport httpلماذا تم تقسيم الأدوات عبر نقاط نهاية
Section titled “لماذا تم تقسيم الأدوات عبر نقاط نهاية”تكشف Wink عن حوالي 500 أداة. تسليم كل هذه الأدوات لوكيل دفعة واحدة ممكن تقنيًا — ولكنه فكرة سيئة.
تعريفات الأدوات تستهلك السياق. كل أداة يعلن عنها خادم MCP تُحمّل في نافذة سياق النموذج قبل أن يقوم بأي عمل، مع وصفها ومخطط المعلمات الكامل. خمسمائة من هذه تستهلك جزءًا كبيرًا من الميزانية التي يحتاجها مهمتك الفعلية، في كل طلب.
جودة الاختيار تنخفض مع زيادة القائمة. وكيل يختار من بين 500 أداة ذات أسماء متشابهة يتخذ قرارات أسوأ من وكيل يختار من 40 أداة. إذا كنت تدمج مدير قناة، فحوالي عشرين أداة ذات صلة بك؛ والباقي 480 ضوضاء تجعل العثور على الأداة الصحيحة أصعب.
العمل قابل للفصل فعليًا. شخص يزامن التوافر من نظام إدارة الممتلكات (PMS) وشخص آخر ينشئ صفحات هبوط تابعة لا يشتركان تقريبًا في أي أدوات. التقسيم حسب الوظيفة يعني أن كل اتصال يحمل مفردات وظيفة واحدة.
دليل نقاط النهاية
Section titled “دليل نقاط النهاية”يخدم مضيفان مجموعات الأدوات. أعداد الأدوات تقريبية وتنمو مع الوقت.
https://api.wink.travel — المنصة
Section titled “https://api.wink.travel — المنصة”| نقطة النهاية | الأدوات | ما تغطيه |
|---|---|---|
/mcp/extranet/facilities | ~64 | الجرد القابل للحجز والموجود في الموقع: غرف الضيوف وأنواع الغرف، المنتجعات الصحية، المطاعم، غرف الاجتماعات، الأنشطة، المعالم، الأماكن، عناصر أخرى قابلة للبيع |
/mcp/extranet/property | ~62 | سجل العقار وشروطه التجارية: الملف الشخصي والمحتوى، الإضافات، سياسات الإلغاء، المزايا، الإعلانات |
/mcp/settings | ~60 | إدارة الحساب: ملف تعريف الكيان الإداري والعلامة التجارية، المديرون ومنحهم، التخصيص، الويب هوكس، تفضيلات الإشعارات |
/mcp/studio/embeds | ~48 | نشر الجرد المنسق: الأدوات، الشبكات والشبكات المرتبة، البطاقات، الخرائط، الروابط العميقة إلى الجرد وصفحات الموردين |
/mcp/extranet/rates | ~44 | الأسعار والتوافر: فترات وأسهم أسعار الجرد، خطط الأسعار، الأسعار الرئيسية، الأسعار الخاصة والترويجية |
/mcp/extranet/operations | ~39 | تشغيل عقار حي: الحجوزات ودورة حياتها، تقييمات الضيوف وردودهم، خلاصات التقويم، المهام المجدولة |
/mcp/extranet/distribution | ~37 | أماكن بيع الجرد: قنوات البيع ومعدلات التعديل، طلبات العلاقات مع الشركاء والموردين، التسجيل، التقاط العملاء المحتملين |
/mcp/studio/curation | ~35 | بناء مجموعات قابلة للتسويق: قوائم ثابتة وديناميكية، قوائم مرتبة، عمليات بحث محفوظة، تجميعات العقارات |
/mcp/link-manager | ~28 | مجموعات الروابط الموزعة، تصميمها، الفئات والعلامات، بالإضافة إلى عناوين URL المختصرة |
/mcp/reference | ~24 | بيانات البحث للقراءة فقط: البلدان، العملات وأسعار الصرف، اللغات، المناطق الزمنية، عمليات البحث الجغرافية، تحديد الموقع عبر IP |
/mcp/analytics | ~18 | تحليلات الحجز والإيرادات: نظرات عامة، مخططات خطية، لوحات المتصدرين، أداء الشركاء، مقاييس المشاركة |
/mcp/payment | ~18 | العمليات المالية: دفتر الأستاذ، السحوبات وتقديرات الرسوم، تجميعات أموال الحجز |
/mcp/booking-engine | ~17 | مسار التسوق الموجه للمسافر: البحث والبحث، عربة التسوق والدفع، قوائم الرغبات، تخصيص الحملات |
/mcp/social | ~17 | الحسابات الاجتماعية المتصلة، النشر والجدولة، قراءة تحليلات المنشورات |
/mcp/travel-agent | ~8 | الحجوزات التي يسهلها الوكيل نيابة عن المسافرين، وتقارير الوكيل |
https://integrations.wink.travel — تكاملات مدير القنوات
Section titled “https://integrations.wink.travel — تكاملات مدير القنوات”نقطة نهاية واحدة، لأن هذا المضيف موجود لوظيفة واحدة.
| نقطة النهاية | الأدوات | ما تغطيه |
|---|---|---|
/mcp/channel-manager | ~9 | ربط والتحقق من تكامل مدير القنوات، PMS أو CRS |
كل نقطة نهاية تحمل أيضًا أداة ping، بحيث يمكنك التأكد من أن الاتصال حي قبل طلب عمل حقيقي.
المدفوعات الوكيلة
Section titled “المدفوعات الوكيلة”لتدفق الحجز الكامل للمسافر، اربط محرك حجز Wink على https://api.wink.travel/mcp/booking-engine ومحفظة دفع متوافقة. يفتح إضافة MCP تسجيل دخول المتصفح واختيار الأذونات؛ ثم يتولى عميلك المصادقة.
يشمل محرك الحجز البحث عن الوجهة، البحث عن الفنادق والغرف، agentic_booking_quote، agentic_booking_pay، agentic_booking_book، استرجاع الحجوزات والإيصالات، عندما يتم تمكين الحجز والدفع الوكيلين لذلك البيئة. راجع المدفوعات الوكيلة لإعداد الاتصال، الأذونات التي يجب اختيارها، والخطوات من البحث إلى التأكيد.
ما مجموعات الأدوات التي أحتاجها؟
Section titled “ما مجموعات الأدوات التي أحتاجها؟”| إذا كنت… | اتصل بـ |
|---|---|
| تدمج مدير قناة، PMS أو CRS | integrations.wink.travel/mcp/channel-manager — فقط هذه |
| تدير محتوى عقار | /mcp/extranet/property + /mcp/extranet/facilities |
| تدير الغرف وأنواع الغرف | /mcp/extranet/facilities |
| تدير الأسعار والتوافر | /mcp/extranet/rates |
| تشغل الحجوزات اليومية | /mcp/extranet/operations |
| تنمي التوزيع | /mcp/extranet/distribution + /mcp/analytics |
| تبني صفحات تابعة | /mcp/studio/curation + /mcp/studio/embeds |
| تشغل صفحات الروابط في السيرة الذاتية | /mcp/link-manager + /mcp/social |
| تحجز نيابة عن المسافرين | /mcp/travel-agent |
| تسوي الأموال | /mcp/payment |
| تحجز غرفة مع وكيل ذكاء اصطناعي | /mcp/booking-engine + محفظة دفع متوافقة — راجع المدفوعات الوكيلة |
| تبني تجربة حجز | /mcp/booking-engine؛ اختياريًا /mcp/reference لعمليات البحث الإضافية |
يشمل محرك الحجز سير عمل الحجز الأساسي. يوفر اكتشاف الحساب والتخصيص، البحث عن الوجهة، توافر الفنادق وتفاصيل أسعار الغرف، عربات التسوق، الدفع، وإدارة حجز المسافر. كما تتضمن أدوات الحجز والدفع الوكيلين عند تمكينها لذلك البيئة.
للبحث عن فندق في مدينة، استخدم destination_lookup_search_suggestions لحل الوجهة، ثم inventory_search_city للعثور على الفنادق والأسعار المتاحة. كلا الأداتين في /mcp/booking-engine، لذا لا يتطلب هذا التدفق اتصالًا بـ Reference.
أضف /mcp/reference عندما تحتاج إلى عمليات بحث داعمة مثل البلدان، العملات وأسعار الصرف، اللغات المدعومة، المناطق الزمنية، عمليات البحث الجغرافية الأوسع، تصنيفات OTA، أو معرفة عامة بالعقارات. هذه إضافات اختيارية لتدفق الحجز.
ابدأ بواحدة. أضف أخرى عندما تجد نفسك تطلب شيئًا لا تستطيع القيام به — كل اتصال مستقل، وإضافة واحدة لا تؤثر على الأخرى.
كيف تعمل المصادقة
Section titled “كيف تعمل المصادقة”تستخدم خوادم MCP الخاصة بـ Wink تدفق رمز تفويض OAuth2 + PKCE وتدعم التسجيل الديناميكي للعميل (RFC 7591). هذا ما يحدث عند الاتصال لأول مرة:
- يكتشف عميل الذكاء الاصطناعي خادم التفويض من بيانات التعريف
/.well-known/oauth-protected-resourceلنقطة نهاية MCP. - يقوم العميل بالتسجيل الذاتي عبر التسجيل الديناميكي للعميل — لا حاجة لإعداد تطبيق يدوي.
- يفتح العميل تبويب متصفح إلى
https://iam.wink.travel. تقوم بتسجيل الدخول بحساب Wink الخاص بك وتوافق على الأذونات المطلوبة في شاشة الموافقة. - تصدر Wink رمز وصول مرتبط بحسابك وهويتك.
- يرفق عميل الذكاء الاصطناعي الرمز بكل طلب MCP. تُقيّد نتائج الأدوات تلقائيًا إلى كيان الإدارة الخاص بك.
- تنتهي صلاحية الرموز بعد 3 ساعات. يقوم عميل الذكاء الاصطناعي بتحديثها بصمت في الخلفية دون طلب منك مرة أخرى.
كل استدعاء أداة يعمل بموجب هويتك — نفس قواعد ACL التي تحمي بوابة الويب تنطبق على وكيل الذكاء الاصطناعي.
اربط عميل الذكاء الاصطناعي الخاص بك
Section titled “اربط عميل الذكاء الاصطناعي الخاص بك”أضف كل مجموعة أدوات إلى Claude كموصل مخصص. لا يوجد ملف تكوين لتحريره ولا حاجة لإنشاء تطبيق أو سر.
-
في Claude، افتح Customize › Connectors، انقر Add، ثم Add custom connector.
-
أدخل اسم (مثلاً Wink Link manager) و، كـ عنوان خادم MCP، مجموعة أدوات من الدليل أعلاه، مثلاً:
https://api.wink.travel/mcp/link-managerانقر Continue.
-
يكتشف Claude تسجيل دخول Wink. احتفظ بـ Authentication: Sign in now و OAuth client: Register automatically، ثم انقر Add.
-
انقر Connect. تفتح صفحة تسجيل دخول Wink على
https://iam.wink.travel. سجل الدخول إلى Wink ووافق على الأذونات في شاشة الموافقة. -
أصبحت أدوات الموصل متاحة الآن في محادثاتك. كرر لكل مجموعة أدوات يحتاجها عملك؛ كل واحدة هي موصل مستقل.
-
تأكد من تحديث Claude Code:
نافذة طرفيّة npm install -g @anthropic-ai/claude-code -
اختر مجموعة أدوات من الدليل أعلاه وأضفها. مثلاً، الأسعار والتوافر:
نافذة طرفيّة claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http -
يتصل Claude Code بالخادم، يكتشف خادم التفويض، ويفتح متصفحك الافتراضي.
-
سجل الدخول إلى Wink ووافق على طلب الأذونات في شاشة الموافقة.
-
يؤكد Claude Code الاتصال. اكتب
/mcpللتحقق من ظهور الخادم وتحميل أدواته.
أضف عددًا من مجموعات الأدوات حسب حاجة عملك — كل واحدة هي إدخال خادم منفصل باسم خاص بها:
claude mcp add wink-operations https://api.wink.travel/mcp/extranet/operations --transport httpclaude mcp add wink-analytics https://api.wink.travel/mcp/analytics --transport httpتسجل الدخول مرة واحدة فقط. بعد الموافقة الأولى في المتصفح، يعيد Claude Code استخدام جلسة Wink الخاصة بك لنقاط نهاية Wink الإضافية.
-
حرر ملف تكوين Claude Desktop:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
- macOS:
-
أضف إدخالات خوادم MCP:
claude_desktop_config.json {"mcpServers": {"wink-extranet-rates": {"type": "http","url": "https://api.wink.travel/mcp/extranet/rates"},"wink-extranet-operations": {"type": "http","url": "https://api.wink.travel/mcp/extranet/operations"}}} -
أغلق وأعد تشغيل Claude Desktop بالكامل (استخدم Quit من شريط القائمة — إغلاق النافذة غير كافٍ).
-
يفتح Claude Desktop تبويب متصفح لكل خادم جديد. سجل الدخول إلى Wink ووافق على الأذونات.
-
يظهر رمز القابس في شريط الأدوات السفلي كلا الخادمين متصلين.
-
تأكد من تثبيت Codex CLI:
نافذة طرفيّة npm install -g @openai/codex -
افتح (أو أنشئ) ملف تكوين Codex:
- macOS / Linux:
~/.codex/config.json - Windows:
%USERPROFILE%\.codex\config.json
- macOS / Linux:
-
أضف إدخالات خوادم MCP الخاصة بـ Wink:
~/.codex/config.json {"mcpServers": {"wink-extranet-rates": {"type": "http","url": "https://api.wink.travel/mcp/extranet/rates"},"wink-extranet-operations": {"type": "http","url": "https://api.wink.travel/mcp/extranet/operations"}}} -
ابدأ Codex. في الاستخدام الأول، يفتح Codex تبويب متصفح إلى
https://iam.wink.travel. -
سجل الدخول إلى Wink ووافق على الأذونات المطلوبة.
-
يؤكد Codex الاتصال. شغّل
codexواطلب منه سرد الأدوات المتاحة للتحقق من نشاط خوادم Wink.
دعم خوادم MCP متاح في تطبيق ChatGPT لسطح المكتب لمشتركي Plus وPro وTeam وEnterprise.
-
حمّل وثبّت تطبيق ChatGPT لسطح المكتب إذا لم تكن قد فعلت ذلك.
-
افتح التطبيق وانقر على رمز ملفك الشخصي في الزاوية العلوية اليمنى، ثم اختر الإعدادات.
-
اذهب إلى Connectors (أو MCP Servers حسب إصدار التطبيق) وانقر Add.
-
أدخل عنوان URL لمجموعة أدوات من الدليل أعلاه، مثلاً:
https://api.wink.travel/mcp/extranet/ratesثم انقر Connect.
-
يفتح ChatGPT تبويب متصفح إلى
https://iam.wink.travel. سجل الدخول إلى Wink ووافق على الأذونات. -
كرر الخطوتين 4–5 لأي مجموعة أدوات أخرى يحتاجها عملك، مثلاً:
https://api.wink.travel/mcp/extranet/operations -
تظهر كل مجموعة أدوات في قائمة الموصلات الخاصة بك. ابدأ محادثة جديدة — أدوات Wink متاحة تلقائيًا.
-
افتح (أو أنشئ) ملف تكوين MCP الخاص بـ Cursor:
- macOS / Linux:
~/.cursor/mcp.json - Windows:
%USERPROFILE%\.cursor\mcp.json
- macOS / Linux:
-
أضف إدخالات خوادم MCP الخاصة بـ Wink:
~/.cursor/mcp.json {"mcpServers": {"wink-extranet-rates": {"type": "http","url": "https://api.wink.travel/mcp/extranet/rates"},"wink-extranet-operations": {"type": "http","url": "https://api.wink.travel/mcp/extranet/operations"}}} -
افتح Cursor. اذهب إلى Settings → Cursor Settings → MCP وتأكد من ظهور كلا الخادمين مع مؤشر حالة أخضر. إذا ظهرا باللون الأحمر، انقر Refresh.
-
يفتح Cursor تبويب متصفح إلى
https://iam.wink.travel. سجل الدخول إلى Wink ووافق على الأذونات. -
افتح محادثة (
Ctrl+L/Cmd+L) واطلب من Cursor سرد أدوات Wink المتاحة لتأكيد الاتصال.
-
افتح (أو أنشئ) ملف تكوين MCP الخاص بـ Windsurf:
- macOS / Linux:
~/.codeium/windsurf/mcp_config.json - Windows:
%USERPROFILE%\.codeium\windsurf\mcp_config.json
- macOS / Linux:
-
أضف إدخالات خوادم MCP الخاصة بـ Wink:
~/.codeium/windsurf/mcp_config.json {"mcpServers": {"wink-extranet-rates": {"type": "http","url": "https://api.wink.travel/mcp/extranet/rates"},"wink-extranet-operations": {"type": "http","url": "https://api.wink.travel/mcp/extranet/operations"}}} -
أعد تشغيل Windsurf بالكامل (ملف → Quit، ثم أعد الفتح).
-
اذهب إلى Settings → MCP Servers وتحقق من ظهور كلا الخادمين متصلين. يفتح Windsurf تبويب متصفح إلى
https://iam.wink.travelعند الاستخدام الأول. -
سجل الدخول إلى Wink ووافق على الأذونات. تتحول الخوادم إلى اللون الأخضر في لوحة الإعدادات بمجرد المصادقة.
Cline هو امتداد لـ VS Code مع مدير خوادم MCP مدمج. لا حاجة لتحرير JSON يدويًا.
-
ثبّت Cline من سوق VS Code:
- افتح VS Code واضغط
Ctrl+Shift+X/Cmd+Shift+X - ابحث عن Cline وانقر Install
- افتح VS Code واضغط
-
انقر على رمز Cline في شريط النشاط (الشريط الجانبي الأيسر) لفتح لوحة Cline.
-
انقر على رمز خوادم MCP (رمز القابس) في شريط أدوات Cline، ثم اختر Edit MCP Settings.
-
يفتح VS Code ملف
cline_mcp_settings.json. أضف إدخالات Wink:cline_mcp_settings.json {"mcpServers": {"wink-extranet-rates": {"type": "http","url": "https://api.wink.travel/mcp/extranet/rates"},"wink-extranet-operations": {"type": "http","url": "https://api.wink.travel/mcp/extranet/operations"}}} -
احفظ الملف. يعيد Cline التحميل تلقائيًا ويفتح تبويب متصفح إلى
https://iam.wink.travel. -
سجل الدخول إلى Wink ووافق على الأذونات. يظهر كلا الخادمين نشطين في لوحة خوادم MCP.
النطاقات
Section titled “النطاقات”عند الموافقة على شاشة الموافقة سترى تفصيلًا لما يطلبه الوكيل. يستخدم عملاء MCP نفس مفردات الأذونات كباقي المنصة — راجع المرجع الكامل للنطاقات في صفحة المصادقة.
ثلاثة أشياء خاصة بـ MCP:
- النطاقات
mcp.readوmcp.writeوmcp.removeمطلوبة أيضًا لفتح نقل MCP. العميل الذي يحمل نطاقmcp.*يُسمح له بالوصول إلى أي نقطة نهاية MCP في Wink، لكن كل أداة يستدعيها تفرض نطاق القسم الخاص بنقطة النهاية التي تغلفها (مثلاًbooking.read). - MCP يعمل دائمًا كمستخدم مسجل دخول. يحصل عميل الذكاء الاصطناعي على نطاقات
mcp.*من تسجيل دخولك، وليس من تطبيق تنشئه. رموز الجهاز إلى الجهاز (client-credentials) لا يمكنها فتح نقل MCP؛ استخدم REST API للعمل بين الخوادم. - يطلب عميل الذكاء الاصطناعي فقط النطاقات التي يحتاجها. يمكنك رفض أذونات فردية في شاشة الموافقة — الأدوات التي تتطلب نطاقًا مرفوضًا سترجع خطأ عند استدعائها.
مجموعات الأدوات لا تغير أيًا من هذا. نقطة النهاية التي تتصل بها تحدد الأدوات المدرجة، وليس ما يسمح لها به. الاتصال بـ /mcp/payment لا يمنح أي إذن مالي لم تكن تملكه مسبقًا، والاتصال بـ /mcp/reference لا يمنع أداة هناك من فرض نطاقها الخاص. يتم تحديد التفويض لكل استدعاء أداة، من رمزك ومنح حسابك.
استكشاف الأخطاء وإصلاحها
Section titled “استكشاف الأخطاء وإصلاحها”لا يفتح تبويب المتصفح
قد لا يدعم عميل الذكاء الاصطناعي لديك تدفق PKCE التفاعلي بعد. تحقق من أنك تستخدم إصدارًا حديثًا:
- Claude Code:
npm install -g @anthropic-ai/claude-code - Codex CLI:
npm install -g @openai/codex - Claude Desktop / ChatGPT لسطح المكتب: حدّث من المحدث المدمج في التطبيق
401 Unauthorized بعد تسجيل الدخول
قد يكون رمزك المخزن مؤقتًا قديمًا. أزل وأعد إضافة الخادم لتحفيز تسجيل دخول جديد:
# Claude Codeclaude mcp remove wink-ratesclaude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport httpلـ Claude Desktop وChatGPT، أزل إدخال الخادم من الإعدادات، أعد تشغيل التطبيق، وأضفه مرة أخرى.
403 Forbidden عند استدعاء أداة معينة
تتطلب الأداة نطاقًا لم توافق عليه في شاشة الموافقة، أو إذنًا لا يملكه حسابك. أعد الاتصال بالخادم — ستظهر شاشة الموافقة مجددًا ويمكنك الموافقة على الإذن المفقود. إذا استمر الفشل، تحتاج الأداة إلى إذن حساب لا تملكه؛ الاتصال بمجموعة أدوات مختلفة لن يساعد، لأن مجموعات الأدوات لا تمنح أذونات.
الأداة التي أحتاجها غير موجودة في القائمة
ربما تكون متصلًا بمجموعة أدوات لا تغطي تلك الوظيفة. تحقق من دليل نقاط النهاية وأضف مجموعة الأدوات التي تغطيها — الاتصالات مستقلة، لذا إضافة واحدة لا تغير شيئًا في الأخرى. إذا لم تكن متأكدًا من أيها تحتويها، اتصل مؤقتًا بـ https://api.wink.travel/mcp، ابحث عن الأداة، ثم تحقق من مجموعة الأدوات التي تسردها.
404 Not Found على نقطة نهاية مجموعة أدوات
تحقق من المسار بعناية — مجموعات الأدوات المتداخلة لها قسمان (/mcp/extranet/rates، وليس /mcp/extranet-rates)، والمجموعات المسطحة لها قسم واحد (/mcp/link-manager). لاحظ أن الطلب غير المصادق إلى أي مسار تحت /mcp يرجع 401، وليس 404، لذا 401 وحده لا يخبرك بوجود نقطة النهاية.
اتصلت بـ api.wink.travel/mcp/channel-manager ولم يحدث شيء
تلك النقطة غير موجودة. تكامل مدير القنوات يخدم فقط من https://integrations.wink.travel/mcp/channel-manager. إذا كنت تحتاج أيضًا لقراءة أو كتابة أسعار عقار يدويًا، فهذه وظيفة منفصلة على نقطة نهاية منفصلة — راجع /mcp/extranet/rates.
يظهر الخادم لكن استدعاءات الأدوات ترجع “الحساب غير موجود”
أنت مسجل دخول بحساب Wink لا يملك كيان إدارة. اذهب إلى بوابة Wink وتأكد من إعداد حسابك قبل استخدام خادم MCP.
تنتهي صلاحية الرمز أثناء الجلسة
الرموز صالحة لمدة 3 ساعات. يقوم Claude Code وClaude Desktop بتحديث الرموز بصمت دون مقاطعة جلستك. إذا رأيت أخطاء مصادقة بعد فترة خمول طويلة، اكتب رسالة جديدة — سيعيد العميل المصادقة تلقائيًا.
Codex CLI يظهر “MCP server unreachable”
تحقق من أن ~/.codex/config.json هو JSON صالح (بدون فواصل زائدة) وأن "type": "http" مضبوط. يتطلب Codex نقل HTTP للخوادم البعيدة؛ نقل stdio مخصص للبرامج المحلية فقط.
قائمة “Connectors” في ChatGPT مفقودة
يتطلب دعم MCP إصدار تطبيق ChatGPT لسطح المكتب 1.2024.352 أو أحدث واشتراك Plus أو Pro أو Team أو Enterprise نشط. حدّث التطبيق وتحقق من خطتك في الإعدادات → الحساب.
خادم Cursor يظهر باللون الأحمر / “فشل الاتصال”
تحقق من أن ~/.cursor/mcp.json هو JSON صالح ويحتوي على "type": "http". ثم اذهب إلى Settings → Cursor Settings → MCP وانقر Refresh. إذا استمر الخطأ، أعد تشغيل Cursor بالكامل — لا يتم دائمًا التقاط تغييرات التكوين بدون إعادة تشغيل.
خوادم Windsurf MCP غير مدرجة في الإعدادات
يتطلب Windsurf إعادة تشغيل كاملة (ليس مجرد إعادة تحميل النافذة) لالتقاط تغييرات mcp_config.json. استخدم File → Quit وأعد التشغيل. إذا لم تظهر الخوادم، تحقق من أنك تستخدم Windsurf 1.4+ عبر Help → About Windsurf.
خيار “Add Server” في Cline غير مرئي
يتطلب مدير خوادم MCP في Cline الإصدار 2.0 أو أحدث. افتح لوحة امتدادات VS Code، ابحث عن Cline، وانقر Update إذا كان هناك تحديث متاح. بعد التحديث، أعد تحميل VS Code (Ctrl+Shift+P → “Developer: Reload Window”).
افتح بوابة Wink Wink على GitHub
