跳转到内容

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可预订及现场库存:客房及房型、水疗、餐厅、会议室、活动、景点、地点及其他可销售项目
/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 工具,您可以在请求实际工作前确认连接是否活跃。

完整旅客预订流程,请连接 https://api.wink.travel/mcp/booking-engine 的 Wink 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 服务器 URL,填写上文目录中的工具集地址,例如:

    https://api.wink.travel/mcp/link-manager

    点击 Continue。

  3. Claude 会检测到 Wink 登录。保持 Authentication: Sign in now 和 OAuth client: Register automatically,然后点击 Add。

  4. 点击 Connect。浏览器打开 https://iam.wink.travel 的 Wink 登录页面。登录 Wink 并在同意屏幕批准权限。

  5. 连接器的工具现在可在聊天中使用。根据工作需要重复添加每个工具集;每个都是独立连接器。


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

MCP 特有三点:

  • 额外需要 mcp.read、mcp.write、mcp.remove 权限范围以开启 MCP 传输。持有 mcp.* 权限的客户端可访问任何 Wink MCP 端点,但调用的每个工具仍执行其端点对应的权限范围(如 booking.read)。
  • MCP 始终以登录用户身份操作。 AI 客户端通过您的登录获得 mcp.* 权限,而非您创建的应用。机器对机器(客户端凭证)令牌无法开启 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 服务器无法访问”

检查 ~/.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 门户 Wink 的 GitHub