跳到內容

MCP 伺服器

Wink 的 MCP 工具以 工具集 形式發布 — 專注的端點,每個端點涵蓋一項工作。您將 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 可用性的人與策劃聯盟登陸頁的人幾乎不共用工具。依工作分割,讓每個連線只帶有該工作的詞彙。


兩個主機提供工具集。工具數量為近似值,且持續增加。

端點工具數涵蓋範圍
/mcp/extranet/facilities約 64可預訂及現場庫存:客房與房型、SPA、餐廳、會議室、活動、景點、地點、其他可銷售項目
/mcp/extranet/property約 62物業紀錄與商業條款:檔案與內容、附加項目、取消政策、優惠、公告
/mcp/settings約 60帳戶管理:管理實體檔案與品牌、管理者及其授權、自訂、Webhook、通知偏好
/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)與相容的 付款錢包。新增 Wink MCP 後會開啟瀏覽器登入與權限選擇;您的用戶端接著處理認證。

Booking Engine 包含目的地查詢、飯店與房型搜尋、agentic_booking_quote、agentic_booking_pay、agentic_booking_book、訂單檢索與收據,當環境啟用代理訂房與付款時。詳見 Agentic Payments 了解連接設定、權限選擇及從搜尋到確認的步驟。


如果您是…連接至
整合頻道管理器、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 連線。

需要國家、貨幣與匯率、支援語言、時區、更廣泛地理搜尋、OTA 分類或公開物業知識等輔助查詢時,加入 /mcp/reference。這些為訂房流程的選用擴充。

從一個開始,當您發現它無法完成需求時再新增另一個 — 每個連線獨立,新增不會影響其他。


Wink MCP 伺服器使用 OAuth2 授權碼 + 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 代理。


將每個工具集新增為 Claude 的自訂連接器。無需編輯設定檔或建立應用程式與密鑰。

  1. 在 Claude 中,開啟 Customize › Connectors,點擊 Add,再選 Add custom connector。

  2. 輸入 名稱(例如 Wink Link manager),並在 MCP server URL 輸入上述 目錄 中的工具集 URL,例如:

    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.* 範圍的用戶端可存取任何 Wink MCP 端點,但每個工具仍會依其所屬端點的區段範圍執行權限檢查(例如 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 桌面版: 從應用程式內建更新器更新

登入後出現 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 「Connectors」選單消失

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 查詢。

Cline 無法看到「Add Server」選項

MCP 伺服器管理器需 Cline 2.0 或以上。開啟 VS Code 擴充套件面板,找到 Cline,若有更新按鈕請點擊更新。更新後重新載入 VS Code(Ctrl+Shift+P → 「Developer: Reload Window」)。


開啟 Wink Portal Wink GitHub 頁面