連接你的助手

連接 Claude Code 或 Codex，在熟悉的對話中建立和編輯 IceFold 作品。結果會出現在同一個畫布中，你可以隨時開啟、審閱和修改。想直接在 IceFold 中開始？按照快速入門使用內建創作助手即可。

1. 連接客戶端

準備好 IceFold 帳號並安裝客戶端。以下步驟適用於 Codex CLI 和 Claude Code，不適用於 Claude 網頁版或桌面應用程式。無需額外安裝 IceFold Skill、SDK 或 runner。

遠端 MCP 服務使用 Streamable HTTP：

https://api.icefold.com/v1/mcp

Codex CLI

在終端機執行：

codex mcp add icefold --url https://api.icefold.com/v1/mcp
codex mcp login icefold --scopes session:read,session:edit,session:run,session:create,session:delete

在瀏覽器完成 IceFold 登入和授權，然後返回 Codex。

Claude Code

在使用 Claude Code 的專案目錄中執行：

claude mcp add --transport http icefold https://api.icefold.com/v1/mcp

在該專案中開啟 Claude Code，輸入 /mcp，選擇 IceFold 並在瀏覽器中完成認證。若要在多個專案中使用，在命令中加入 --scope user。

2. 查看存取範圍和費用

授權頁會顯示助手可存取的畫布及允許的操作。新連接預設可存取目前及未來的所有畫布，有效期限為 30 天。展開存取、用量和有效期限設定，可限定為所選畫布或縮短期限。永久刪除需要單獨啟用，創作內容不需要該權限。

IceFold 中的生成使用 IceFold 點數，與助手訂閱分開計費。連接授權不代表無限消費。生成前查看製作方案及需要核准的費用；已有授權在其範圍內繼續有效。

3. 試試第一個請求

在 IceFold 建立一個產品介紹工作流程，為我的產品簡報和廣告腳本準備可編輯的步驟，暫不生成任何內容。請給我畫布連結。

開啟回傳的連結，檢查步驟是否已建立。準備好工作流程不代表已生成媒體。加入素材、檢查方案，準備好後再讓助手繼續。助手可以回傳結果連結及用於繼續編輯的畫布。

內建助手、外部客戶端和手動編輯遵循同一套工作流程規則，審閱設定及固定輸出仍然有效。切換瀏覽器中的畫布不會改變外部助手的操作目標；更換任務時，請明確指出作品名稱或提供畫布連結。

管理連接與排解問題

• **只能讀取：**重新連接，為目標畫布允許編輯、生成和建立畫布。
• **授權過期或中斷：**依照上面的客戶端步驟重新認證。
• **缺少素材：**讓客戶端上傳原始檔案；若它不能傳輸檔案，在 IceFold 中上傳，再提供畫布連結。
• **停止存取：**在帳號設定中的助手連接面板撤銷連接；畫布空白處的右鍵選單也有相應入口，可管理該畫布的連接。

客戶端設定參考：Codex MCP 文件與 Claude Code MCP 文件。