为你的二维码和客户反馈准备的 AI 助手

01

可以问它什么

人们对自己的二维码真正会问的，是比较和清单：这个月哪些码被扫描得最多，哪些码自印出来后就没人扫描过，这一周和上一周相比如何，一个活动的哪个投放位置在真正起作用。助手用一句话回答这些问题，而不是丢给你一个还得自己去读的仪表盘；它还会说出码的名称，方便你核对。

反馈也是一样：一份问卷的走势如何，哪道题得分最低，换了菜单之后有多少人作答。通过 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。