خوادم MCP

أدوات MCP الخاصة بـ Wink منشورة كـ مجموعات أدوات — نقاط نهاية مركزة، كل منها يغطي وظيفة واحدة. تقوم بربط عميل الذكاء الاصطناعي الخاص بك بنقطة نهاية واحدة أو اثنتين تتناسب مع عملك، وليس بكلها.

كل نقطة نهاية تستخدم تسجيل دخول OAuth2 تفاعلي (تدفق رمز التفويض PKCE): يفتح وكيل الذكاء الاصطناعي لديك تبويب متصفح، تقوم بتسجيل الدخول بحساب Wink الخاص بك، وهذا كل شيء. لا حاجة لإدارة أسرار العميل.

موصل مدير القنوات يتصل بنقطة نهاية واحدة

claude mcp add wink-channel-manager https://integrations.wink.travel/mcp/channel-manager --transport http

مدير فندق يدير أسعاره الخاصة يتصل بنقطة نهاية أخرى

claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

---

لماذا تم تقسيم الأدوات عبر نقاط النهاية

تكشف Wink عن حوالي 500 أداة. تسليم كل هذه الأدوات لوكيل دفعة واحدة ممكن تقنيًا — ولكنه فكرة سيئة.

تعريفات الأدوات تستهلك السياق. كل أداة يعلن عنها خادم MCP تُحمّل في نافذة سياق النموذج قبل أن يقوم بأي عمل، مع وصفها ومخطط المعلمات الكامل. خمسمائة من هذه تستهلك جزءًا كبيرًا من الميزانية التي يحتاجها مهمتك الفعلية، في كل طلب.

جودة الاختيار تنخفض مع زيادة القائمة. وكيل يختار من بين 500 أداة ذات أسماء متشابهة يتخذ قرارات أسوأ من وكيل يختار من 40 أداة فقط. إذا كنت تدمج مدير قنوات، فحوالي عشرين أداة ذات صلة بك؛ والباقي 480 أداة هي ضوضاء تجعل العثور على الأداة الصحيحة أصعب.

العمل قابل للفصل فعليًا. شخص يزامن التوافر من نظام إدارة الممتلكات (PMS) وشخص آخر ينشئ صفحات هبوط تابعة لا يشتركان تقريبًا في أي أدوات. التقسيم حسب الوظيفة يعني أن كل اتصال يحمل مفردات وظيفة واحدة.

مجموعات الأدوات ليست أذونات

اختيار مجموعة أدوات ضيقة لا يقيّد ما يمكن لحسابك القيام به، واختيار مجموعة واسعة لا يمنح أي شيء إضافي. كل أداة تفرض نفس أذونات الحساب كما في بوابة الويب، تحت هويتك المسجلة. إذا لم يكن حسابك قادرًا على إلغاء حجز في بوابة Wink، فالوكيل لا يمكنه ذلك أيضًا — بغض النظر عن نقطة النهاية المتصل بها.

اختر مجموعات الأدوات من أجل التركيز، وليس من أجل الأمان.

---

دليل نقاط النهاية

يخدم مضيفان مجموعات الأدوات. أعداد الأدوات تقريبية وتزداد مع الوقت.

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 — تكاملات مدير القنوات

نقطة نهاية واحدة، لأن هذا المضيف موجود لوظيفة واحدة.

نقطة النهاية	الأدوات	ما تغطيه
/mcp/channel-manager	~9	ربط والتحقق من تكامل مدير القنوات، PMS أو CRS

تكامل مدير القنوات مقابل إدارة الأسعار الخاصة بك

هذه وظائف مختلفة لأشخاص مختلفين، ولا يشتركون في نقطة نهاية واحدة.

يقوم بائع مدير القنوات، PMS أو CRS بالتكامل مرة واحدة عبر integrations.wink.travel/mcp/channel-manager، ومن ثم يتبادل الخصائص، الأسعار، التوافر والحجوزات عبر هذا التكامل. تلك النقطة النهاية الوحيدة هي السطح الكامل.

يستخدم مدير الفندق الذي يغير أسعاره يدويًا مجموعات أدوات الواجهة الخارجية على api.wink.travel — /mcp/extranet/rates وما شابه. هذه ليست جزءًا من تكامل مدير القنوات ولا يوجد سبب للموصل للاتصال بها.

إدارة الحساب أيضًا على api.wink.travel، في /mcp/settings. لا يوجد /mcp/settings على مضيف التكاملات.

كل نقطة نهاية تحمل أيضًا أداة ping، بحيث يمكنك التأكد من أن الاتصال مباشر قبل طلب عمل حقيقي.

المدفوعات الوكيلة

للحصول على تدفق الحجز الكامل للمسافر، اربط محرك حجز Wink على https://api.wink.travel/mcp/booking-engine ومحفظة دفع متوافقة. يفتح إضافة MCP الخاصة بـ Wink تسجيل دخول المتصفح واختيار الأذونات؛ ثم يتولى عميلك المصادقة.

يشمل محرك الحجز البحث عن الوجهة، البحث عن الفنادق والغرف، agentic_booking_quote، agentic_booking_pay، agentic_booking_book، استرجاع الحجوزات والإيصالات، عندما يتم تمكين الحجز والدفع الوكيلين لذلك البيئة. راجع المدفوعات الوكيلة لإعداد الاتصال، الأذونات التي يجب اختيارها، والخطوات من البحث إلى التأكيد.

---

ما مجموعات الأدوات التي أحتاجها؟

إذا كنت…	اتصل بـ
تدمج مدير قنوات، 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، أو معرفة عامة بالعقارات. هذه إضافات اختيارية لتدفق الحجز.

ابدأ بواحدة. أضف أخرى عندما تجد نفسك تطلب شيئًا لا تستطيع القيام به — كل اتصال مستقل، وإضافة واحدة لا تؤثر على الأخرى.

هل تريد كل شيء؟

https://api.wink.travel/mcp و https://integrations.wink.travel/mcp تبقيان متاحتين وتخدمان كل أداة على مضيفهما. هما مفيدان لاستكشاف الموجود، لكننا لا نوصي بهما للعمل اليومي: قائمة الأدوات كبيرة بما يكفي لتشتيت مهمتك وتقليل جودة اختيار الوكيل للأدوات. فضّل مجموعات الأدوات أعلاه.

---

كيف تعمل المصادقة

تستخدم خوادم MCP الخاصة بـ Wink تدفق رمز تفويض OAuth2 + PKCE وتدعم التسجيل الديناميكي للعميل (RFC 7591). هذا ما يحدث عند الاتصال لأول مرة:

1. يكتشف عميل الذكاء الاصطناعي خادم التفويض من بيانات التعريف /.well-known/oauth-protected-resource لنقطة نهاية MCP.
2. يقوم العميل بالتسجيل الذاتي عبر التسجيل الديناميكي للعميل — لا حاجة لإعداد يدوي للتطبيق.
3. يفتح العميل تبويب متصفح إلى https://iam.wink.travel. تقوم بتسجيل الدخول بحساب Wink الخاص بك وتوافق على الأذونات المطلوبة في شاشة الموافقة.
4. تصدر Wink رمز وصول مرتبط بحسابك ومرتبط بهويتك.
5. يرفق عميل الذكاء الاصطناعي الرمز بكل طلب MCP. كل نتائج الأدوات تُقيّد تلقائيًا بكيان الإدارة الخاص بك.
6. تنتهي صلاحية الرموز بعد 3 ساعات. يقوم عميل الذكاء الاصطناعي بتحديثها بصمت في الخلفية دون طلب منك مرة أخرى.

كل استدعاء أداة يعمل تحت هويتك — نفس قواعد التحكم في الوصول التي تحمي بوابة الويب تنطبق على وكيل الذكاء الاصطناعي.

---

اربط عميل الذكاء الاصطناعي الخاص بك

Claude Code

1. تأكد من تحديث Claude Code:

   npm install -g @anthropic-ai/claude-code

2. اختر مجموعة أدوات من الدليل أعلاه وأضفها. على سبيل المثال، الأسعار والتوافر:

   claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

3. يتصل Claude Code بالخادم، يكتشف خادم التفويض، ويفتح متصفحك الافتراضي.

4. سجّل الدخول إلى Wink ووافق على طلب الأذونات في شاشة الموافقة.

5. يؤكد Claude Code الاتصال. اكتب /mcp للتحقق من ظهور الخادم وتحميل أدواته.

أضف عددًا من مجموعات الأدوات حسب حاجة عملك — كل منها إدخال خادم منفصل باسمه الخاص:

claude mcp add wink-operations https://api.wink.travel/mcp/extranet/operations --transport http
claude mcp add wink-analytics  https://api.wink.travel/mcp/analytics           --transport http

تسجل الدخول مرة واحدة فقط. بعد الموافقة الأولى في المتصفح، يعيد Claude Code استخدام جلسة Wink الخاصة بك لنقاط نهاية Wink الإضافية.

شارك مع فريقك

أضف --scope project إلى claude mcp add ويكتب Claude Code عنوان URL للخادم في .mcp.json في جذر المستودع. قم بعمل commit لذلك الملف — يحصل كل عضو في الفريق على نفس مجموعات الأدوات، ويكمل كل منهم تسجيل الدخول في المتصفح الخاص به عند الاتصال لأول مرة.

Claude Desktop

1. حرر ملف تكوين 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

2. أضف إدخالات خوادم 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"
       }
     }
   }

3. أغلق وأعد تشغيل Claude Desktop بالكامل (استخدم Quit من شريط القائمة — إغلاق النافذة غير كافٍ).

4. يفتح Claude Desktop تبويب متصفح لكل خادم جديد. سجّل الدخول إلى Wink ووافق على الأذونات.

5. يظهر رمز القابس في شريط الأدوات السفلي كلا الخادمين متصلين.

OpenAI Codex

1. تأكد من تثبيت Codex CLI:

   npm install -g @openai/codex

2. افتح (أو أنشئ) ملف تكوين Codex:

   • macOS / Linux: ~/.codex/config.json
   • Windows: %USERPROFILE%\.codex\config.json

3. أضف إدخالات خوادم 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"
       }
     }
   }

4. ابدأ Codex. عند الاستخدام الأول، يفتح Codex تبويب متصفح إلى https://iam.wink.travel.

5. سجّل الدخول إلى Wink ووافق على الأذونات المطلوبة.

6. يؤكد Codex الاتصال. شغّل codex واطلب منه سرد الأدوات المتاحة للتحقق من نشاط خوادم Wink.

ملاحظة

يتطلب دعم MCP في Codex CLI الإصدار 1.0 أو أحدث. تحقق عبر codex --version، وقم بالتحديث عبر npm install -g @openai/codex.

ChatGPT

يتوفر دعم خوادم MCP في تطبيق ChatGPT لسطح المكتب لمشتركي Plus وPro وTeam وEnterprise.

1. حمّل وثبّت تطبيق ChatGPT لسطح المكتب إذا لم تكن قد فعلت ذلك.

2. افتح التطبيق وانقر على أيقونة ملفك الشخصي في الزاوية العلوية اليمنى، ثم اختر الإعدادات.

3. اذهب إلى الموصلات (أو خوادم MCP حسب إصدار التطبيق) وانقر إضافة.

4. أدخل عنوان URL لمجموعة أدوات من الدليل أعلاه، على سبيل المثال:

   https://api.wink.travel/mcp/extranet/rates

   ثم انقر اتصال.

5. يفتح ChatGPT تبويب متصفح إلى https://iam.wink.travel. سجّل الدخول إلى Wink ووافق على الأذونات.

6. كرر الخطوتين 4–5 لأي مجموعة أدوات أخرى يحتاجها عملك، على سبيل المثال:

   https://api.wink.travel/mcp/extranet/operations

7. تظهر كل مجموعة أدوات في قائمة الموصلات الخاصة بك. ابدأ محادثة جديدة — أدوات Wink متاحة تلقائيًا.

قيود تطبيق الويب

يمكن تكوين خوادم MCP فقط في تطبيق سطح المكتب. واجهة الويب لـ ChatGPT على chatgpt.com لا تدعم خوادم MCP المخصصة.

Cursor

1. افتح (أو أنشئ) ملف تكوين MCP الخاص بـ Cursor:

   • macOS / Linux: ~/.cursor/mcp.json
   • Windows: %USERPROFILE%\.cursor\mcp.json

2. أضف إدخالات خوادم 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"
       }
     }
   }

3. افتح Cursor. اذهب إلى الإعدادات → إعدادات Cursor → MCP وتأكد من ظهور كلا الخادمين مع مؤشر حالة أخضر. إذا كانا أحمرين، انقر تحديث.

4. يفتح Cursor تبويب متصفح إلى https://iam.wink.travel. سجّل الدخول إلى Wink ووافق على الأذونات.

5. افتح محادثة (Ctrl+L / Cmd+L) واطلب من Cursor سرد أدوات Wink المتاحة لتأكيد الاتصال.

تكوين خاص بالمشروع

يمكنك أيضًا وضع ملف mcp.json في جذر مشروعك بدلاً من ~/.cursor/. يأخذ تكوين المشروع الأولوية ويجعل الخوادم متاحة لكل عضو في الفريق يفتح المشروع في Cursor.

Windsurf

1. افتح (أو أنشئ) ملف تكوين MCP الخاص بـ Windsurf:

   • macOS / Linux: ~/.codeium/windsurf/mcp_config.json
   • Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

2. أضف إدخالات خوادم 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"
       }
     }
   }

3. أعد تشغيل Windsurf بالكامل (ملف → خروج، ثم أعد الفتح).

4. اذهب إلى الإعدادات → خوادم MCP وتحقق من ظهور كلا الخادمين متصلين. يفتح Windsurf تبويب متصفح إلى https://iam.wink.travel عند الاستخدام الأول.

5. سجّل الدخول إلى Wink ووافق على الأذونات. تتحول الخوادم إلى اللون الأخضر في لوحة الإعدادات بمجرد المصادقة.

ملاحظة

يتطلب دعم MCP في Windsurf الإصدار 1.4 أو أحدث. تحقق عبر مساعدة → حول Windsurf وقم بالتحديث من موقع Windsurf إذا لزم الأمر.

Cline (VS Code)

Cline هو امتداد لـ VS Code مع مدير خوادم MCP مدمج. لا حاجة لتحرير JSON يدويًا.

1. ثبّت Cline من سوق VS Code:

   • افتح VS Code واضغط Ctrl+Shift+X / Cmd+Shift+X
   • ابحث عن Cline وانقر تثبيت

2. انقر على أيقونة Cline في شريط النشاط (الشريط الجانبي الأيسر) لفتح لوحة Cline.

3. انقر على أيقونة خوادم MCP (أيقونة القابس) في شريط أدوات Cline، ثم اختر تحرير إعدادات MCP.

4. يفتح 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"
       }
     }
   }

5. احفظ الملف. يعيد Cline التحميل تلقائيًا ويفتح تبويب متصفح إلى https://iam.wink.travel.

6. سجّل الدخول إلى Wink ووافق على الأذونات. يظهر كلا الخادمين نشطين في لوحة خوادم MCP.

بديل: أضف عبر URL

في لوحة خوادم MCP، انقر إضافة خادم والصق عنوان URL لمجموعة أدوات مثل https://api.wink.travel/mcp/extranet/rates مباشرة. يقوم Cline بملء التكوين تلقائيًا ويتولى المصادقة دون الحاجة لتحرير JSON يدويًا.

---

النطاقات

عند الموافقة على شاشة الموافقة سترى تفصيلًا لما يطلبه الوكيل. يستخدم عملاء MCP نفس مفردات الأذونات كباقي المنصة — راجع المرجع الكامل للنطاقات في صفحة المصادقة.

هناك أمران خاصان بـ MCP:

• النطاقات mcp.read و mcp.write و mcp.remove مطلوبة أيضًا لفتح نقل MCP. العميل الذي يحمل نطاق mcp.* يُسمح له بالوصول إلى أي نقطة نهاية MCP في Wink، لكن كل أداة يستدعيها تفرض نطاق القسم الخاص بنقطة النهاية التي تغلفها (مثل booking.read).
• يطلب عميل الذكاء الاصطناعي فقط النطاقات التي يحتاجها. يمكنك رفض أذونات فردية في شاشة الموافقة — الأدوات التي تتطلب نطاقًا مرفوضًا ستُرجع خطأ عند استدعائها.

مجموعات الأدوات لا تغير أيًا من هذا. نقطة النهاية التي تتصل بها هي التي تقرر الأدوات التي تُدرج، وليس ما يُسمح لها بفعله. الاتصال بـ /mcp/payment لا يمنح أي إذن مالي لم تكن تملكه، والاتصال بـ /mcp/reference لا يمنع أداة هناك من فرض نطاقها الخاص. يتم تحديد التفويض لكل استدعاء أداة، من رمزك ومنح حسابك.

---

استكشاف الأخطاء وإصلاحها

لا يفتح تبويب المتصفح

قد لا يدعم عميل الذكاء الاصطناعي لديك تدفق PKCE التفاعلي بعد. تحقق من تشغيل إصدار حديث:

• Claude Code: npm install -g @anthropic-ai/claude-code
• Codex CLI: npm install -g @openai/codex
• Claude Desktop / ChatGPT لسطح المكتب: حدّث من المحدث المدمج في التطبيق

401 Unauthorized بعد تسجيل الدخول

قد يكون رمزك المخزن مؤقتًا قديمًا. أزل الخادم وأعد إضافته لتحفيز تسجيل دخول جديد:

# Claude Code
claude mcp remove wink-rates
claude 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 مخصص للبرامج المحلية فقط.

قائمة “الموصلات” في ChatGPT مفقودة

يتطلب دعم MCP إصدار تطبيق ChatGPT لسطح المكتب 1.2024.352 أو أحدث واشتراك Plus أو Pro أو Team أو Enterprise نشط. حدّث التطبيق وتحقق من خطتك في الإعدادات → الحساب.

خادم Cursor يظهر باللون الأحمر / “فشل الاتصال”

تحقق من أن ~/.cursor/mcp.json هو JSON صالح ويحتوي على "type": "http". ثم اذهب إلى الإعدادات → إعدادات Cursor → MCP وانقر تحديث. إذا استمر الخطأ، أعد تشغيل Cursor بالكامل — التغييرات في التكوين لا تُلتقط دائمًا بدون إعادة تشغيل.

خوادم MCP في Windsurf غير مدرجة في الإعدادات

يتطلب Windsurf إعادة تشغيل كاملة (ليس مجرد إعادة تحميل النافذة) لالتقاط تغييرات mcp_config.json. استخدم ملف → خروج ثم أعد التشغيل. إذا لم تظهر الخوادم، تأكد من أنك تستخدم Windsurf 1.4+ عبر مساعدة → حول Windsurf.

خيار “إضافة خادم” في Cline غير مرئي

يتطلب مدير خوادم MCP في Cline الإصدار 2.0 أو أحدث. افتح لوحة امتدادات VS Code، ابحث عن Cline، وانقر تحديث إذا كان متاحًا. بعد التحديث، أعد تحميل VS Code (Ctrl+Shift+P → “Developer: Reload Window”).

---

افتح بوابة Wink Wink على GitHub