公开 API

连接 AI 助手（MCP）

创建一个只带助手所需权限范围的 API 密钥，然后把地址 https://api.mosaqo.app/v1/mcp 连同该密钥（作为 bearer 令牌）交给客户端。助手能做的正好是密钥允许的，不多不少；你随时可以在 Bulk & API 中断开它。

最后校订 2026年8月20日

步骤

1. 打开 Bulk & API → API keys 并创建密钥。先只给只读权限；等你看清助手做什么之后，再签发第二把带写入权限的密钥。
2. 在同一屏的 AI assistants (MCP) 面板中复制接入地址。
3. 在助手里添加一个使用该地址的服务器，并把密钥放在 Authorization: Bearer 请求头中。多数客户端接受含 url 和 headers 的 JSON 配置块。
4. 有些连接器会请你登录 Mosaqo 而不是粘贴密钥。那条路径会在授予任何权限之前，先告诉你是谁在请求、会涉及哪个工作区、它能做什么——而且只有所有者或管理员才能批准。
5. 问问助手它能做什么。它会列出你的密钥允许的工具，这是确认连接范围符合预期的最快方式。

如何验证结果

问一个只有这个工作区才知道的问题：你有多少个码，或者某份问卷进展如何。回答中出现你真实的名称和数字，说明连接可用；若被拒绝并点名某个权限范围，说明密钥比问题更窄。

常见的出错之处

• 第一把密钥就给写入权限。先只读，等清楚它拿来做什么再放宽。
• 指望它读到人们在问卷里写下的内容。那些回答不会交给密钥，也不会交给助手——分数和数量可以，句子留在收件箱里。
• 指望它删除二维码。它不能：销毁印刷码背后的跳转无法撤销，所以提供的是归档，归档可以撤销。
• 忘掉某个连接。通过登录接入的助手会一直保有访问权，直到在 Bulk & API 中断开——就像密钥在吊销前一直有效。