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 客户端会在后台静默刷新，无需再次提示。

每个工具调用均以您的身份运行 — 保护 Web 门户的相同 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

与团队共享

添加 --scope project 到 claude mcp add 命令，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 服务器支持适用于 Plus、Pro、Team 和 Enterprise 订阅用户的ChatGPT 桌面应用。

1. 如果尚未安装，请下载并安装 ChatGPT 桌面应用。

2. 打开应用，点击右上角的个人资料图标，选择设置。

3. 进入连接器（或根据应用版本为MCP 服务器），点击添加。

4. 输入 Wink Inventory 服务器 URL：

   https://api.wink.travel/mcp

   然后点击连接。

5. ChatGPT 会打开浏览器标签页访问 https://iam.wink.travel。登录 Wink 并批准权限。

6. 对 Integrations 服务器重复步骤 4–5：

   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 是一个带内置 MCP 服务器管理器的 VS Code 扩展。无需手动编辑 JSON。

1. 从 VS Code 市场安装 Cline：

   • 打开 VS Code，按 Ctrl+Shift+X / Cmd+Shift+X
   • 搜索 Cline 并点击安装

2. 点击活动栏（左侧边栏）中的 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 并批准权限。两个服务器会显示为活动状态。

替代方案：通过 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 服务器无法访问”

检查您的 ~/.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 → “开发者：重载窗口”）。

---

打开 Wink 门户 Wink 的 GitHub