MCP 伺服器
Wink 的 MCP 工具以 工具集 形式發布 — 專注的端點,每個端點涵蓋一項工作。您將 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 可用性的人與策劃聯盟登陸頁的人幾乎不共用工具。依工作分割,讓每個連線只帶有該工作的詞彙。
兩個主機提供工具集。工具數量為近似值,且持續增加。
https://api.wink.travel — 平台端點
Section titled “https://api.wink.travel — 平台端點”| 端點 | 工具數 | 涵蓋範圍 |
|---|---|---|
/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 了解連接設定、權限選擇及從搜尋到確認的步驟。
我需要哪些工具集?
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 連線。
需要國家、貨幣與匯率、支援語言、時區、更廣泛地理搜尋、OTA 分類或公開物業知識等輔助查詢時,加入 /mcp/reference。這些為訂房流程的選用擴充。
從一個開始,當您發現它無法完成需求時再新增另一個 — 每個連線獨立,新增不會影響其他。
認證流程說明
Section titled “認證流程說明”Wink MCP 伺服器使用 OAuth2 授權碼 + 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 的自訂連接器。無需編輯設定檔或建立應用程式與密鑰。
-
在 Claude 中,開啟 Customize › Connectors,點擊 Add,再選 Add custom connector。
-
輸入 名稱(例如 Wink Link manager),並在 MCP server URL 輸入上述 目錄 中的工具集 URL,例如:
https://api.wink.travel/mcp/link-manager點擊 Continue。
-
Claude 偵測到 Wink 登入。保持 Authentication: Sign in now 與 OAuth client: Register automatically,然後點擊 Add。
-
點擊 Connect。瀏覽器分頁會開啟 Wink 登入頁面
https://iam.wink.travel。登入 Wink 並在同意畫面批准權限。 -
連接器的工具現已可於聊天中使用。依工作需求重複新增其他工具集;每個工具集為獨立連接器。
-
確認 Claude Code 已更新:
終端機視窗 npm install -g @anthropic-ai/claude-code -
從上述 目錄 選擇工具集並新增。例如價格與可用性:
終端機視窗 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 會話以連接其他 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(使用選單列的退出,僅關閉視窗不夠)。
-
Claude Desktop 會為每個新伺服器開啟瀏覽器分頁。登入 Wink 並批准權限。
-
底部工具列的插頭圖示會顯示兩個伺服器皆已連接。
-
確認已安裝 Codex CLI:
終端機視窗 npm install -g @openai/codex -
開啟(或建立)Codex 設定檔:
- macOS / Linux:
~/.codex/config.json - Windows:
%USERPROFILE%\.codex\config.json
- macOS / Linux:
-
新增 Wink MCP 伺服器條目:
~/.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 桌面應用程式。
-
開啟應用程式,點擊右上角的 個人資料圖示,選擇 設定。
-
前往 Connectors(或依版本為 MCP Servers),點擊 Add。
-
輸入上述 目錄 中的工具集 URL,例如:
https://api.wink.travel/mcp/extranet/rates點擊 Connect。
-
ChatGPT 會開啟瀏覽器分頁至
https://iam.wink.travel。登入 Wink 並批准權限。 -
重複步驟 4–5,新增其他工作所需工具集,例如:
https://api.wink.travel/mcp/extranet/operations -
每個工具集會出現在您的 Connectors 清單中。開始新聊天 — Wink 工具會自動可用。
-
開啟(或建立)Cursor MCP 設定檔:
- macOS / Linux:
~/.cursor/mcp.json - Windows:
%USERPROFILE%\.cursor\mcp.json
- macOS / Linux:
-
新增 Wink MCP 伺服器條目:
~/.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。前往 Settings → Cursor Settings → MCP,確認兩個伺服器皆顯示綠色狀態指示。若顯示紅色,點擊 Refresh。
-
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:
-
新增 Wink MCP 伺服器條目:
~/.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(檔案 → 退出,然後重新開啟)。
-
前往 Settings → MCP Servers,確認兩個伺服器皆顯示已連接。首次使用時 Windsurf 會開啟瀏覽器分頁至
https://iam.wink.travel。 -
登入 Wink 並批准權限。認證完成後,設定面板中的伺服器會變綠。
Cline 是 VS Code 擴充套件,內建 MCP 伺服器管理器。無需手動編輯 JSON。
-
從 VS Code Marketplace 安裝 Cline:
- 開啟 VS Code,按
Ctrl+Shift+X/Cmd+Shift+X - 搜尋 Cline,點擊 Install
- 開啟 VS Code,按
-
點擊活動列(左側邊欄)的 Cline 圖示 開啟面板。
-
點擊工具列的 MCP Servers 圖示(插頭圖示),選擇 Edit MCP Settings。
-
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 Servers 面板顯示為啟用狀態。
權限範圍 (Scopes)
Section titled “權限範圍 (Scopes)”當您批准同意畫面時,會看到代理請求的權限細項。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 Codeclaude mcp remove wink-ratesclaude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport httpClaude 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 頁面
