שרתי 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

למה הכלים מחולקים לנקודות קצה

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

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

איכות הבחירה יורדת ככל שהרשימה גדלה. סוכן שבוחר מתוך 500 כלים עם שמות דומים עושה בחירות גרועות יותר מאשר סוכן שבוחר מתוך 40. אם אתם משתלבים עם מנהל ערוצים, כעשרים כלים רלוונטיים לכם; ה-480 הנותרים הם רעש שמקשה למצוא את הכלי הנכון.

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

מדריך נקודות קצה

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

`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` — אינטגרציות מנהל ערוצים

נקודת קצה אחת, כי מארח זה קיים למשימה אחת.

נקודת קצה	כלים	מה היא מכסה
`/mcp/channel-manager`	~9	חיבור ואימות מנהל ערוצים, PMS או אינטגרציית CRS

אלו משימות שונות לאנשים שונים, והן אינן חולקות נקודת קצה.

מנהל ערוצים, PMS או ספק CRS משתלב פעם אחת דרך integrations.wink.travel/mcp/channel-manager, ומאז מחליף נכסים, מחירים, זמינות והזמנות דרך האינטגרציה הזו. נקודת הקצה היחידה היא כל הממשק.

מלונאי שמשנה את המחירים שלו ידנית משתמש בערכות הכלים של האקסטרנאט ב-api.wink.travel — /mcp/extranet/rates וחברים. אלו אינם חלק מאינטגרציית מנהל ערוצים ואין למשתלב סיבה להתחבר אליהם.

ניהול חשבון גם הוא ב-api.wink.travel, ב-/mcp/settings. אין /mcp/settings במארח האינטגרציות.

כל נקודת קצה כוללת גם כלי ping, כך שתוכלו לוודא שהחיבור חי לפני שתבקשו עבודה אמיתית.

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

אם אתה…	התחבר אל
משתלב עם מנהל ערוצים, 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`
בונה חווית הזמנה	`/mcp/booking-engine` + `/mcp/reference`

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

איך האימות עובד

שרתי 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 שלכם

ודאו ש-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 http
claude 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

הוסיפו את כניסות שרתי MCP:

{
  "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

הוסיפו את כניסות שרתי MCP של Wink:

{
  "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

הוסיפו את כניסות שרתי MCP של Wink:

{
  "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

הוסיפו את כניסות שרתי MCP של Wink:

{
  "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 ולחצו התקן
לחצו על אייקון Cline בסרגל הפעילות (סרגל צד שמאל) כדי לפתוח את הפאנל של Cline.
לחצו על אייקון שרתי MCP (אייקון תקע) בסרגל הכלים של Cline, ואז בחרו ערוך הגדרות MCP.

VS Code פותח את cline_mcp_settings.json. הוסיפו את כניסות Wink:

{
  "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.

תחומי הרשאה

כשאתם מאשרים את מסך ההסכמה תראו פירוט של מה שהסוכן מבקש. לקוחות 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 לאחר התחברות

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

# 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 Portal וודאו שהחשבון שלכם מוגדר לפני השימוש בשרת MCP.

האסימון פג באמצע מושב

האסימונים תקפים ל-3 שעות. Claude Code ו-Claude Desktop מרעננים אסימונים בשקט ללא הפרעה למושב. אם אתם רואים שגיאות אימות לאחר תקופת חוסר פעילות ארוכה, הקלידו הודעה חדשה — הלקוח יאמת מחדש אוטומטית.

Codex CLI מציג “MCP server unreachable”

בדקו ש-~/.codex/config.json הוא JSON תקין (ללא פסיקים מיותרים) ושהשדה "type": "http" מוגדר. Codex דורש תחבורה HTTP לשרתים מרוחקים; תחבורה stdio מיועדת לבינאריים מקומיים בלבד.

תפריט “מחברים” ב-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.

אפשרות “הוסף שרת” ב-Cline לא נראית

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

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

שרתי MCP

למה הכלים מחולקים לנקודות קצה

מדריך נקודות קצה

https://api.wink.travel — הפלטפורמה

https://integrations.wink.travel — אינטגרציות מנהל ערוצים

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

איך האימות עובד

חברו את לקוח ה-AI שלכם

תחומי הרשאה

פתרון בעיות

`https://api.wink.travel` — הפלטפורמה

`https://integrations.wink.travel` — אינטגרציות מנהל ערוצים