連接 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 變更紀錄，政策詳見 。

相關文件