דלגו לתוכן

שרתי MCP

כלי MCP של Wink מפורסמים כערכות כלים — נקודות קצה ממוקדות, כל אחת מכסה משימה אחת. אתם מחברים את לקוח ה-AI שלכם לאחת או שתיים שמתאימות לעבודה שלכם, לא לכולן.

כל נקודת קצה משתמשת בהתחברות אינטראקטיבית ב-OAuth2 (זרימת קוד הרשאה PKCE): סוכן ה-AI שלכם פותח לשונית דפדפן, אתם נכנסים עם חשבון 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 ומישהו שמנהל דפי שותפים כמעט ולא חולקים כלים. חלוקה לפי משימה אומרת שכל חיבור נושא את אוצר המילים של משימה אחת.


שני מארחים משרתים ערכות כלים. מספר הכלים משוער וגדל עם הזמן.

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אוספי קישורים מסונכרנים, העיצוב שלהם, קטגוריות ותוויות, בנוסף כתובות מקוצרות
/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 Booking Engine ב-https://api.wink.travel/mcp/booking-engine וארנק תשלום תואם. הוספת MCP של Wink פותחת התחברות בדפדפן ובחירת הרשאות; הלקוח שלכם מטפל באימות.

Booking Engine כולל חיפוש יעד, חיפוש מלון וחדר, agentic_booking_quote, agentic_booking_pay, agentic_booking_book, שליפת הזמנות וקבלות, כאשר הזמנה ותשלום סוכניים מופעלים לסביבה זו. ראו Agentic Payments להגדרת החיבור, ההרשאות לבחירה והשלבים מחיפוש לאישור.


אילו ערכות כלים אני צריך?

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
מזמין חדר עם סוכן AI/mcp/booking-engine + ארנק תשלום תואם — ראו Agentic Payments
בונה חווית הזמנה/mcp/booking-engine; אופציונלי /mcp/reference לעיונים נוספים

Booking Engine כולל את זרימת ההזמנה המרכזית. הוא מספק גילוי חשבון והתאמה אישית, חיפוש יעד, זמינות מלונות ופרטי מחירי חדרים, עגלות קניות, תשלום וניהול הזמנות מטיילים. כלים להזמנה ותשלום סוכניים כלולים גם כשהם מופעלים לסביבה זו.

לחיפוש מלון מבוסס עיר, השתמש ב-destination_lookup_search_suggestions לפתרון היעד, ואז ב-inventory_search_city למציאת מלונות זמינים ומחירים. שני הכלים נמצאים ב-/mcp/booking-engine, כך שזרימה זו אינה דורשת חיבור ל-Reference.

הוסף /mcp/reference כשאתה צריך עיונים תומכים כמו מדינות, מטבעות ושערי חליפין, שפות נתמכות, אזורי זמן, חיפושים גיאוגרפיים רחבים, סיווגי OTA, או ידע ציבורי על נכסים. אלו תוספות אופציונליות לזרימת ההזמנה.

התחל עם אחת. הוסף נוספת כשאתה מוצא שאתה מבקש משהו שהיא לא יכולה לעשות — כל חיבור עצמאי, והוספת אחת לא משפיעה על האחרות.


שרתי MCP של Wink משתמשים בזרימת OAuth2 Authorization Code + PKCE ותומכים ברישום דינמי של לקוח (RFC 7591). כך זה קורה כשאתם מתחברים בפעם הראשונה:

  1. לקוח ה-AI שלכם מגלה את שרת ההרשאה מתוך מטא-דאטה של נקודת הקצה MCP ב-/.well-known/oauth-protected-resource.
  2. הלקוח נרשם בעצמו דרך רישום דינמי של לקוח — אין צורך בהגדרת אפליקציה ידנית.
  3. הלקוח פותח לשונית דפדפן ל-https://iam.wink.travel. אתם נכנסים עם חשבון Wink ומאשרים את ההרשאות המבוקשות במסך ההסכמה.
  4. Wink מוציאה אסימון גישה שמוגבל לחשבון שלכם ומקושר לזהות שלכם.
  5. לקוח ה-AI מצרף את האסימון לכל בקשת MCP. כל תוצאות הכלים מוגבלות אוטומטית לישות הניהול שלכם.
  6. האסימונים פוקעים אחרי 3 שעות. לקוח ה-AI מרענן אותם בשקט ברקע ללא בקשה חוזרת.

כל קריאת כלי רצה מתחת לזהות שלכם — אותם כללי ACL שמגנים על פורטל האינטרנט חלים גם על סוכן ה-AI.


  1. ודאו ש-Claude Code מעודכן:

    Terminal window
    npm install -g @anthropic-ai/claude-code
  2. בחרו ערכת כלים מה-המדריך למעלה והוסיפו אותה. לדוגמה, מחירים וזמינות:

    Terminal window
    claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http
  3. Claude Code ייצור קשר עם השרת, יגלה את שרת ההרשאה, ויפתח את הדפדפן המוגדר כברירת מחדל.

  4. התחברו ל-Wink ואשרו את בקשת ההרשאות במסך ההסכמה.

  5. Claude Code מאשר את החיבור. הקלידו /mcp כדי לוודא שהשרת מופיע וכליו נטענו.

הוסיפו כמה ערכות כלים שהעבודה שלכם דורשת — כל אחת היא כניסה נפרדת לשרת עם שם משלה:

Terminal window
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 שלכם לנקודות קצה נוספות.


כשאתם מאשרים את מסך ההסכמה תראו פירוט של מה שהסוכן מבקש. לקוחות MCP משתמשים באוצר מילים של הרשאות זהה לשאר הפלטפורמה — ראו את ההפניה המלאה לתחומי הרשאה בדף האימות.

שתי נקודות ספציפיות ל-MCP:

  • תחומי ההרשאה mcp.read mcp.write mcp.remove נדרשים בנוסף לפתיחת תחבורה MCP. לקוח שמחזיק תחום mcp.* מתקבל לכל נקודת קצה MCP של Wink, אבל כל כלי שהוא מפעיל עדיין מאכף את תחום הסעיף של נקודת הקצה שהוא עוטף (למשל booking.read).
  • לקוח ה-AI מבקש רק את התחומים שהוא צריך. ניתן לסרב להרשאות בודדות במסך ההסכמה — כלים שדורשים תחום שנדחה יחזירו שגיאה כשיפעילו אותם.

ערכות כלים אינן משנות את זה. נקודת הקצה שאליה אתם מתחברים מחליטה אילו כלים מופיעים, לא מה הם מורשים לעשות. חיבור ל-/mcp/payment אינו מעניק הרשאה פיננסית שלא הייתה לכם, וחיבור ל-/mcp/reference אינו מונע מכלי שם לאכוף את תחום ההרשאה שלו. האישור נקבע לפי קריאת כלי, מהאסימון שלכם ומההענקות של החשבון.


לשונית דפדפן לא נפתחת

יתכן שלקוח ה-AI שלכם עדיין לא תומך בזרימת PKCE אינטראקטיבית. ודאו שאתם מריצים גרסה עדכנית:

  • Claude Code: npm install -g @anthropic-ai/claude-code
  • Codex CLI: npm install -g @openai/codex
  • Claude Desktop / ChatGPT desktop: עדכנו דרך העדכון המובנה באפליקציה

401 Unauthorized לאחר התחברות

יתכן שהאסימון במטמון פג תוקף. הסירו והוסיפו מחדש את השרת כדי להפעיל התחברות חדשה:

Terminal window
# 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.

השרת מופיע אבל קריאות כלים מחזירות “account not found”

אתם מחוברים לחשבון Wink שאין לו ישות ניהול. עברו ל-Wink Portal וודאו שהחשבון שלכם מוגדר לפני השימוש בשרת 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 מציג אדום / “Failed to connect”

ודאו ש-~/.cursor/mcp.json הוא JSON תקין וכולל "type": "http". עברו להגדרות → הגדרות Cursor → MCP ולחצו רענן. אם השגיאה נמשכת, אתחלו את Cursor מחדש — שינויים בקונפיגורציה לא תמיד נטענים ללא אתחול.

שרתי MCP של Windsurf לא מופיעים בהגדרות

Windsurf דורש אתחול מלא (לא רק רענון חלון) כדי לטעון שינויים ב-mcp_config.json. השתמשו בקובץ → יציאה ופתחו מחדש. אם השרתים עדיין לא מופיעים, ודאו שאתם בגרסה 1.4+ דרך עזרה → אודות Windsurf.

אפשרות “Add Server” ב-Cline לא נראית

מנהל שרתי MCP דורש Cline בגרסה 2.0 ומעלה. פתחו את פאנל התוספים ב-VS Code, מצאו את Cline ולחצו עדכן אם יש עדכון. לאחר העדכון, טענו מחדש את VS Code (Ctrl+Shift+P → “Developer: Reload Window”).


פתחו את פורטל Wink Wink ב-GitHub