跳至內容
FMX EPOS
下載
知識庫首頁

連接 AI 助理

你可以把 ChatGPT、Claude 或 Codex 等 AI 助理連接到你的 FMX EPOS Cloud 帳戶。之後助理可以回答有關店舖的問題,例如昨天的銷售額或哪些菜品已售罄,亦可按你的要求作出更改,例如修改價格。助理以你的身份操作,範圍限於連接時你允許的店舖和權限。

所有助理都連接到同一個 FMX EPOS Cloud 地址,即雲端 AI Connections 上顯示的 Connector Address。你會在 FMX EPOS Cloud 自己的頁面登入,因此助理不會看到你的雲端密碼。

連接後可以問甚麼,請閱讀日常使用 AI 助理。如要更改或終止連接,或遇到問題,請閱讀管理 AI 連接及解決問題。

任何 FMX EPOS Cloud 帳戶都可以在其角色容許的範圍內連接助理:

  • 東主:可連接自己擁有的店舖;
  • 店舖經理:可連接東主指派給他的店舖。

FMX EPOS 為每個角色設定了在各範疇最多可以給助理的權限。如某個範疇沒有提供 View and Change,表示你的角色目前不能給予這個權限,請向 FMX EPOS 支援查詢。部分更改只可透過東主的連接進行:訂單規則、會員計劃、加入或移除店舖經理、新的餐桌 QR 碼、網站的名稱、標語、聯絡資料和狀態,以及影響東主所有店舖網站的任何設定。店舖經理可以更改自己店舖網站的外觀。

每個帳戶對每個助理只有一個連接。再次連接同一個助理,會取代先前的連接,先前的連接隨即失效。在網頁版 ChatGPT,FMX EPOS 外掛程式和人手加入的自訂 MCP 伺服器算作同一個助理。ChatGPT 桌面應用程式以 Codex 身份登入時(見下文),該連接屬於 Codex,與 ChatGPT 的連接分開。

FMX EPOS 已列入 ChatGPT 的外掛程式目錄,供英國用戶使用。你可以在網頁版 ChatGPT 或 ChatGPT 桌面應用程式安裝。

  1. 在 ChatGPT 的側欄選擇 Plugins,打開外掛程式目錄。
  2. 搜尋 FMX EPOS 並打開。
  3. 選擇 Install plugin。如 ChatGPT 要求你連接,選擇 Connect。FMX EPOS Cloud 會在新視窗打開。
  4. 如有需要,以雲端電郵地址和密碼登入。
  5. 在同意頁面核對帳戶,選擇要容許的內容(參閱同意頁面),然後選擇 Allow。
  6. 返回 ChatGPT,開始新對話,詢問有關店舖的問題,例如「你看到哪些 FMX EPOS 店舖?」

ChatGPT 會在你的要求需要時使用這個外掛程式。你亦可以在訊息欄輸入 @ 和它的名稱,自行選用。能否安裝外掛程式視乎你的 ChatGPT 計劃和工作區。在公司工作區,可能需要管理員先容許 FMX EPOS。

在 ChatGPT 桌面應用程式,同意頁面的標題可能是 Connect Codex,Sign-in returns to 下顯示 An app on this computer。桌面應用程式是透過你電腦上的 Codex 登入的,所以這是正常的。如登入是你自己在桌面應用程式開始的,便可容許。

在 Claude,FMX EPOS 是一個連接器。它在 Claude 的連接器中列為 Community 連接器,即 Anthropic 已自動審查,但未有驗證。你可以在網頁版 Claude 或 Claude 桌面應用程式連接。

  1. 在 Claude,選擇側欄底部你的名稱,然後選擇 Settings。
  2. 在 Customize 下選擇 Connectors。
  3. 搜尋 FMX EPOS 並打開。
  4. 選擇 Connect to Claude。FMX EPOS Cloud 會隨即打開。
  5. 如有需要,以雲端電郵地址和密碼登入。
  6. 在同意頁面核對帳戶,選擇要容許的內容(參閱同意頁面),然後選擇 Allow。
  7. 返回 Claude,連接器會顯示 Connected。

示意圖,並非截圖。實際畫面可能因主題或版本而有所不同。

在對話中使用:

  1. 在新對話中選擇 +,再選擇 Connectors。
  2. 查看 FMX EPOS 旁邊的開關。FMX EPOS 連接後,開關會開啟。如不想 Claude 在該對話使用 FMX EPOS,可關閉開關。
  3. 詢問有關店舖的問題,例如「你看到哪些 FMX EPOS 店舖?」

示意圖,並非截圖。實際畫面可能因主題或版本而有所不同。

如使用 Claude Team 或 Enterprise 計劃,可能需要 Claude 機構的擁有人先加入 FMX EPOS,你才可以連接。

把 FMX EPOS 以 MCP 伺服器形式加入 Codex:

  1. 在 FMX EPOS Cloud 的 Account 下打開 AI Connections,複製 Connector Address。
  2. 在 Codex 的設定中加入 MCP 伺服器。為它命名,例如 fmx-epos,並貼上 Connector Address。
  3. 在 Codex 要求時登入。如它沒有自動打開登入,請在 Codex 設定中該伺服器的項目開始登入。
  4. 以雲端帳戶登入,並在同意頁面容許連接。
  5. 在 Codex 開始新對話使用。

Codex 透過你電腦上的應用程式登入。同意頁面會顯示登入將返回 An app on this computer,並提醒你只有在自己從該應用程式開始登入時才可容許,因為電腦上任何程式都可以提出這個要求。

在 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,並給出相同的提醒。

如未能從目錄安裝 FMX EPOS,可以改為把伺服器以自訂連接器或自訂 MCP 伺服器形式加入助理。

  1. 在 FMX EPOS Cloud 側欄的 Account 下打開 AI Connections。Connect an AI Client 卡會顯示 Connector Address,請複製。
  2. 在 ChatGPT,從外掛程式目錄加入自訂 MCP 伺服器。視乎你的計劃,ChatGPT 可能要求你先開啟開發人員模式。在 Claude,打開 Settings,再打開 Connectors,選擇 Add,然後選擇自訂連接器。
  3. 為它命名,例如 FMX EPOS,並貼上 Connector Address。如助理詢問登入方式,選擇 OAuth。
  4. 開始連接。FMX EPOS Cloud 會隨即打開,按上文登入並容許連接。

無論以哪種方式加入,只有 FMX EPOS 已設定的助理才可以連接。

同意頁面的標題是 Connect 加上助理的名稱,並說明助理會以你的身份、在你容許的店舖和權限範圍內操作。由上而下處理頁面:

  1. 核對 Signed in as。
  2. 核對 Sign-in returns to。
  3. 選擇 Stores。
  4. 為每個範疇設定 Access。
  5. 選擇 Allow;如不想建立任何連接,選擇 Deny。

示意圖,並非截圖。實際畫面可能因主題或版本而有所不同。

Signed in as 顯示你正在連接的雲端帳戶的名稱和電郵地址。助理會以這個帳戶的身份操作。

如帳戶不對,選擇 Use Another Account。雲端會把你登出並顯示登入頁面。以另一個帳戶登入後,同一個助理的同意頁面會再次打開。

如輸入錯誤密碼,登入頁面會顯示 The email or password is not correct. Five wrong passwords lock the account for 15 minutes.。同一網絡嘗試次數過多時,會顯示 Too many sign-in attempts from this network. Try again in 15 minutes.。登入後,你仍會返回同意頁面。如頁面顯示 This sign-in page was out of date. Sign in again.,重新登入後亦會返回。

Sign-in returns to 顯示雲端把結果送到哪裏:助理的網址,例如 chatgpt.com 或 claude.ai;Codex、Claude Code 和 ChatGPT 桌面應用程式則顯示 An app on this computer。如顯示的地址並非你預期的,選擇 Deny。

在 Stores 下選擇:

  • All stores:你的所有店舖,包括日後新增的店舖;
  • Only the stores I choose:剔選店舖。日後新增的店舖須在 AI Connections 另行加入。

第一次連接某個助理時,預設選取 All stores。再次連接同一個助理時,頁面會沿用其連接原有的店舖。已解除認領的店舖不會提供給新連接。再次連接時,如先前的連接包括某間已解除認領的店舖,該店舖會留在列表中,名稱後加上 (released)。

店舖選擇不會限制東主為旗下所有店舖而設的網站。東主建立的任何連接都可以讀取該網站;如 Online Ordering & Websites 設為 View and Change,亦可以更改它。如不想助理更改該網站,把這個範疇設為 View;設為 No Access 則連讀取也不可以。

在 Access 下,為每個範疇選擇 No Access、View 或 View and Change。頁面只會提供你的角色可以給予的級別。如你的角色完全不能給予某個範疇,或助理沒有要求該範疇,該範疇便不會顯示。

範疇 涵蓋內容
Store Operations 概覽、銷售報表、訂單、平台訂單、即時狀態和店舖經理。
Menus & Sales 餐牌、售罄、餐廳、平台對應、會員、優惠券、銷售設定和員工。
Online Ordering & Websites 網上點餐、餐桌點餐和網站,包括 QR 碼。
Integrations Stripe 和其他服務是否已設定。只可查看,亦看不到其密鑰。
Customer Personal Data 顧客的姓名、電話號碼、電郵地址和地址、顧客列表和來電。
Restaurant Bookings 由雲端確認訂座的店舖的訂座及其設定。助理建立、更改、批准、拒絕或取消的訂座,如有電郵地址,會以電郵通知客人。

每個範疇預設為你的帳戶可給予該助理的最高級別。選擇 Allow 之前,把不想助理使用的範疇調低。

只有給予 Customer Personal Data,助理才會看到顧客資料。沒有這個範疇時,姓名、電話號碼、電郵地址和地址會顯示為「(hidden)」,訂單備註會被隱藏,訂單只可按訂單號碼搜尋,顧客列表和來電亦無法使用。訂座會顯示時間、人數和餐桌,但客人的姓名、電話、電郵、備註和原因會顯示為「(hidden)」,亦不能按客人搜尋訂座。只有在你需要助理處理顧客資料時,才給予這個範疇。

要訂座,或更改訂座上客人的姓名、電話、電郵或連結的顧客,助理需要 Customer Personal Data 和 Restaurant Bookings 兩個範疇的 View and Change。其他訂座更改,例如新的時間或人數,只需要 Restaurant Bookings。

選擇 Allow 會儲存連接並返回助理。選擇 Deny 則不會建立任何連接,助理會得知你沒有容許連接。

如頁面提示,你之後可以在 AI Connections 更改或終止連接。

同意頁面上的訊息

「同意頁面上的訊息」一節
訊息 處理方法
This AI client is not registered with FMX EPOS Cloud. Contact FMX EPOS support and name the AI client you used. 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。

之後給助理更多權限

「之後給助理更多權限」一節

如你要求助理做連接未獲給予的事,例如 Menus & Sales 設為 View 時要求修改價格,助理會要求你重新登入,或告訴你連接沒有這個權限。重新登入會打開同意頁面,顯示連接現有的店舖和這次要求所需的權限。核對後選擇 Allow。

你亦可以在 AI Connections 以 Edit 自行提高權限,無須重新登入。參閱更改連接。

如你的角色不能給予這個權限,助理會顯示 Your account may not give AI clients write access to Menus & Sales.(或相關的範疇)。請店舖的東主作出更改,或向 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. 請在 AI Connections 用 Edit 提高這個範疇的權限。如你的角色不能給予這個權限,訊息結尾會改為 which your account may not give AI clients.,這時 AI Connections 幫不上忙,請向 FMX EPOS 支援查詢你角色的限制。