← 返回全部问题

MCP 服务器（Claude 与 AI 助手）

示意图：在 Claude Desktop 中填写 MCP 服务器地址，并粘贴您在 VinoCellar 应用中创建的访问令牌。

模型上下文协议（MCP）让兼容的 AI 助手（例如 Claude Desktop）在您同意的前提下操作酒窖：查看酒款、搜索、移动位置或添加葡萄酒。您只需在应用中复制服务器地址并创建个人访问令牌，无需编写代码。

VinoCellar MCP 服务器是什么？

它是酒窖数据与兼容 MCP 的软件之间的安全连接。完成首次配置后，助手可在订阅与账户规则允许的范围内读取或更新库存。

在 MCP 软件里应填写哪个地址？

确切地址显示在 VinoCellar 应用的「MCP」与访问令牌页面中的「MCP 服务器地址」区域，请完整复制，勿从旧截图手抄。

在公开发布的生产应用中，一般为 https://mcp.vinocellar.app 。若应用显示不同内容，请以应用内为准。

  1. 打开应用 → MCP（或 设置 → VinoCellar MCP → 管理令牌）。
  2. 在对应区域复制服务器地址。
  3. 在您的助手（如 Claude Desktop）中添加 MCP 服务器，并按该软件的帮助说明粘贴地址。
  4. 首次连接时，网页会引导您；在表单提示时粘贴应用中创建的个人令牌。

助手如何连接到我的酒窖？

您的电脑与 VinoCellar 之间通过安全的 HTTPS 连接通信；助手只能访问令牌所允许的内容。

首次连接时，程序通常会打开浏览器让您粘贴在应用中创建的令牌；VinoCellar 校验通过后，助手即可完成后续设置。

在应用中创建的令牌用于授权常见的酒窖操作（列表、搜索、格位布局、移动酒款、添加葡萄酒等）。

如何创建并使用个人访问令牌？

令牌用于向 MCP 服务器标识您的账户：

  1. 在应用中打开 MCP 页面并创建令牌。
  2. 填写清晰名称（例如「家里的电脑」「PC 上的 Claude」）。
  3. 立即复制令牌内容——仅显示一次。
  4. 若设备丢失或需断开某程序，可在同一页面撤销令牌。

请将令牌视为密码：在撤销前，持有令牌与服务器地址者可通过 MCP 访问您的酒窖。

通过 MCP 可以做哪些事？

在助手中添加服务器后，即可对酒窖执行多种操作，例如：

  • 确认已绑定的账户 并查看实用提示（欢迎信息、本 FAQ 链接、使用指引）。
  • 浏览或搜索 您的酒款（完整列表或关键词搜索）。
  • 查看酒窖 与格位布局，了解酒瓶所在位置。
  • 移动酒瓶 到其他格位或其他酒窖。
  • 添加葡萄酒 ——当助手已掌握足够信息时（可来自酒标或已整理的数据）；需账户保持有效的 MCP 订阅。

当前 MCP 不涵盖哪些能力？

MCP 仅支持上文描述的库存与酒窖相关操作。

应用内的 Vino 对话助手、餐酒搭配向导、品鉴日记等功能不能作为独立的远程 MCP 操作使用——请在移动应用或网页版中使用。

是否有面向公众的「传统」网页 API 代替 MCP？

推荐使用兼容 MCP 的助手（例如 Claude Desktop）：从应用复制服务器地址并创建个人令牌。

我们不另行公布需手动调用的「网页地址清单」来实现相同功能——您只需配置助手，由其自动发现 VinoCellar 中可用的操作。

MCP 订阅与积分有何不同？

积分主要用于应用内酒标扫描等 AI 流程。MCP 订阅单独计费：在订阅有效期内，经 MCP 服务器完成的受支持操作在 VinoCellar 侧通常不再按扫描积分余额同样方式封顶。

积分

  • 用于应用内 AI 扫描及相关流程。
  • 以套餐形式在应用内购买（一次性付款）。

MCP 订阅

  • 订阅有效期内，VinoCellar 侧 MCP 使用无用量上限。
  • 每月 3.99 欧元，无合约（上线促销 2.99 欧元/月）——适合经常在电脑上通过助手管理酒窖的用户。

支持哪些助手？

目前支持 Claude Desktop 及按本说明配置的其他 MCP 兼容软件。ChatGPT 与 Gemini 兼容性计划中，请关注更新说明与本 FAQ。