API 密钥是一串以 knr_pat_ 开头的专属密码，代表“您本人，但只能做您勾选的事、只能碰您指定的网站”。将密钥设置进 AI 工具或自动化程序后，它们就能在后台为您列出网站、修改页面、上传图片、发布或绑定域名，无需打开浏览器登录。
管理位置在“账号设置 › API 访问”。
使用 ChatGPT、Claude、Gemini、Zapier、Make 时不需要建密钥： 这类工具内置“连接器”，只要粘贴 MCP 服务器地址
https://app.kanorio.com/api/mcp并在 Kanorio 授权页按“允许”即可（详见）。即使您在建立密钥时选到了这些工具，界面也会直接提供服务器地址，不会多建一把密钥。
登录后台，点击右上角头像进入“账号设置”→“API 访问”（或直接前往 app.kanorio.com/account/api-access），点击右上角的“建立密钥”。
点击您要使用的工具图标：
系统会预设填入“{工具名称} 建站助手”，您可以自由修改。名称只有您自己看得到，建议遵循“一个工具、一个用途一把密钥”的原则命名，例如“Cursor 改品牌官网”“n8n 每天同步库存”。日后某个工具停用或同事交接时，一眼就能看出该撤销哪一把。
您可以直接从三个预设方案挑一个，不必逐项研究底层权限：
| 权限计划 | 可执行操作 | 适用场景 |
|---|---|---|
| 仅供查看 | 读取网站设置、页面、博客文章、、在线表单回复、客户名单、分众、商品、订单与分析，无法修改任何内容 | 让 AI 协助整理运营报表、检查网站结构，或供 的 ?preview=1 草稿预览使用 |
| 编辑内容（默认） | 包含“仅供查看”，加上新增与修改页面模块草稿、页眉页脚、上传与管理图片、撰写博客文章；无法发布或下线网站（若需让 AI 创建与写入数据集合，请点击“自定义”并勾选“内容 › 管理数据集合”或改选“完整管理”） | 日常让 AI 协助修改页面、更换图片、撰写文章，由您预览后手动发布 |
| 完整管理 | 开放所有可授予 AI／API 的权限，包含发布与下线网站、绑定自定义域名、创建与管理、设置 CORS 允许来源、新增与修改商品、管理客户标签、创建电子报草稿 | 全自动建站至上线、AI 创建数据库，或自建后台与 ERP 系统集成 |
若想微调细项，可点击“自定义”展开 6 大权限分组（页面浏览、网站设置、内容、电商、顾客、营销），每组皆可点击“全选这组”。当您勾选写入类权限（例如“编辑网站内容”）时，系统会自动勾起必要的读取权限（如“进入主控台”与“进入网站编辑器”）并标示“已自动包含”，避免漏勾导致工具无法运作。
安全限制提醒：
- 即使勾选了“营销”的发送权限或“完整管理”，AI 与 API 只能建立与修改电子报草稿，无法直接发送或定时发送电子报（发送前必须由您在后台确定）。
- 导出网站／订单／顾客／营销／分析数据、下载表单附件、订单退款、删除联系人、修改网站币别、管理成员、处理账务与网站转移等高风险权限，一律不开放勾选。
可选择 7 天、30 天、90 天（预设）或 365 天，选项旁会直接显示到期日期（基于安全考量，不提供永久有效的密钥）：
建立 API 密钥等同于将账号权限交给外部程序。若您在这台设备登录已超过 15 分钟，提交时系统会要求再次确认是您本人：
密钥明文（knr_pat_...）只会在建立完成的这个界面显示一次。除了密钥本身，界面下方会依您刚才选的工具，直接准备好一段已填入这把密钥与服务器地址的设置：
.cursor/mcp.json 的完整 JSONclaude mcp add 指令.vscode/mcp.json 的完整 JSONAuthorization: Bearer Header点击“复制设置”粘贴进工具即可，不必自己手动拼凑。若还没复制就按关闭，系统会跳出确认窗口提醒您；关闭窗口后列表只会保留前 8 位供辨识，若忘记密钥内容请直接执行“轮替”。
一把密钥在某个网站的实际权限，取决于“密钥勾选的权限”与“您本人在该网站的成员角色”的交集：
$$\text{实际权限} = \text{密钥勾选的权限} \cap \text{您在该网站的成员角色权限}$$
在“账号设置 › API 访问”列表中，每把密钥都会显示：
工具：{client}）：系统会自动记录最后一次拿这把密钥连接的程序名称（例如 cursor-vscode、claude-code 或 kanorio-cli）。如果您当初是建给 Cursor 使用，列表却显示陌生的工具名称，代表密钥可能被粘贴到其他地方，建议立即轮替或撤销。每个 Kanorio 账号最多可同时拥有 20 把有效密钥（正在轮替缓冲期内的旧密钥不占名额）。
点击密钥右侧“更多（⋯）”菜单的“编辑”，可以修改名称、可操作的网站与权限方案（有效期无法直接修改，要延长有效期请使用“轮替”）：
当您收到密钥即将到期的提醒信、想定期更换密码，或怀疑密钥可能外泄时，不需要先删掉旧密钥再重填整张表单 - 请点击密钥右侧“更多（⋯）”菜单的“轮替”：
在 1 小时或 24 小时的缓冲期内，列表会同时显示新旧两把密钥，旧密钥旁会标示“{时间}后失效”（缓冲中的旧密钥只能执行“撤销”，且不会再发送到期提醒）。缓冲期一过，旧密钥就会自动失效。
已过期的密钥：若密钥已经过期，菜单会显示为“重新生成” - 同样一键沿用原本的名称、网站与权限发出新密钥（因为旧密钥已失效，不会有缓冲期选项）。
在密钥右侧“更多（⋯）”菜单点击“撤销”并确定后，该把密钥会立即永久失效，正在使用它的 AI 助手或程序下一次请求就会收到 401 UNAUTHORIZED 错误（撤销前已写入的网站草稿会保留）。
.cursor/mcp.json（并确认已加入 .gitignore）。knr_pat_ 密钥粘贴在聊天信息里，请勿照做。不行，最长有效期为 365 天。定期更换密钥能大幅降低凭证长期外流的风险。到期前 7 天与前 1 天系统都会发信提醒您，只要点击"轮替"就能在几秒内沿用原设置换发新密钥。
不行。每把 API 密钥都绑定建立者本人的账号与操作审计记录。若团队成员需要使用 Cursor 或自动化工具，请该成员登录自己的 Kanorio 账号建立密钥，密钥权限也会自动受限于该成员在网站的角色。
因为这些动作等同于发出或扩大一把能代表您操作网站的长期通行证。为了防止他人趁您的电脑未锁定、或通过旧的登录状态偷偷建立密钥，只要距离上次登录超过 15 分钟，系统就会要求验证 2FA／Passkey 或重新登录。相对地，"缩小权限""修改名称"与"撤销密钥"属于安全收敛动作，随时点击都会立即生效，不会要求验证。
提醒信会发送到您 Kanorio 账号的登录邮箱，并同步显示在后台右上角的收件箱通知。请先检查垃圾邮件箱；另外，若该密钥已经过期、已撤销、已被轮替为旧密钥，或建立时选择的是 7 天有效期（仅会在到期前 1 天提醒，不会发送前 7 天那封），系统就不会发送该阶段提醒。