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 可用性的人和策划联盟落地页的人几乎不共享工具。按任务拆分意味着每个连接只携带一个任务的词汇。

工具集不是权限

选择狭窄的工具集不会限制您的账户权限，选择广泛的工具集也不会授予额外权限。每个工具都在您登录身份下执行与网页版门户相同的账户权限。如果您的账户无法在 Wink 门户取消预订，代理也无法——无论连接哪个端点。

选择工具集是为了专注，而非安全。

---

端点目录

两个主机提供工具集。工具数量为近似值，且随时间增长。

https://api.wink.travel — 平台

端点	工具数	覆盖内容
/mcp/extranet/facilities	~64	可预订及现场库存：客房及房型、水疗、餐厅、会议室、活动、景点、场所及其他可销售项目
/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 — 渠道管理集成

一个端点，因为该主机只为一个任务存在。

端点	工具数	覆盖内容
/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

从一个开始。当您发现它无法满足需求时，再添加另一个——每个连接独立，添加一个不会影响其他。

仍想要全部工具？

https://api.wink.travel/mcp 和 https://integrations.wink.travel/mcp 仍可用，提供其主机上的所有工具。它们适合探索现有工具，但不推荐日常使用：工具列表过大，会干扰任务并降低代理的工具选择质量。优先选择上述工具集。

---

认证工作原理

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. 从上方目录选择一个工具集并添加。例如，价格和可用性：

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

3. Claude Code 联系服务器，发现授权服务器，并打开默认浏览器。

4. 登录 Wink 并在同意屏幕批准权限请求。

5. 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 端点重用您的 Wink 会话。

与团队共享

向 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-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"
       }
     }
   }

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

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. 输入上方目录中的工具集 URL，例如：

   https://api.wink.travel/mcp/extranet/rates

   然后点击连接。

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

6. 对工作所需的其他工具集重复步骤 4–5，例如：

   https://api.wink.travel/mcp/extranet/operations

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

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

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 图标 打开面板。

3. 点击 Cline 工具栏中的 MCP 服务器图标（插头图标），选择编辑 MCP 设置。

4. 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"
       }
     }
   }

5. 保存文件。 Cline 自动重载并打开浏览器标签页至 https://iam.wink.travel。

6. 登录 Wink 并批准权限。两个服务器在 MCP 服务器面板显示为激活状态。

替代：通过 URL 添加

在 MCP 服务器面板点击添加服务器，直接粘贴工具集 URL（如 https://api.wink.travel/mcp/extranet/rates）。Cline 会自动填充配置并处理认证，无需手动编辑 JSON。

---

权限范围

在您批准同意屏幕时，会看到代理请求的权限细分。MCP 客户端使用与平台其他部分相同的权限词汇——详见 认证页面的完整范围参考。

MCP 特有两点：

• mcp.read、mcp.write、mcp.remove 范围是打开 MCP 传输的额外必需权限。 持有 mcp.* 范围的客户端可访问任何 Wink MCP 端点，但调用的每个工具仍执行其所属端点的分区权限（如 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 桌面: 通过应用内置更新器更新

登录后出现 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 服务器”

检查 ~/.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