连接 AI 助理（MCP）

MCP（Model Context Protocol）就像您的 AI 助理与 Kanorio 之间的翻译官。连上之后，您不需要自己在后台逐一点选，只要在 ChatGPT、Claude 或 Cursor 里用白话说：“帮我开一个手工烘焙坊的官网，首页放主视觉、三张招牌面包介绍和常见问题，先存草稿让我检查”，AI 就会替您在 Kanorio 完成。

• MCP 服务器网址：https://app.kanorio.com/api/mcp

第一步：确认您的工具用哪种接法

依您手上的工具，连接方式分为两种：

如果不确定手上的工具属于哪一种，可以直接前往“账号设置 › API 访问”点击“建立密钥”：第一步就是选择工具，若选到支持授权链接的工具，画面会直接提供服务器网址，不会多建一把密钥。

两种接法的安全规则完全相同：AI 能做的事永远不会超过您授予的权限，也不会超过您在该网站的成员角色。

方法一：用授权链接连接（ChatGPT、Claude 等）

适用于 ChatGPT、Claude、Gemini、Zapier、Make 等内置“连接器（Connectors）”的工具。以下以 ChatGPT 与 Claude 为例：

1. 在工具里新增 Kanorio 连接器

• ChatGPT：开启“设置”→“连接器”（若为进阶自定义连接器需开启开发者模式），选择“建立”，名称填 Kanorio，MCP 服务器网址填 https://app.kanorio.com/api/mcp，验证方式选 OAuth。
• Claude：开启“设置”→“整合（Integrations）”或“连接器”，点击新增远程 MCP 服务器，填入名称 Kanorio 与网址 https://app.kanorio.com/api/mcp。

2. 在 Kanorio 授权页勾选网站并按“允许”

保存后，浏览器会开启 Kanorio 的授权同意页：

1. 确认画面上显示的是您要使用的 Kanorio 账号。
2. 查看“此应用将可以”列出的权限清单。权限由应用提出（若应用未指定，系统会自动套用预设的“编辑内容”计划，可查看并修改页面与文章草稿，但不能发布或下线网站）。
3. 在“可操作的网站”只勾选您要让 AI 操作的网站。若要让 AI 从零帮您建立新网站，请选“全部网站（含未来新增）”。
4. 点击“允许”返回工具，在对话框启用 Kanorio 工具即可开始对话。

使用途中跳出第二次授权页？ 如果您一开始用预设的“编辑内容”权限连上，后来在对话中请 AI“帮我发布网站”或“绑定域名”，AI 助理会自动带您回到授权页补上缺少的权限（新增项目旁会标示“新增”）。确认无误按“允许”即可继续。关于授权画面的完整说明与如何解除连线，请见。

Gemini 使用限制提醒：Google 目前将 Gemini 网页版的“自定义应用”限定于美国地区、18 岁以上且使用英文界面的个人账号；Gemini 企业版（Enterprise）因要求预先注册固定的客户端密钥，暂时无法连接 Kanorio。

方法二：用 API 密钥连接（Cursor、Claude Code 等）

适用于 Cursor、Claude Code、GitHub Copilot（VS Code）、Windsurf、Perplexity、n8n 与自建程序。

1. 建立密钥并复制专属设置

1. 前往“账号设置 › API 访问”，点击“建立密钥”。
2. 选工具：点击您要连接的工具图标（例如 Cursor 或 Claude Code）。
3. 选可操作的网站：日常修改现有网站建议只勾选该网站；若要让 AI 从零建立新网站，请选“全部网站（含未来新增）”。
4. 选权限计划：
   • 预设“编辑内容”即可让 AI 修改页面模块、上传图片与撰写博客草稿（由您检查后再手动发布，最安全）。
   • 若希望 AI 直接替您执行发布、绑定域名或管理商品，请改选“完整管理”。
5. 选有效期并完成本人确认，点击建立。密钥细节与轮替方式请见。

2. 把设置贴进您的工具

密钥建立成功的画面会直接产生一段已填入您的密钥与服务器网址的设置，点击“复制设置”贴到对应位置即可：

Cursor 配置文件（.cursor/mcp.json）示例：

{
  "mcpServers": {
    "kanorio": {
      "url": "https://app.kanorio.com/api/mcp",
      "headers": {
        "Authorization": "Bearer knr_pat_您的密钥"
      }
    }
  }
}

Claude Code 终端机指令示例：

claude mcp add --transport http kanorio https://app.kanorio.com/api/mcp \
  --header "Authorization: Bearer knr_pat_您的密钥"

不想把密钥写进电脑配置文件？ Cursor 与 Claude Code 也支持改走“授权链接”：在 Cursor 设置中省略 headers 栏位，或在 Claude Code 指令中省略 --header 参数。第一次使用时工具会自动打开浏览器，带您到 Kanorio 授权页按“允许”。 由于这类工具是在您的电脑本地执行，授权页会出现黄色的“无法确认身份”提示并说明“完成后会回到您这台设备上的程序”，只要确认是您本人刚在工具里发起的连接，即可放心按“允许”（详见）。

AI 助理能帮您做什么？（含安全边界）

哪些改动会先存草稿 vs 哪些会立即上线？

让 AI 操作网站前，建议先掌握哪些动作有“草稿缓冲”：

• 会先存成草稿（需执行“发布”才会让访客看见）：
  • 修改页面上的所有模块内容与排版
  • 修改页首导航栏、页尾、全站共用按钮与社交链接
  • 修改网站外观设置（品牌色、字体、圆角风格、版面密度、深浅色模式、内容语言）
  • 新增或修改博客文章（新文章一律先存为草稿，需另外执行发布文章才会公开）
• 会立即反映在已发布的公开网站上：
  • 修改页面的网址路径（Slug）、显示／隐藏状态与单页 SEO 栏位
  • 新增、修改或封存商店商品（商品没有草稿状态，保存后会直接反映在公开商店页）
  • 执行发布网站、下线网站或绑定自定义域名

哪些事 AI 绝对不能做？

为了保护您的账号安全、财务与客户隐私，以下操作在系统底层直接禁止透过 AI 或 API 执行，即使密钥选了“完整管理”也无法呼叫，必须由您本人在 Kanorio 后台操作：

• 数据导出与私密文件：导出网站备份、导出订单／客户／营销／分析 CSV、下载表单回复的附件文件。
• 金流、订单与账务：执行订单退款、修改订单状态与备注、修改网站币别、变更商品价格计划、管理订阅账单与支付方式。
• 不可逆的客户与营销操作：删除联系人、整批导入联系人、直接寄出或排程电子报（AI 只能建立与修改电子报草稿，最后寄出必须由您在后台确认）。
• 权限与所有权：邀请或移除团队成员、转移网站所有权、永久删除网站或永久删除博客文章。

完整能力与 MCP 工具对照表

连上后 AI 可呼叫以下 17 类能力（右侧工具名称供工程师或在 Cursor／Claude 内检视呼叫纪录时对照）：

建议的对话流程与实用指令示例

AI 建站与改页的最佳顺序

AI 助理按照以下 7 个步骤工作时最顺畅（这套顺序也已内置在 sections_describe 的引导说明中，AI 会自动遵循）：

1. 先查模块规格：让 AI 先了解可用模块与栏位限制。
2. 建站或选站：建立新网站，或先列出既有网站确认目标网站。
3. 先定品牌外观与全站按钮：先设好品牌色、字体与全站共用按钮（如“立即预约”“联系我们”），后续建立页面时就能直接引用同一颗按钮，风格才会一致。
4. 准备图片素材：把您的照片传给 AI，或请 AI 从免费图库挑图（见下一节）。
5. 改写页面与更新导航栏：AI 先读取目前页面再整页改写；新增页面后记得请 AI 一并更新页首导航栏，访客才点得到新页面。
6. 检查草稿并发布：您可以先到后台编辑器预览草稿，确认满意后再请 AI 执行发布（首次发布需指定 .kanorio.com 免费子域名）。
7. 绑定域名与检查 DNS：若已买好品牌域名，可请 AI 绑定并帮您检查 DNS 生效状态。

可直接复制的对话指令范本

您可以直接复制以下指令贴给 ChatGPT、Claude 或 Cursor，再把括号里的文字换成您的品牌信息：

示例一：从零建立品牌官网（先存草稿）

请帮我在 Kanorio 建立一个新的品牌网站：
- 品牌名称：【拾光手工烘焙】
- 行业与简介：【酸种面包与法式常温甜点工作室，主打天然鲁邦种低温慢发酵，提供在线预订与门店自取】
- 风格与配色：【温暖的大地赤陶色系、柔和圆角、浅色背景】
- 主要行动按钮：【立即预订自取（链接先填 https://instagram.com/example）】
请帮我规划并建立“首页”与“关于我们”两页，图片先帮我从免费图库挑选合适的烘焙与面包照片，完成后更新页首导航栏并保留为草稿，等我预览确认后再发布。

示例二：改写现有页面并优化 SEO

请读取我在 Kanorio 的【拾光手工烘焙】网站：
1. 查看“首页”目前的模块内容，帮我把文字改写得更具体有吸引力，并在页面下半部加入一个“常见问题（FAQ）”模块（包含保存方式、预订取货时间、过敏原说明 4 题问答）。
2. 帮我检查并更新全站所有页面的 SEO 搜索标题与描述。
请先存成草稿，不要直接发布，并告诉我你改了哪些地方。

示例三：我有照片，请帮我换上并写一篇博客草稿

我想在 Kanorio 的【拾光手工烘焙】网站新增一篇介绍“秋季栗子酸种面包上市”的博客文章，同时想把首页主视觉换成我刚拍好的新照片。请先给我一个上传照片的链接，等我传好照片后再帮我换图并建立文章草稿。

AI 怎么拿到您的图片？

这是最常遇到的问题：为什么我在 ChatGPT 或 Claude 对话框里直接贴了照片，AI 却没法放到网站上？

因为基于安全限制，ChatGPT、Claude 等聊天工具只会让 AI“看见”您贴在对话框里的图片，不会把原始图片文件传给 Kanorio。因此当网站需要图片时，AI 会自动依您的情况走以下四条路径之一，您只要照着 AI 的提示操作即可：

图片空间与媒体库回收站规则

• 24 小时未引用自动清理：透过 AI 上传但超过 24 小时都没有被任何页面、文章或商品使用的图片，系统会自动回收，不浪费您的存储空间。
• 移至回收站与 30 天复原：您可以请 AI 整理媒体库、将不用的文件移至回收站（media_trash）。移至回收站的文件会立即停止在网站上显示，但仍计入存储空间，30 天内随时可请 AI 或在后台复原（media_restore）；若确定不再需要、想立即释放空间，可请 AI 永久删除（media_purge，若网站仍有页面用到该图，AI 会先向您确认）。数字商品下载文件受保护，无法直接移至回收站。
• 覆盖更新后的旧版图片：若您曾在后台媒体库用新图取代旧图，当旧版退入回收站并由 AI 执行复原时，系统会将旧版复原为一个独立的新文件并回传新的文件编号，原本正在使用新版图片的页面不会被换回旧图。

使用限制与注意事项

• 呼叫频率限制（Rate Limits）：每把 API 密钥（或每个已授权应用的连接）每分钟最多可呼叫 120 次一般操作；发布与下架（含网站发布／下线、博客文章发布／下架）另计，每小时最多 30 次。超过时 AI 会收到“操作太频繁”提示，稍候几秒即可继续。
• AI 点数与计划权益：透过 AI 助理执行“AI 精灵建站（sites_create 的 brief 模式）”时，会与您在后台操作一样使用账号的 AI 点数与每日建站次数；免费版的公开页面数、每页可见模块数等限制也完全相同（详见）。
• 多人与多工具防覆盖保护：如果您在后台编辑器改页面的同时，AI 也在改同一页，后写入的一方会被系统拦下并要求重新读取最新内容，绝不会默默把您刚改好的文字盖掉。建议真人与 AI 分页分工。
• 让 AI 整理表单回复、客户名单与订单时的提醒：表单回复、联系人资料与订单备注是由外部访客填写的内容。Kanorio 会在回传给 AI 的工具说明与数据外层标示“不可信访客数据（Untrusted visitor data）”，提醒 AI 只能将这些文字当作数据整理、不可当作指令执行；同时建议您在让 AI 读取外部访客信息时，密钥维持“只能查看”或“编辑内容”权限，并在发布前预览草稿。
• Beta 阶段与变更通知：MCP 工具与 REST API 目前为 Beta 阶段。若未来某个工具准备淘汰，工具说明开头会自动标示替代方案（AI 会自动改用新工具），所有变更也会同步公告于 API 变更纪录，政策详见 。

相关文件