為你的 QR Code 與顧客回饋準備的 AI 助理

01

可以問它什麼

大家對自己的 QR Code 真正會問的，是比較和清單：這個月哪些碼被掃描最多次，哪些碼從印出來之後就沒人掃描過，這一週和上一週相比如何，一個活動的哪個版位在真正發揮作用。助理用一句話回答這些問題，而不是丟給你一個還得自己去讀的儀表板；它也會說出碼的名稱，方便你核對。

回饋也是一樣：一份問卷的走勢如何，哪一題分數最低，換了菜單之後有多少人作答。透過 MCP，助理拿到的是數字——數量、選項、每一題的分布、有多少人寫了留言——但從不拿到留言的文字。內建助理可以讀取最近的文字留言，但只對能在回覆收件匣裡看到這些留言的人這麼做，所以它能用一句話告訴你留言大致在講什麼。

• 被掃描最多的碼和沒人掃描的碼，逐一點名
• 本期與上期比較，可以針對一個碼，也可以針對整個工作區
• 問卷分數，以及平均分數背後的分布
• 掃描細節受工作區本身隱私設定的限制

02

它能改什麼，由誰說了算

在工作區裡，助理從不自作主張。它只提出建議：一個新碼、一份依你的描述寫成的卡片範本、一份問卷的題目、動態碼的新目的地、發布或封存。每一項都以卡片呈現，寫明會發生什麼事；在有人按下之前，什麼都不會改變——而且按下時用的是那個人自己的角色，所以檢視者能讀建議，卻無法執行。

透過 MCP，助理呼叫的是它的金鑰或登入所允許的工具。每個會寫入的工具都標明了這一點，封存還被標記為破壞性操作，所以遵守這些標記的用戶端會在執行之前先問你。沒有能刪除碼的工具：最多只能封存，而封存的碼可以還原。

• 內建助理：建立 URL、Wi-Fi、文字、vCard 和應用程式連結類型的碼；草擬卡片範本和問卷
• 內建助理和 MCP 都能：把動態碼指向新的地方、發布、封存
• 僅限 MCP：以草稿形式建立 URL 碼，以及啟動 CSV 匯入——除非你另有指示，否則只是試跑
• 兩者都不能：刪除碼、邀請成員，或變更誰有存取權

03

接上外部助理的兩種方式

MCP 伺服器只有一個網址：https://api.mosaqo.app/v1/mcp。最簡單的接入方式是 API 金鑰。擁有者或管理員在「批次與 API」中建立一把金鑰，勾選它可以做的事，再把它貼到用戶端裡。金鑰可以設定到期日和 IP 允許清單，一旦撤銷就立即失效。

另一種方式是登入。用戶端會自行註冊並開啟一個 Mosaqo 頁面，由擁有者或管理員在那裡核准它存取一個工作區。之後它會出現在「已連接的助理」底下，按「中斷」即可立刻終止。無論哪種方式，一份憑證都只能存取一個工作區。

• qr:read 和 qr:write 用於碼，exports:read 用於碼的圖片
• analytics:read 用於掃描，reviews:read 用於場所和問卷報告
• bulk:write 和 webhooks:write 只在需要時才授予
• 超出你所授權限的工具，根本不會提供給助理

04

先給比你以為需要的更少的權限

一把唯讀金鑰就能滿足大家對助理的多數需求：報告、比較、需要留意的碼的清單。給它 qr:read 和 analytics:read，用上一週，等真的有一項你想透過對話完成的修改時，再加上 qr:write。

每個工具、每個人各用一把獨立的金鑰。這樣一來，外洩的金鑰或已經結束的實驗，都可以單獨撤銷，不會牽動其他任何東西。

05

依賴它之前值得知道的限制

內建助理在每個工作區每小時最多回答 60 個問題，每天最多 300 個；它只談工作區相關的話題，無關的問題會被禮貌地婉拒。每個人都可以在「偏好設定」中讓它不在自己的工作區裡顯示。

透過 MCP，每把金鑰或每個登入每分鐘可以發出 600 個請求——這是防止失控迴圈的保護，而不是方案限制。掃描分析只涵蓋動態碼，因為靜態碼一旦印出來，就再也不會經過 Mosaqo。