تخطَّ إلى المحتوى

خوادم 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

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

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

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

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

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

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


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

نقطة النهايةالأدواتما تغطيه
/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، بحيث يمكنك التأكد من أن الاتصال حي قبل طلب عمل حقيقي.

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

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


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

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

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


تستخدم خوادم 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 التي تحمي بوابة الويب تنطبق على وكيل الذكاء الاصطناعي.


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

Section titled “اربط عميل الذكاء الاصطناعي الخاص بك”

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

  1. في Claude، افتح Customize › Connectors، انقر Add، ثم Add custom connector.

  2. أدخل اسم (مثلاً Wink Link manager) و، كـ عنوان خادم MCP، مجموعة أدوات من الدليل أعلاه، مثلاً:

    https://api.wink.travel/mcp/link-manager

    انقر Continue.

  3. يكتشف Claude تسجيل دخول Wink. احتفظ بـ Authentication: Sign in now و OAuth client: Register automatically، ثم انقر Add.

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

  5. أصبحت أدوات الموصل متاحة الآن في محادثاتك. كرر لكل مجموعة أدوات يحتاجها عملك؛ كل واحدة هي موصل مستقل.


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

قائمة “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