连接你的助手 | 文档

连接 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 中上传，再提供画布链接。
停止访问：在设置 → 账号 → 我的 Agent中撤销连接；画布空白处的右键菜单也有相应入口，可管理该画布的连接。

客户端配置参考：Codex MCP 文档和 Claude Code MCP 文档。