שרתי MCP
כלי MCP של Wink מפורסמים כערכות כלים — נקודות קצה ממוקדות, כל אחת מכסה משימה אחת. אתם מחברים את לקוח ה-AI שלכם לאחת או שתיים שמתאימות לעבודה שלכם, לא לכולן.
כל נקודת קצה משתמשת בהתחברות אינטראקטיבית ב-OAuth2 (זרימת קוד הרשאה PKCE): סוכן ה-AI שלכם פותח לשונית דפדפן, אתם נכנסים עם חשבון Wink שלכם, וזהו. אין צורך לנהל סודות לקוח.
claude mcp add wink-channel-manager https://integrations.wink.travel/mcp/channel-manager --transport httpclaude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport httpלמה הכלים מחולקים לנקודות קצה
Section titled “למה הכלים מחולקים לנקודות קצה”Wink מציגה כ-500 כלים. להעביר את כולם לסוכן בבת אחת אפשרי טכנית — אבל רעיון לא טוב.
הגדרות כלים צורכות הקשר. כל כלי ששרת MCP מפרסם נטען לחלון ההקשר של המודל לפני שהוא מבצע עבודה, יחד עם תיאורו ומבנה הפרמטרים המלא. חמש מאות כאלה צורכים חלק גדול מתקציב המשימה שלכם, בכל בקשה.
איכות הבחירה יורדת ככל שהרשימה גדלה. סוכן שבוחר מתוך 500 כלים עם שמות דומים עושה בחירות גרועות יותר מאחד שבוחר מתוך 40. אם אתם משתלבים עם מנהל ערוצים, כעשרים כלים רלוונטיים לכם; ה-480 הנותרים הם רעש שמקשה למצוא את הכלי הנכון.
העבודה ניתנת להפרדה אמיתית. מישהו שמסנכרן זמינות מ-PMS ומישהו שמנהל דפי שותפים כמעט ולא חולקים כלים. חלוקה לפי משימה אומרת שכל חיבור נושא את אוצר המילים של משימה אחת.
מדריך נקודות קצה
Section titled “מדריך נקודות קצה”שני מארחים משרתים ערכות כלים. מספר הכלים משוער וגדל עם הזמן.
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, כך שתוכלו לוודא שהחיבור חי לפני בקשת עבודה אמיתית.
תשלומים באמצעות סוכן
Section titled “תשלומים באמצעות סוכן”לזרימת הזמנה מלאה למטייל, חברו את 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 או 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 |
| מזמין חדר עם סוכן 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, או ידע ציבורי על נכסים. אלו תוספות אופציונליות לזרימת ההזמנה.
התחל עם אחת. הוסף נוספת כשאתה מוצא שאתה מבקש משהו שהיא לא יכולה לעשות — כל חיבור עצמאי, והוספת אחת לא משפיעה על האחרות.
איך האימות עובד
Section titled “איך האימות עובד”שרתי MCP של Wink משתמשים בזרימת OAuth2 Authorization Code + PKCE ותומכים ברישום דינמי של לקוח (RFC 7591). כך זה קורה כשאתם מתחברים בפעם הראשונה:
- לקוח ה-AI שלכם מגלה את שרת ההרשאה מתוך מטא-דאטה של נקודת הקצה MCP ב-
/.well-known/oauth-protected-resource. - הלקוח נרשם בעצמו דרך רישום דינמי של לקוח — אין צורך בהגדרת אפליקציה ידנית.
- הלקוח פותח לשונית דפדפן ל-
https://iam.wink.travel. אתם נכנסים עם חשבון Wink ומאשרים את ההרשאות המבוקשות במסך ההסכמה. - Wink מוציאה אסימון גישה שמוגבל לחשבון שלכם ומקושר לזהות שלכם.
- לקוח ה-AI מצרף את האסימון לכל בקשת MCP. כל תוצאות הכלים מוגבלות אוטומטית לישות הניהול שלכם.
- האסימונים פוקעים אחרי 3 שעות. לקוח ה-AI מרענן אותם בשקט ברקע ללא בקשה חוזרת.
כל קריאת כלי רצה מתחת לזהות שלכם — אותם כללי ACL שמגנים על פורטל האינטרנט חלים גם על סוכן ה-AI.
חברו את לקוח ה-AI שלכם
Section titled “חברו את לקוח ה-AI שלכם”-
ודאו ש-Claude Code מעודכן:
Terminal window npm install -g @anthropic-ai/claude-code -
בחרו ערכת כלים מה-המדריך למעלה והוסיפו אותה. לדוגמה, מחירים וזמינות:
Terminal window claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http -
Claude Code ייצור קשר עם השרת, יגלה את שרת ההרשאה, ויפתח את הדפדפן המוגדר כברירת מחדל.
-
התחברו ל-Wink ואשרו את בקשת ההרשאות במסך ההסכמה.
-
Claude Code מאשר את החיבור. הקלידו
/mcpכדי לוודא שהשרת מופיע וכליו נטענו.
הוסיפו כמה ערכות כלים שהעבודה שלכם דורשת — כל אחת היא כניסה נפרדת לשרת עם שם משלה:
claude mcp add wink-operations https://api.wink.travel/mcp/extranet/operations --transport httpclaude mcp add wink-analytics https://api.wink.travel/mcp/analytics --transport httpאתם נכנסים רק פעם אחת. לאחר האישור בדפדפן הראשון, Claude Code משתמש מחדש במפגש Wink שלכם לנקודות קצה נוספות.
-
ערכו את קובץ הקונפיגורציה של 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
- macOS:
-
הוסיפו את כניסות שרתי 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"}}} -
סגרו והפעילו מחדש את Claude Desktop (השתמשו ב-Quit מהסרגל — סגירת החלון לא מספיקה).
-
Claude Desktop פותח לשונית דפדפן לכל שרת חדש. התחברו ל-Wink ואשרו הרשאות.
-
סמל התקע בסרגל התחתון מציג את שני השרתים כמחוברים.
-
ודאו ש-Codex CLI מותקן:
Terminal window npm install -g @openai/codex -
פתחו (או צרו) את קובץ הקונפיגורציה של Codex:
- macOS / Linux:
~/.codex/config.json - Windows:
%USERPROFILE%\.codex\config.json
- macOS / Linux:
-
הוסיפו את כניסות שרתי 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"}}} -
הפעלו את Codex. בשימוש ראשון, Codex פותח לשונית דפדפן ל-
https://iam.wink.travel. -
התחברו ל-Wink ואשרו את ההרשאות המבוקשות.
-
Codex מאשר את החיבור. הריצו
codexובקשו רשימת כלים זמינים כדי לוודא ששרתי Wink פעילים.
תמיכת שרתי MCP זמינה באפליקציית ChatGPT למחשב למנויים Plus, Pro, Team ו-Enterprise.
-
הורידו והתקינו את אפליקציית ChatGPT למחשב אם עדיין לא עשיתם זאת.
-
פתחו את האפליקציה ולחצו על אייקון הפרופיל שלכם בפינה הימנית העליונה, ואז בחרו הגדרות.
-
עברו למחברים (או שרתי MCP בהתאם לגרסת האפליקציה) ולחצו על הוסף.
-
הזינו את כתובת ה-URL של ערכת כלים מה-המדריך למעלה, לדוגמה:
https://api.wink.travel/mcp/extranet/ratesואז לחצו התחבר.
-
ChatGPT פותח לשונית דפדפן ל-
https://iam.wink.travel. התחברו ל-Wink ואשרו הרשאות. -
חזרו על שלבים 4–5 עבור כל ערכת כלים שהעבודה שלכם דורשת, לדוגמה:
https://api.wink.travel/mcp/extranet/operations -
כל ערכת כלים מופיעה ברשימת המחברים שלכם. התחילו שיחה חדשה — כלי Wink זמינים אוטומטית.
-
פתחו (או צרו) את קובץ הקונפיגורציה של Cursor MCP:
- macOS / Linux:
~/.cursor/mcp.json - Windows:
%USERPROFILE%\.cursor\mcp.json
- macOS / Linux:
-
הוסיפו את כניסות שרתי 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"}}} -
פתחו את Cursor. עברו להגדרות → הגדרות Cursor → MCP ואשרו ששני השרתים מופיעים עם אינדיקטור מצב ירוק. אם הם אדומים, לחצו רענן.
-
Cursor פותח לשונית דפדפן ל-
https://iam.wink.travel. התחברו ל-Wink ואשרו הרשאות. -
פתחו שיחה (
Ctrl+L/Cmd+L) ובקשו מ-Cursor לרשום את כלי Wink הזמינים כדי לאשר את החיבור.
-
פתחו (או צרו) את קובץ הקונפיגורציה של Windsurf MCP:
- macOS / Linux:
~/.codeium/windsurf/mcp_config.json - Windows:
%USERPROFILE%\.codeium\windsurf\mcp_config.json
- macOS / Linux:
-
הוסיפו את כניסות שרתי 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"}}} -
אתחלו מחדש את Windsurf (קובץ → יציאה, ואז פתחו מחדש).
-
עברו להגדרות → שרתי MCP ואשרו ששני השרתים מופיעים כמחוברים. Windsurf פותח לשונית דפדפן ל-
https://iam.wink.travelבשימוש ראשון. -
התחברו ל-Wink ואשרו הרשאות. השרתים יהפכו לירוקים בפאנל ההגדרות לאחר אימות.
Cline היא תוסף ל-VS Code עם מנהל שרתי MCP מובנה. אין צורך בעריכת JSON ידנית.
-
התקינו את Cline מ-VS Code Marketplace:
- פתחו את VS Code ולחצו
Ctrl+Shift+X/Cmd+Shift+X - חפשו Cline ולחצו התקן
- פתחו את VS Code ולחצו
-
לחצו על אייקון Cline בסרגל הפעילות (סרגל צד שמאל) לפתיחת הפאנל.
-
לחצו על אייקון שרתי MCP (אייקון תקע) בסרגל הכלים של Cline, ואז בחרו ערוך הגדרות MCP.
-
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"}}} -
שמרו את הקובץ. Cline טוען מחדש אוטומטית ופותח לשונית דפדפן ל-
https://iam.wink.travel. -
התחברו ל-Wink ואשרו הרשאות. שני השרתים מופיעים כפעילים בפאנל שרתי MCP.
תחומי הרשאה
Section titled “תחומי הרשאה”כשאתם מאשרים את מסך ההסכמה תראו פירוט של מה שהסוכן מבקש. לקוחות MCP משתמשים באוצר מילים של הרשאות זהה לשאר הפלטפורמה — ראו את ההפניה המלאה לתחומי הרשאה בדף האימות.
שתי נקודות ספציפיות ל-MCP:
- תחומי ההרשאה
mcp.readmcp.writemcp.removeנדרשים בנוסף לפתיחת תחבורה MCP. לקוח שמחזיק תחוםmcp.*מתקבל לכל נקודת קצה MCP של Wink, אבל כל כלי שהוא מפעיל עדיין מאכף את תחום הסעיף של נקודת הקצה שהוא עוטף (למשלbooking.read). - לקוח ה-AI מבקש רק את התחומים שהוא צריך. ניתן לסרב להרשאות בודדות במסך ההסכמה — כלים שדורשים תחום שנדחה יחזירו שגיאה כשיפעילו אותם.
ערכות כלים אינן משנות את זה. נקודת הקצה שאליה אתם מתחברים מחליטה אילו כלים מופיעים, לא מה הם מורשים לעשות. חיבור ל-/mcp/payment אינו מעניק הרשאה פיננסית שלא הייתה לכם, וחיבור ל-/mcp/reference אינו מונע מכלי שם לאכוף את תחום ההרשאה שלו. האישור נקבע לפי קריאת כלי, מהאסימון שלכם ומההענקות של החשבון.
פתרון תקלות
Section titled “פתרון תקלות”לשונית דפדפן לא נפתחת
יתכן שלקוח ה-AI שלכם עדיין לא תומך בזרימת PKCE אינטראקטיבית. ודאו שאתם מריצים גרסה עדכנית:
- Claude Code:
npm install -g @anthropic-ai/claude-code - Codex CLI:
npm install -g @openai/codex - Claude Desktop / ChatGPT desktop: עדכנו דרך העדכון המובנה באפליקציה
401 Unauthorized לאחר התחברות
יתכן שהאסימון במטמון פג תוקף. הסירו והוסיפו מחדש את השרת כדי להפעיל התחברות חדשה:
# Claude Codeclaude mcp remove wink-ratesclaude 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
