דלגו לתוכן

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

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


הוסיפו כל ערכת כלים ל-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 תמיד פועל כמשתמש מחובר. לקוח ה-AI מקבל את תחומי mcp.* דרך ההתחברות שלכם, לעולם לא מאפליקציה שיצרתם. אסימוני מכונה-למכונה (client-credentials) אינם יכולים לפתוח את תעבורת MCP; השתמשו ב-REST API לעבודה שרת-לשרת.
  • לקוח ה-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". עברו לSettings → Cursor Settings → MCP ולחצו Refresh. אם השגיאה נמשכת, אתחלו את Cursor במלואו — שינויים בקונפיגורציה לא תמיד נטענים ללא אתחול.

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

Windsurf דורש אתחול מלא (לא רק רענון חלון) כדי לטעון שינויים ב-mcp_config.json. השתמשו בFile → Quit ופתחו מחדש. אם השרתים עדיין לא מופיעים, ודאו שאתם בגרסה 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