خوادم MCP

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

الخادم	URL	ما يفعله
واجهة برمجة تطبيقات المخزون	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 ساعات. يقوم عميل الذكاء الاصطناعي بتحديثها بصمت في الخلفية دون طلب تسجيل دخول مرة أخرى.

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

---

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

Claude Code

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

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

2. أضف خادم MCP الخاص بمخزون Wink:

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

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

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

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

لإضافة خادم التكاملات أيضًا:

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

شارك مع فريقك

أضف --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-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

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-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

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. أدخل عنوان خادم مخزون Wink:

   https://api.wink.travel/mcp

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

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

6. كرر الخطوتين 4–5 لخادم التكاملات:

   https://integrations.wink.travel/mcp

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-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

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-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

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-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

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

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

بديل: الإضافة عبر URL

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

---

النطاقات

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

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

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

---

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

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

قد لا يدعم عميل الذكاء الاصطناعي لديك تدفق 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-inventory
claude mcp add wink-inventory https://api.wink.travel/mcp --transport http

بالنسبة لـ Claude Desktop وChatGPT، احذف إدخال الخادم من الإعدادات، أعد تشغيل التطبيق، وأضفه مرة أخرى.

403 Forbidden عند استدعاء أداة معينة

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

يظهر الخادم لكن استدعاءات الأدوات تعيد “الحساب غير موجود”

أنت مسجل الدخول إلى حساب 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". ثم اذهب إلى الإعدادات → إعدادات 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