文／Ovata｜更新：2026 年 11 月 3 日

做完這篇，你的 Codex 或 Claude Code 會連上 Ovata，可以替你製作和管理網站。第一次用也可以照著做：每個指令都能直接複製，不清楚的訊息可以貼給 AI，請它用白話說明。

開始前

準備好 Ovata 帳號和 Codex 或 Claude Code。工具的設定方式可以參考 Codex 官方說明和 Claude Code 官方說明。

下面的指令在終端機執行。終端機是輸入指令的視窗：Mac 在「應用程式 › 工具程式」裡，Windows 可以開「終端機」或 PowerShell。貼上指令後按 Enter。

Console 的 Developer MCP 頁也有同樣的指令，按「複製連線指令」就能複製。已安裝 Ovata plugin 的話，連線已包含在內，不必再加一次。

連接 Codex

執行這兩行：

codex mcp add ovata --url https://platform-api.ovata.tw/mcp
codex mcp login ovata

接著：

  1. 瀏覽器會開啟 Ovata，登入後會看到同意頁。
  2. 按「允許連線」。

也可以在 Codex 的 MCP 設定新增 Server URL https://platform-api.ovata.tw/mcp，再依瀏覽器畫面登入。

連接 Claude Code

執行這一行：

claude mcp add --transport http ovata https://platform-api.ovata.tw/mcp

接著：

  1. 開啟 Claude Code，輸入 /mcp，選擇 ovata。
  2. 瀏覽器會開啟 Ovata，登入後會看到同意頁。
  3. 按「允許連線」。

同意頁的內容

同意頁是 Ovata 的授權畫面，標題是「連接開發工具」。允許後，這個工具可以：

  • 管理文章、頁面、商品、留言、投稿與網站設定
  • 查看訂單、聯絡訂單顧客、建立與匯入顧客
  • 修改網站程式，放上測試站，再發布到正式站
  • 送出新網站需求、請 Ovata 修改網站

連線包含你有權限的所有網站，也包含之後新增的。每次操作仍以你當下的權限為準。金流金鑰與退款只能在 Console 操作。

Email 是另外的選項。要讓 AI 讀信時，才勾「也可以使用 Email」並逐個選信箱。

已登入 Ovata 時會直接看到同意頁，仍要你自己按才會連線。按之前，確認畫面上的工具名稱是你剛剛開啟的工具。

確認連線正常

在 AI 工具裡輸入：

請呼叫 get_started，再用 list_workspaces 和 list_sites，告訴我看到哪些工作區和網站。

AI 會列出你的工作區和網站。還沒建立網站時，網站清單是空的。

到 Console › Developer MCP，也能在「已連線的開發工具」看到這個工具和最近使用的日期。連線閒置 90 天才需要重新連線，登出 Ovata 不會中斷。

撤銷連線

  1. 到 Console › Developer MCP。
  2. 在「已連線的開發工具」找到這個工具，按「撤銷」，再按「確定撤銷」。

撤銷後連線立即失效。之後要再用，回到工具重新登入。

收到 insufficient_scope 或 NOT_IN_CONNECTION

這兩個錯誤代表連線缺權限，多半是 2026 年 10 月 31 日以前建立的連線。重新連線一次就會補齊。Codex 執行：

codex mcp login ovata

Claude Code 輸入 /mcp，選 ovata 再登入一次。到同意頁按「允許連線」，再請 AI 重試。Email 工具回這個錯誤時，同意頁要勾選 Email 和信箱。

SITE_FEATURE_UNAVAILABLE、ROLE_FORBIDDEN、AUTHZ_PENDING 跟連線無關，重新連線也沒有用。處理方式見AI 卡住或做不到時的處理方式。

下一步