连接 AI 助手
你可以把 ChatGPT、Claude 或 Codex 等 AI 助手连接到你的 FMX EPOS Cloud 账号。之后助手可以回答有关门店的问题,例如昨天的销售额或哪些商品已售罄,也可以按你的要求做修改,例如改价格。助手以你的身份操作,范围限于连接时你允许的门店和权限。
所有助手都连接到同一个 FMX EPOS Cloud 地址,即 Cloud 中 AI Connections 页面上显示的 Connector Address。你在 FMX EPOS Cloud 自己的页面上登录,所以助手看不到你的 Cloud 密码。
连接后可以问什么,请阅读日常使用 AI 助手。要修改或结束连接,或者遇到问题,请阅读管理 AI 连接和解决问题。
任何 FMX EPOS Cloud 账号都可以连接助手,范围以账号角色允许的为限:
- Owner:可连接其名下的门店;
- Store Manager:可连接 Owner 分配给他们的门店。
FMX EPOS 为每个角色设定了在每个方面最多能给助手的权限。某个方面没有 View and Change 选项,就表示你的角色目前不能给出这项权限,请联系 FMX EPOS 技术支持。有些修改只能通过 Owner 的连接进行:订单规则、会员方案、添加或移除 Store Manager、新的桌台二维码、网站的名称、标语、联系方式和状态,以及作用于 Owner 所有门店的网站设置。Store Manager 可以修改自己门店网站的外观。
每个账号对每个助手只有一个连接。再次连接同一个助手会替换之前的连接,之前的连接随即失效。在网页版 ChatGPT 中,FMX EPOS 插件和手动添加的自定义 MCP 服务器算作同一个助手。ChatGPT 桌面应用以 Codex 的身份登录时(见下文),这个连接属于 Codex,与 ChatGPT 的连接分开。
连接 ChatGPT
Section titled “连接 ChatGPT”FMX EPOS 已列入 ChatGPT 的插件目录,供英国用户使用。你可以在网页版 ChatGPT 或 ChatGPT 桌面应用中安装。
- 在 ChatGPT 侧栏中选择插件,打开插件目录。
- 搜索 FMX EPOS 并打开。
- 选择安装插件。如果 ChatGPT 要求连接,选择连接。FMX EPOS Cloud 会在新窗口中打开。
- 如有要求,用 Cloud 邮箱和密码登录。
- 在授权页面上核对账号,选择允许的范围(见授权页面),然后选择 Allow。
- 回到 ChatGPT,开始新对话,询问门店情况,例如“你能看到哪些 FMX EPOS 门店?”
ChatGPT 会在你的请求需要时使用这个插件。你也可以在输入框中输入 @ 和插件名称,自己选用。能否安装插件取决于你的 ChatGPT 套餐和工作区。在公司工作区中,可能需要管理员先允许 FMX EPOS。
在 ChatGPT 桌面应用中,授权页面的标题可能是 Connect Codex,Sign-in returns to 下显示 An app on this computer。这是正常的,因为桌面应用通过你电脑上的 Codex 登录。如果是你自己在桌面应用中发起的登录,就选择允许。
连接 Claude
Section titled “连接 Claude”在 Claude 中,FMX EPOS 是一个连接器。它在 Claude 的连接器中列为社区连接器,表示 Anthropic 已对它做过自动审核,但没有验证。你可以在网页版 Claude 或 Claude 桌面应用中连接。
- 在 Claude 中,选择侧栏底部你的名字,然后选择设置(Settings)。
- 在自定义(Customize)下选择连接器(Connectors)。
- 搜索 FMX EPOS 并打开。
- 选择连接到 Claude(Connect to Claude)。FMX EPOS Cloud 随即打开。
- 如有要求,用 Cloud 邮箱和密码登录。
- 在授权页面上核对账号,选择允许的范围(见授权页面),然后选择 Allow。
- 回到 Claude,连接器显示已连接(Connected)。
Recents
Friday staff rotaSupplier price listWeekend specials示意图,不是截图。实际界面可能因主题或版本而有所不同。
在对话中使用:
- 在新对话中选择 +,再选择连接器(Connectors)。
- 查看 FMX EPOS 旁边的开关。FMX EPOS 连接后,开关是开启的。不想让 Claude 在这个对话中使用 FMX EPOS 时,把它关闭。
- 询问门店情况,例如“你能看到哪些 FMX EPOS 门店?”
Skills Connectors Add plugins
FMX EPOS
Tool access
示意图,不是截图。实际界面可能因主题或版本而有所不同。
如果使用 Claude Team 或 Enterprise 套餐,可能需要 Claude 组织的所有者先添加 FMX EPOS,你才能连接。
连接 Codex
Section titled “连接 Codex”把 FMX EPOS 作为 MCP 服务器添加到 Codex:
- 在 FMX EPOS Cloud 中,打开 Account 下的 AI Connections,复制 Connector Address。
- 在 Codex 的设置中添加 MCP 服务器。填写名称,例如 fmx-epos,然后粘贴 Connector Address。
- Codex 提示时登录。如果它没有自动打开登录,在 Codex 设置中该服务器的条目里开始登录。
- 用 Cloud 账号登录,并在授权页面上允许连接。
- 在 Codex 中开始新对话使用。
Codex 通过你自己电脑上的应用登录。此时授权页面会说登录将返回 An app on this computer(这台电脑上的应用),并提醒你只有在自己从该应用发起登录时才允许,因为这台电脑上的任何程序都可以发起这种请求。
连接 Claude Code
Section titled “连接 Claude Code”在 Claude Code 中用以下命令添加服务器,把 <Connector Address> 换成 AI Connections 中的 Connector Address:
claude mcp add --transport http fmx-epos <Connector Address>然后输入 /mcp,选择 fmx-epos 并登录。Claude Code 和 Codex 一样通过你自己的电脑登录,所以授权页面会显示 An app on this computer,并给出同样的提醒。
手动添加服务器
Section titled “手动添加服务器”如果无法从目录安装 FMX EPOS,可以把服务器作为自定义连接器或自定义 MCP 服务器添加到助手中。
- 在 FMX EPOS Cloud 侧栏的 Account 下打开 AI Connections。Connect an AI Client 卡片显示 Connector Address,复制这个地址。
- 在 ChatGPT 中,从插件目录添加自定义 MCP 服务器。视你的套餐而定,ChatGPT 可能会要求先开启开发者模式。在 Claude 中,打开设置,再打开连接器,选择添加,然后选择自定义连接器。
- 填写名称,例如 FMX EPOS,然后粘贴 Connector Address。如果助手询问登录方式,选择 OAuth。
- 开始连接。FMX EPOS Cloud 随即打开,按上文登录并允许连接。
无论用哪种方式添加,只有 FMX EPOS 已设置好的助手才能连接。
授权页面的标题是 Connect 加上助手名称,并说明助手将以你的身份、在你允许的门店和权限范围内操作。从上往下处理:
- 核对 Signed in as。
- 核对 Sign-in returns to。
- 选择 Stores。
- 为每个方面设置 Access。
- 选择 Allow;不想连接就选择 Deny。
示意图,不是截图。实际界面可能因主题或版本而有所不同。
Signed in as
Section titled “Signed in as”Signed in as 显示你正在连接的 Cloud 账号的姓名和邮箱。助手将以这个账号的身份操作。
如果账号不对,选择 Use Another Account。Cloud 会退出登录并显示登录页面。用另一个账号登录后,同一个助手的授权页面会再次打开。
如果输错密码,登录页面会显示 The email or password is not correct. Five wrong passwords lock the account for 15 minutes.(邮箱或密码不正确。输错五次密码会锁定账号 15 分钟。)同一网络尝试次数过多时,会显示 Too many sign-in attempts from this network. Try again in 15 minutes.(此网络登录尝试次数过多,请 15 分钟后再试。)登录成功后,仍会回到授权页面。如果页面显示 This sign-in page was out of date. Sign in again.(此登录页面已过时,请重新登录。),重新登录后也会回到授权页面。
Sign-in returns to
Section titled “Sign-in returns to”Sign-in returns to 显示 Cloud 把结果发送到哪里:助手的网址,例如 chatgpt.com 或 claude.ai;Codex、Claude Code 和 ChatGPT 桌面应用则显示 An app on this computer。如果显示的地址出乎你的意料,选择 Deny。
Stores
Section titled “Stores”在 Stores 下选择:
- All stores:你的所有门店,包括以后添加的门店;
- Only the stores I choose:勾选门店。以后添加的门店需要在 AI Connections 中另行授予。
第一次连接某个助手时,默认选中 All stores。再次连接同一个助手时,页面沿用其连接原有的门店。已释放的门店不会提供给新连接。再次连接时,之前的连接中已释放的门店仍留在列表中,名称后标有 (released)。
门店选择不限制 Owner 面向其所有门店的网站。Owner 建立的任何连接都可以读取这个网站;如果 Online Ordering & Websites 设为 View and Change,还可以修改它。不想让助手修改,就把这个方面设为 View。设为 No Access 时,助手也无法读取这个网站。
Access
Section titled “Access”在 Access 下,为每个方面选择 No Access、View 或 View and Change。只会提供你的角色可以给出的级别。你的角色完全不能给出的方面,或助手没有请求的方面,不会显示。
| 方面 | 包括 |
|---|---|
| Store Operations | 概览、销售报表、订单、平台订单、实时状态和 Store Manager。 |
| Menus & Sales | 菜单、售罄、餐厅、平台映射、会员、优惠券、销售设置和员工。 |
| Online Ordering & Websites | 在线点餐、桌台点餐和网站,包括二维码。 |
| Integrations | Stripe 和其他服务是否已设置。只能查看,也看不到密钥。 |
| Customer Personal Data | 顾客的姓名、电话号码、电子邮箱和地址,顾客列表和来电。 |
| Restaurant Bookings | 由 Cloud 确认订座的门店的订座及订座设置。助手新建、修改、批准、拒绝或取消的订座,如果有邮箱地址,会发邮件通知顾客。 |
每个方面一开始都设为你的账号能给该助手的最高级别。选择 Allow 之前,把不想让它使用的方面调低。
顾客个人数据
Section titled “顾客个人数据”只有给了 Customer Personal Data,助手才能看到顾客信息。没有这项权限时,姓名、电话号码、电子邮箱和地址显示为 “(hidden)”,订单备注被隐藏,订单只能按订单号搜索,顾客列表和来电也无法使用。订座会显示时间、人数和桌台,但顾客的姓名、电话、邮箱、备注和原因显示为 “(hidden)”,也不能按顾客搜索订座。只有在需要助手处理顾客信息时,才给出这项权限。
要订座,或修改订座上顾客的姓名、电话、邮箱或关联顾客,助手除了需要 Restaurant Bookings 的 View and Change 权限,还需要 Customer Personal Data 的 View and Change 权限。其他订座修改,例如改时间或人数,只需要 Restaurant Bookings。
Allow 或 Deny
Section titled “Allow 或 Deny”选择 Allow 保存连接并回到助手。选择 Deny 则不建立任何连接,助手会被告知你没有允许连接。
如页面所提示,之后可以在 AI Connections 中修改或结束连接。
授权页面上的提示
Section titled “授权页面上的提示”| 提示 | 处理方法 |
|---|---|
| This AI client is not registered with FMX EPOS Cloud. Contact FMX EPOS support and name the AI client you used.(此 AI 客户端未在 FMX EPOS Cloud 注册。请联系 FMX EPOS 技术支持,并说明你使用的 AI 客户端。) | FMX EPOS 还没有设置该助手。请联系 FMX EPOS 技术支持。更常见的情况是登录在授权页面之前就中断,并显示来自 FMX EPOS Cloud 或助手的错误。 |
| Choose at least one store.(至少选择一家门店。) | 你选择了 Only the stores I choose,但没有勾选门店。勾选一家,或选择 All stores。 |
| Allow at least one kind of access.(至少允许一种访问。) | 所有方面都设为 No Access。至少把一个方面设为 View。 |
之后给助手更多权限
Section titled “之后给助手更多权限”如果你要求助手做连接没有获得的事,例如 Menus & Sales 设为 View 时要求改价格,助手会请你重新登录,或告诉你连接没有这项权限。重新登录会打开授权页面,显示连接现有的门店和这次请求需要的权限。核对后选择 Allow。
你也可以在 AI Connections 中用 Edit 自己提高权限,无需重新登录。见修改连接。
如果你的角色不能给出这项权限,助手会说 Your account may not give AI clients write access to Menus & Sales.(你的账号不能给 AI 客户端 Menus & Sales 的写入权限。)或提到相应的方面。请门店的 Owner 来修改,或向 FMX EPOS 技术支持咨询你的角色限制。
涉及订座的顾客信息时,提示会提到 Customer Personal Data。如果连接只缺这一项权限,助手会说 A booking’s name, telephone, email and linked customer need Customer Personal Data change access. Give it on AI Connections in FMX EPOS Cloud.(订座的姓名、电话、邮箱和关联顾客需要 Customer Personal Data 的修改权限。请在 FMX EPOS Cloud 的 AI Connections 中授予。)这时用 AI Connections 上的 Edit 提高这一项权限。如果你的角色不能授予这项权限,提示结尾会改为 which your account may not give AI clients.(你的账号不能授予 AI 客户端。),AI Connections 也帮不上忙,请向 FMX EPOS 技术支持咨询你的角色限制。