MCP 伺服器

Wink 提供兩個經過驗證的 MCP 伺服器。兩者皆使用 互動式 OAuth2 登入（PKCE 授權碼流程）— 您的 AI 代理會開啟瀏覽器分頁，讓您使用 Wink 帳號登入。無需管理客戶端密鑰。

伺服器	URL	功能說明
Inventory API	https://api.wink.travel/mcp	庫存、訂單、價格、銷售渠道、分析及所有平台操作
Integrations	https://integrations.wink.travel/mcp	渠道管理整合 — 與 OTA 同步物業、價格與可用性

---

認證運作方式

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 代理。

---

連接您的 AI 用戶端

Claude Code

1. 確認 Claude Code 已更新：

   npm install -g @anthropic-ai/claude-code

2. 新增 Wink Inventory MCP 伺服器：

   claude mcp add wink-inventory https://api.wink.travel/mcp --transport http

3. Claude Code 會聯絡伺服器，發現授權伺服器並開啟預設瀏覽器。

4. 登入 Wink 並在同意畫面批准權限請求。

5. Claude Code 確認連線。輸入 /mcp 以驗證伺服器是否出現且工具已載入。

若要同時新增 Integrations 伺服器：

claude mcp add wink-integrations https://integrations.wink.travel/mcp --transport http

與團隊共享

在 claude mcp add 指令中加入 --scope project，Claude Code 會將伺服器 URL 寫入專案根目錄的 .mcp.json。提交該檔案後，每位團隊成員首次連接時完成自己的瀏覽器登入。

Claude Desktop

1. 編輯 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

2. 新增 MCP 伺服器條目：

   claude_desktop_config.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

3. 完全退出並重新啟動 Claude Desktop（使用選單列的退出，僅關閉視窗不夠）。

4. Claude Desktop 會為每個新伺服器開啟瀏覽器分頁。登入 Wink 並批准權限。

5. 底部工具列的插頭圖示會顯示兩個伺服器皆已連接。

OpenAI Codex

1. 確認已安裝 Codex CLI：

   npm install -g @openai/codex

2. 開啟（或建立）Codex 設定檔：

   • macOS / Linux: ~/.codex/config.json
   • Windows: %USERPROFILE%\.codex\config.json

3. 新增 Wink MCP 伺服器條目：

   ~/.codex/config.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

4. 啟動 Codex。首次使用時，Codex 會開啟瀏覽器分頁至 https://iam.wink.travel。

5. 登入 Wink 並批准所需權限。

6. Codex 確認連線。執行 codex 並請它列出可用工具，以驗證 Wink 伺服器已啟用。

注意

Codex CLI MCP 支援需版本 1.0 或以上。執行 codex --version 檢查，並使用 npm install -g @openai/codex 升級。

ChatGPT

MCP 伺服器支援適用於 ChatGPT 桌面應用程式，限 Plus、Pro、Team 及 Enterprise 訂閱者。

1. 若尚未安裝，請下載並安裝 ChatGPT 桌面應用程式。

2. 開啟應用程式，點擊右上角的 個人資料圖示，選擇 設定。

3. 前往 連接器（或依版本顯示為 MCP 伺服器），點擊 新增。

4. 輸入 Wink Inventory 伺服器 URL：

   https://api.wink.travel/mcp

   然後點擊 連接。

5. ChatGPT 會開啟瀏覽器分頁至 https://iam.wink.travel。登入 Wink 並批准權限。

6. 重複步驟 4–5 新增 Integrations 伺服器：

   https://integrations.wink.travel/mcp

7. 兩個伺服器會出現在您的連接器清單中。開始新聊天 — Wink 工具會自動可用。

網頁版限制

MCP 伺服器僅能在 桌面應用程式中設定。ChatGPT 網頁介面（chatgpt.com）不支援自訂 MCP 伺服器。

Cursor

1. 開啟（或建立）Cursor MCP 設定檔：

   • macOS / Linux: ~/.cursor/mcp.json
   • Windows: %USERPROFILE%\.cursor\mcp.json

2. 新增 Wink MCP 伺服器條目：

   ~/.cursor/mcp.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

3. 開啟 Cursor。前往 設定 → Cursor 設定 → MCP，確認兩個伺服器皆顯示綠色狀態指示。若顯示紅色，點擊 重新整理。

4. Cursor 會開啟瀏覽器分頁至 https://iam.wink.travel。登入 Wink 並批准權限。

5. 開啟聊天（Ctrl+L / Cmd+L），請 Cursor 列出可用 Wink 工具以確認連線。

專案範圍設定

您也可以將 mcp.json 檔案放在專案根目錄，取代放在 ~/.cursor/。專案層級設定優先，並讓每位開啟該專案的團隊成員都能使用伺服器。

Windsurf

1. 開啟（或建立）Windsurf MCP 設定檔：

   • macOS / Linux: ~/.codeium/windsurf/mcp_config.json
   • Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

2. 新增 Wink MCP 伺服器條目：

   ~/.codeium/windsurf/mcp_config.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

3. 完全重新啟動 Windsurf（檔案 → 退出，然後重新開啟）。

4. 前往 設定 → MCP 伺服器，確認兩個伺服器皆顯示已連接。首次使用時 Windsurf 會開啟瀏覽器分頁至 https://iam.wink.travel。

5. 登入 Wink 並批准權限。認證成功後，伺服器在設定面板中會變成綠色。

注意

Windsurf MCP 支援需版本 1.4 或以上。請透過 說明 → 關於 Windsurf 檢查，並從 Windsurf 官網更新。

Cline (VS Code)

Cline 是 VS Code 擴充套件，內建 MCP 伺服器管理器，無需手動編輯 JSON。

1. 從 VS Code Marketplace 安裝 Cline：

   • 開啟 VS Code，按 Ctrl+Shift+X / Cmd+Shift+X
   • 搜尋 Cline 並點擊 安裝

2. 點擊活動列（左側邊欄）的 Cline 圖示 開啟 Cline 面板。

3. 點擊 Cline 工具列的 MCP 伺服器圖示（插頭圖示），選擇 編輯 MCP 設定。

4. VS Code 會開啟 cline_mcp_settings.json。新增 Wink 條目：

   cline_mcp_settings.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

5. 儲存檔案。 Cline 會自動重新載入並開啟瀏覽器分頁至 https://iam.wink.travel。

6. 登入 Wink 並批准權限。兩個伺服器會在 MCP 伺服器面板中顯示為啟用狀態。

替代方案：透過 URL 新增

在 MCP 伺服器面板點擊 新增伺服器，直接貼上 https://api.wink.travel/mcp。Cline 會自動填入設定並處理認證，無需手動編輯 JSON。

---

權限範圍

當您在同意畫面批准時，會看到代理請求的權限細項。MCP 用戶端使用與平台其他部分相同的權限詞彙 — 請參考完整的認證頁面權限範圍參考。

MCP 特有的兩點：

• 必須額外擁有 mcp.read、mcp.write、mcp.remove 權限範圍才能開啟 MCP 傳輸。持有 mcp.* 權限的用戶端可進入 /mcp，但每個工具仍會強制執行其包裝端點的區段權限（例如 booking.read）。
• AI 用戶端只請求所需的權限範圍。 您可在同意畫面拒絕個別權限 — 需要被拒絕權限的工具在呼叫時會回傳錯誤。

---

疑難排解

瀏覽器分頁未開啟

您的 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-inventory
claude mcp add wink-inventory https://api.wink.travel/mcp --transport http

Claude Desktop 和 ChatGPT 請從設定中移除伺服器條目，重啟應用程式後再新增。

呼叫特定工具時出現 403 Forbidden

該工具需要您在同意畫面未批准的權限範圍。重新連接伺服器 — 同意畫面會再次出現，您可批准缺少的權限。

伺服器出現但工具呼叫回傳「找不到帳號」

您登入的 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 伺服器顯示紅色 / 「連線失敗」

請確認您的 ~/.cursor/mcp.json 是有效 JSON 且包含 "type": "http"。接著前往 設定 → Cursor 設定 → MCP 點擊 重新整理。若錯誤持續，請完全重啟 Cursor — 設定變更有時需重啟才能生效。

Windsurf MCP 伺服器未出現在設定中

Windsurf 需完全重啟（非僅重新載入視窗）才能讀取 mcp_config.json 變更。請使用 檔案 → 退出 並重新啟動。若仍未出現，請確認您使用 Windsurf 1.4+ 版本（透過 說明 → 關於 Windsurf）。

Cline 「新增伺服器」選項未顯示

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

---

開啟 Wink Portal Wink GitHub 頁面