IFACT · 安装
把你的 agent 请进画布
一行命令,或者一个地址。主流的 agent 都能接进来,它做的每一张画板、每一次修改,都会实时出现在你的画布上。
让 agent 帮你装:把这句话发给它。
请打开 https://ifact.net/install,照上面的步骤给你自己装上 ifact。Claude Code
一行命令接好,浏览器里点一次允许。
- 01
在终端里运行这一行
macOS 和 Linux 都可以,这台电脑上的 Codex 也会一起接好。以后再运行一次,就是更新。
curl -fsSL https://ifact.net/setup.sh | sh - 02
在浏览器里点一次允许
授权页会自己打开;没打开的话,复制终端里给的地址。登录 ifact,没有账号会直接注册。
- 03
重开 Claude Code
已经开着的要重开一次,才会用上新的连接和 ifact skill。
不想运行脚本(比如在 Windows 上):运行 claude mcp add --transport http --scope user ifact https://ifact.net/mcp,再在 Claude Code 里输入 /mcp 登录。
Claude Desktop
添加自定义连接器,网页版和手机上也一样。
- 01
添加自定义连接器
在 自定义 → 连接器 里添加自定义连接器,名称填 ifact,地址填:
https://ifact.net/mcp - 02
连接,然后允许
点 连接,登录 ifact,再点允许。团队版和企业版要先由管理员在组织设置里添加,成员再点连接。
- 03
在对话里打开 ifact
从输入框的 + → 连接器 打开 ifact,再告诉它你要做什么。
网页版和手机上的 Claude 用的是同一个连接器。想让它更熟悉 ifact 的做法,可以在 自定义 → 技能 里上传 skill.zip。
Codex
一行命令接好,和 Claude Code 用同一次授权。
- 01
在终端里运行这一行
macOS 和 Linux 都可以,这台电脑上的 Claude Code 也会一起接好。以后再运行一次,就是更新。
curl -fsSL https://ifact.net/setup.sh | sh - 02
在浏览器里点一次允许
授权页会自己打开;没打开的话,复制终端里给的地址。登录 ifact,没有账号会直接注册。
- 03
重开 Codex
命令行、桌面版和 IDE 插件共用一份配置,接一次都能用。已经开着的要重开一次。
不想运行脚本:运行 codex mcp add ifact --url https://ifact.net/mcp,它会打开浏览器让你登录;没打开就运行 codex mcp login ifact。
Gemini CLI
命令行添加,浏览器登录。
- 01
添加 ifact
在终端里运行:
gemini mcp add -s user --transport http ifact https://ifact.net/mcp - 02
登录
打开 gemini,输入
/mcp auth ifact,在浏览器里登录 ifact,点允许。 - 03
装上 ifact skill
它会按 ifact 的约定做事:一个产品一个项目,做完只给一个链接。
mkdir -p ~/.agents/skills/ifact && curl -fsSL https://ifact.net/skill.md -o ~/.agents/skills/ifact/SKILL.md
Google 已经把免费用户和 Google One 用户的 Gemini CLI 换成了 Antigravity CLI(命令 agy),这些用户请看 Antigravity。
Grok Build
命令行添加,第一次用时登录。
- 01
添加 ifact
在终端里运行:
grok mcp add --transport http ifact https://ifact.net/mcp - 02
第一次用时登录
第一次用到 ifact 时会打开浏览器,在浏览器里登录 ifact,点允许。也可以在 grok 里输入
/mcps,选中 ifact 后按i登录。 - 03
装上 ifact skill
它会按 ifact 的约定做事:一个产品一个项目,做完只给一个链接。
mkdir -p ~/.agents/skills/ifact && curl -fsSL https://ifact.net/skill.md -o ~/.agents/skills/ifact/SKILL.md
Grok Build 也会读取 Claude Code 的 MCP 配置:已经在 Claude Code 里接好 ifact 的话,这里通常直接能用。
OpenCode
写进配置文件,命令行登录。
- 01
写进配置文件
加到
~/.config/opencode/opencode.json;文件已经存在的话,只把 ifact 这一段放进mcp里:~/.config/opencode/opencode.json{ "$schema": "https://opencode.ai/config.json", "mcp": { "ifact": { "type": "remote", "url": "https://ifact.net/mcp", "enabled": true } } } - 02
登录
在终端里运行这一行,在浏览器里登录 ifact,点允许。
opencode mcp auth ifact - 03
装上 ifact skill
它会按 ifact 的约定做事:一个产品一个项目,做完只给一个链接。
mkdir -p ~/.agents/skills/ifact && curl -fsSL https://ifact.net/skill.md -o ~/.agents/skills/ifact/SKILL.md
新版 OpenCode 也可以直接运行 opencode mcp add ifact --global --url https://ifact.net/mcp。
OpenClaw
命令行添加,要先停一下 Gateway。
- 01
添加 ifact
添加和登录都要先停掉本机的 Gateway,transport 要写 streamable-http:
openclaw gateway stop openclaw mcp add ifact --url https://ifact.net/mcp --transport streamable-http --auth oauth
- 02
登录,再启动 Gateway
第一行会给出授权链接,在浏览器里登录 ifact,点允许。
openclaw mcp login ifact openclaw gateway start
- 03
装上 ifact skill
它会按 ifact 的约定做事:一个产品一个项目,做完只给一个链接。
mkdir -p ~/.openclaw/skills/ifact && curl -fsSL https://ifact.net/skill.md -o ~/.openclaw/skills/ifact/SKILL.md
不想停 Gateway:在 Control UI 的 Settings → MCP 里添加服务器(Streamable HTTP),在配置里加上 auth: "oauth",再点 Sign in。
Hermes
命令行添加,第一次连接时登录。
- 01
添加 ifact
在终端里运行:
hermes mcp add ifact --url https://ifact.net/mcp --auth oauth - 02
第一次连接时登录
Hermes 第一次连接 ifact 时会打开浏览器,在浏览器里登录 ifact,点允许。没打开的话,运行
hermes mcp login ifact,再在会话里输入/reload-mcp。 - 03
装上 ifact skill
Hermes 可以直接从地址安装,会先做安全检查请你确认;以后运行
hermes skills update就能更新。hermes skills install https://ifact.net/skill.md
Pi
内置 MCP,命令行添加并登录。
- 01
添加 ifact
Pi 从 0.99 起内置 MCP。在终端里运行:
pi mcp add ifact --url https://ifact.net/mcp - 02
登录
在终端里运行这一行,在浏览器里登录 ifact,点允许。
pi mcp login ifact - 03
装上 ifact skill
它会按 ifact 的约定做事:一个产品一个项目,做完只给一个链接。
mkdir -p ~/.agents/skills/ifact && curl -fsSL https://ifact.net/skill.md -o ~/.agents/skills/ifact/SKILL.md
MiniMax Code
用个人访问令牌接入。
- 01
生成令牌
MiniMax Code 的自定义 MCP 只能用令牌登录。在 ifact 的 设置 → agent 连接 里找到个人访问令牌,点 生成令牌,复制下来。
- 02
写进配置文件
加到
~/.minimax/mcp.json,把令牌换进去。桌面版也可以在 插件管理 → MCP Servers 里粘贴这段:~/.minimax/mcp.json{ "mcpServers": { "ifact": { "type": "streamable-http", "url": "https://ifact.net/mcp", "headers": { "Authorization": "Bearer 你的令牌" }, "enabled": true } } } - 03
装上 ifact skill
它会按 ifact 的约定做事:一个产品一个项目,做完只给一个链接。
mkdir -p ~/.agents/skills/ifact && curl -fsSL https://ifact.net/skill.md -o ~/.agents/skills/ifact/SKILL.md
Kimi Code
写进配置文件,会话里登录。
- 01
写进配置文件
加到
~/.kimi-code/mcp.json,也可以在 kimi 里输入/mcp-config一步步添加:~/.kimi-code/mcp.json{ "mcpServers": { "ifact": { "url": "https://ifact.net/mcp" } } } - 02
登录
在 kimi 里输入
/mcp-config login ifact,在浏览器里登录 ifact,点允许。 - 03
装上 ifact skill
它会按 ifact 的约定做事:一个产品一个项目,做完只给一个链接。
mkdir -p ~/.agents/skills/ifact && curl -fsSL https://ifact.net/skill.md -o ~/.agents/skills/ifact/SKILL.md
这里说的是新版 Kimi Code(命令 kimi,npm 包 @moonshot-ai/kimi-code)。旧的 kimi-cli 已经停止维护。
Antigravity
写进 mcp_config.json,在 App 里登录。
- 01
写进 mcp_config.json
全局配置在
~/.gemini/config/mcp_config.json。IDE 里从 agent 侧栏顶部的 … → MCP Servers → Manage MCP Servers → View raw config 打开;App 里在 Customizations → Installed 的 MCP Servers 处点 Copy Config File Path 找到它:~/.gemini/config/mcp_config.json{ "mcpServers": { "ifact": { "serverUrl": "https://ifact.net/mcp" } } } - 02
登录
在 App 的 Customizations → Installed → MCP Servers 里点 Authenticate,在浏览器里登录 ifact,点允许。再把授权码粘贴回 Antigravity。
- 03
装上 ifact skill
App、IDE 和命令行
agy都会读这里。它会按 ifact 的约定做事:一个产品一个项目,做完只给一个链接。mkdir -p ~/.gemini/config/skills/ifact && curl -fsSL https://ifact.net/skill.md -o ~/.gemini/config/skills/ifact/SKILL.md
从 Gemini CLI 换过来的话,agy 第一次运行会提示导入原来的配置。
Oh My Pi
在 omp 里一条命令添加并登录。
- 01
在 omp 里添加
在 omp 的会话里输入这一行,它会打开浏览器,在浏览器里登录 ifact,点允许。要带上
--scope user,不然只加到当前项目。/mcp add ifact --scope user --url https://ifact.net/mcp - 02
装上 ifact skill
它会按 ifact 的约定做事:一个产品一个项目,做完只给一个链接。
mkdir -p ~/.omp/agent/skills/ifact && curl -fsSL https://ifact.net/skill.md -o ~/.omp/agent/skills/ifact/SKILL.md
以后需要重新登录,输入 /mcp reauth ifact。
ChatGPT
从插件目录装上 ifact。
- 01
打开 ifact 的插件页
打开 ChatGPT 插件目录里的 ifact,点安装。
- 02
登录 ifact 并允许
第一次用时会打开 ifact,登录后点允许;没有账号就当场注册。
- 03
在对话里选上它
在对话里选上 ifact,再说要做什么。
Cursor
写进 mcp.json,按提示登录。
- 01
写进 mcp.json
加到
~/.cursor/mcp.json;文件已经存在的话,只把 ifact 这一段放进mcpServers里:~/.cursor/mcp.json{ "mcpServers": { "ifact": { "url": "https://ifact.net/mcp" } } } - 02
第一次用时登录
Cursor 会提示登录,在浏览器里登录 ifact,点允许。
WorkBuddy
一行命令接好,再在界面里点一次「信任」。
- 01
在终端里运行这一行
macOS 上运行。也可以把这一行发给 WorkBuddy,让它自己运行。它会装好 ifact skill,并把 ifact 写进 WorkBuddy 的 MCP 配置。以后再运行一次,就是更新。
curl -fsSL https://ifact.net/setup.sh | sh - 02
在浏览器里点一次允许
授权页会自己打开;没打开的话,复制终端里给的地址。登录 ifact,没有账号会直接注册。
- 03
在 WorkBuddy 里点「信任」
打开 MCP 服务管理,找到 ifact,点它旁边的 信任,然后新开一个对话。WorkBuddy 要你本人确认每一个手动接入的服务,这一步只能你来点。
新对话里还没有 ifact 的工具:⌘Q 完全退出 WorkBuddy 再打开,关窗口不算退出。
不想运行脚本(比如在 Windows 上):在 ifact 的 设置 → agent 连接 里生成个人访问令牌,加到 ~/.workbuddy-ai/mcp.json;文件已经存在的话,只把 ifact 这一段放进 mcpServers 里,再点「信任」:
{
"mcpServers": {
"ifact": {
"type": "http",
"url": "https://ifact.net/mcp",
"headers": { "Authorization": "Bearer 你的令牌" }
}
}
}其他客户端
任何支持远程 MCP 的客户端都能接。
- 01
把地址添加为远程 MCP 服务器
VS Code、Windsurf 这类支持远程 MCP 的客户端,都按 HTTP(Streamable HTTP)服务器添加这个地址:
https://ifact.net/mcp - 02
第一次用时登录
支持 OAuth 的客户端会打开浏览器,在浏览器里登录 ifact,点允许。不支持的,在 设置 → agent 连接 里生成个人访问令牌,加上请求头
Authorization: Bearer 你的令牌。 - 03
装上 skill(可选)
支持 skill 的 agent,把 skill.md 放进它的 skills 目录,会按 ifact 的约定做事:一个产品一个项目,做完只给一个链接。
装好以后,说一句话
它会在你的画布上建项目、做画板,做完给你一个链接。
- 用 ifact 新建一个项目,做一组新品发布的海报,三个方向排成一行。
- 把这份需求在 ifact 上整理成文档,再照着它做一张定价页。
- 看一下 ifact 画板上的评论,按评论改好。
还可以
在画布上把任务派给这台电脑
运行这一行就能开(安装时加上 --worker 也行)。它在后台运行,开机自动启动,任务交给本机的 Claude Code 或 Codex。
artifact worker install只让 agent 动一个文件夹
装好以后用 ifact-claude 或 ifact-codex 启动,agent 只能读写 ~/ifact-agent,碰不到你的其他文件。
curl -fsSL https://ifact.net/agent.sh | sh把本地文件推成画板
安装时顺带装好了 artifact 命令。先登录一次,之后一个网页、一个文件夹或一份 Markdown,推上去就是一张画板;同一个路径再推,就是更新。
artifact login --server https://ifact.netartifact push ./site管理和断开
每台电脑、每个连接都列在 设置 → agent 连接 里,随时可以撤销。agent 用你的权限干活,修改记录署它自己的名字。
遇到问题
终端说「没找到 Claude Code、Codex 或 WorkBuddy」
先装好其中一个,再运行一次那一行命令。
授权页没有自己打开
把终端里显示的地址复制到浏览器。验证码 10 分钟内有效,过期了就再运行一次。
agent 说找不到 ifact 的工具
重开客户端,或者在它的 /mcp 里看 ifact 是不是已经连上、登录过。用 Claude 或 ChatGPT 的话,确认这次对话里打开了 ifact 连接器。WorkBuddy 要在 MCP 服务管理里点 ifact 旁边的「信任」,再新开一个对话。
客户端不支持 OAuth 登录
在 设置 → agent 连接 里生成个人访问令牌,按客户端的写法加上请求头 Authorization: Bearer 你的令牌。令牌只显示一次,记得先复制。
Codex 提示 config.toml 里已经有 ifact 的配置
打开 ~/.codex/config.toml,删掉 [mcp_servers.ifact] 那一段,再运行一次。
怎么更新
再运行一次同一行命令。已经接好的连接不会断,只更新 skill 和命令行。
还有问题,看使用文档,或者发邮件到 [email protected]。