# 安装 ifact

ifact 是人和 AI agent 共用的无限画布。这一页写给你，一个 AI agent：照着做，就能在你所在的这台电脑上把 ifact 接到你自己身上（MCP 服务 `https://ifact.net/mcp`，加上 ifact skill）。从头往下做。

## 这一页怎么用

1. 先弄清你运行在哪个客户端里（见下面的列表），只做那一个客户端的那一节。都不是就用「其他客户端」；拿不准就问用户。
2. 命令原样运行。别去翻客户端的程序文件，也别猜它的配置放在哪：每一节已经写明了。
3. `setup.sh` 从不提问，也不等输入。它会打开浏览器让用户点一次允许；浏览器没打开，就把它打印的地址交给用户。
4. 有些步骤只能用户自己做：在浏览器里点允许、在 WorkBuddy 里点「信任」、重开客户端。直接说明这是用户要做的，说清楚点哪里，然后等。别想靠改客户端的文件代替。
5. 新开一个对话，里面出现了 ifact 的工具（比如 `list_canvases`、`create_artboard`），才算装好。在那之前，别说已经装好了。
6. 要是 MCP 还是没有，`artifact` 命令（`setup.sh` 装的）不用 MCP 也能干活：`artifact canvases`、`artifact push <文件夹或文件>`。

只要一个客户端的话：`https://ifact.net/install.md?client=<id>` 返回这段说明和那一节。

## 客户端

- `claude-code`：Claude Code
- `claude`：Claude Desktop
- `codex`：Codex
- `gemini`：Gemini CLI
- `grok`：Grok Build
- `opencode`：OpenCode
- `openclaw`：OpenClaw
- `hermes`：Hermes
- `pi`：Pi
- `minimax`：MiniMax Code
- `kimi`：Kimi Code
- `antigravity`：Antigravity
- `oh-my-pi`：Oh My Pi
- `chatgpt`：ChatGPT
- `cursor`：Cursor
- `workbuddy`：WorkBuddy
- `other`：其他客户端

## Claude Code

一行命令接好，浏览器里点一次允许。

### 第 1 步：在终端里运行这一行

macOS 和 Linux 都可以，这台电脑上的 Codex 也会一起接好。以后再运行一次，就是更新。

```sh
curl -fsSL https://ifact.net/setup.sh | sh
```

### 第 2 步：在浏览器里点一次允许

授权页会自己打开；没打开的话，复制终端里给的地址。登录 ifact，没有账号会直接注册。

### 第 3 步：重开 Claude Code

已经开着的要重开一次，才会用上新的连接和 ifact skill。

补充: 不想运行脚本（比如在 Windows 上）：运行 `claude mcp add --transport http --scope user ifact https://ifact.net/mcp`，再在 Claude Code 里输入 `/mcp` 登录。

## Claude Desktop

添加自定义连接器，网页版和手机上也一样。

### 第 1 步：添加自定义连接器

在 **自定义 → 连接器** 里添加自定义连接器，名称填 ifact，地址填：

```sh
https://ifact.net/mcp
```

### 第 2 步：连接，然后允许

点 **连接**，登录 ifact，再点允许。团队版和企业版要先由管理员在组织设置里添加，成员再点连接。

### 第 3 步：在对话里打开 ifact

从输入框的 **+ → 连接器** 打开 ifact，再告诉它你要做什么。

补充: 网页版和手机上的 Claude 用的是同一个连接器。想让它更熟悉 ifact 的做法，可以在 **自定义 → 技能** 里上传 [skill.zip](https://ifact.net/skill.zip)。

## Codex

一行命令接好，和 Claude Code 用同一次授权。

### 第 1 步：在终端里运行这一行

macOS 和 Linux 都可以，这台电脑上的 Claude Code 也会一起接好。以后再运行一次，就是更新。

```sh
curl -fsSL https://ifact.net/setup.sh | sh
```

### 第 2 步：在浏览器里点一次允许

授权页会自己打开；没打开的话，复制终端里给的地址。登录 ifact，没有账号会直接注册。

### 第 3 步：重开 Codex

命令行、桌面版和 IDE 插件共用一份配置，接一次都能用。已经开着的要重开一次。

补充: 不想运行脚本：运行 `codex mcp add ifact --url https://ifact.net/mcp`，它会打开浏览器让你登录；没打开就运行 `codex mcp login ifact`。

## Gemini CLI

命令行添加，浏览器登录。

### 第 1 步：添加 ifact

在终端里运行：

```sh
gemini mcp add -s user --transport http ifact https://ifact.net/mcp
```

### 第 2 步：登录

打开 gemini，输入 `/mcp auth ifact`，在浏览器里登录 ifact，点允许。

### 第 3 步：装上 ifact skill

它会按 ifact 的约定做事：一个产品一个项目，做完只给一个链接。

```sh
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](https://ifact.net/install.md?client=antigravity)。

## Grok Build

命令行添加，第一次用时登录。

### 第 1 步：添加 ifact

在终端里运行：

```sh
grok mcp add --transport http ifact https://ifact.net/mcp
```

### 第 2 步：第一次用时登录

第一次用到 ifact 时会打开浏览器，在浏览器里登录 ifact，点允许。也可以在 grok 里输入 `/mcps`，选中 ifact 后按 `i` 登录。

### 第 3 步：装上 ifact skill

它会按 ifact 的约定做事：一个产品一个项目，做完只给一个链接。

```sh
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

写进配置文件，命令行登录。

### 第 1 步：写进配置文件

加到 `~/.config/opencode/opencode.json`；文件已经存在的话，只把 ifact 这一段放进 `mcp` 里：

文件: `~/.config/opencode/opencode.json`

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ifact": { "type": "remote", "url": "https://ifact.net/mcp", "enabled": true }
  }
}
```

### 第 2 步：登录

在终端里运行这一行，在浏览器里登录 ifact，点允许。

```sh
opencode mcp auth ifact
```

### 第 3 步：装上 ifact skill

它会按 ifact 的约定做事：一个产品一个项目，做完只给一个链接。

```sh
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。

### 第 1 步：添加 ifact

添加和登录都要先停掉本机的 Gateway，transport 要写 streamable-http：

```sh
openclaw gateway stop
openclaw mcp add ifact --url https://ifact.net/mcp --transport streamable-http --auth oauth
```

### 第 2 步：登录，再启动 Gateway

第一行会给出授权链接，在浏览器里登录 ifact，点允许。

```sh
openclaw mcp login ifact
openclaw gateway start
```

### 第 3 步：装上 ifact skill

它会按 ifact 的约定做事：一个产品一个项目，做完只给一个链接。

```sh
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

命令行添加，第一次连接时登录。

### 第 1 步：添加 ifact

在终端里运行：

```sh
hermes mcp add ifact --url https://ifact.net/mcp --auth oauth
```

### 第 2 步：第一次连接时登录

Hermes 第一次连接 ifact 时会打开浏览器，在浏览器里登录 ifact，点允许。没打开的话，运行 `hermes mcp login ifact`，再在会话里输入 `/reload-mcp`。

### 第 3 步：装上 ifact skill

Hermes 可以直接从地址安装，会先做安全检查请你确认；以后运行 `hermes skills update` 就能更新。

```sh
hermes skills install https://ifact.net/skill.md
```

## Pi

内置 MCP，命令行添加并登录。

### 第 1 步：添加 ifact

Pi 从 0.99 起内置 MCP。在终端里运行：

```sh
pi mcp add ifact --url https://ifact.net/mcp
```

### 第 2 步：登录

在终端里运行这一行，在浏览器里登录 ifact，点允许。

```sh
pi mcp login ifact
```

### 第 3 步：装上 ifact skill

它会按 ifact 的约定做事：一个产品一个项目，做完只给一个链接。

```sh
mkdir -p ~/.agents/skills/ifact && curl -fsSL https://ifact.net/skill.md -o ~/.agents/skills/ifact/SKILL.md
```

## MiniMax Code

用个人访问令牌接入。

### 第 1 步：生成令牌

MiniMax Code 的自定义 MCP 只能用令牌登录。在 ifact 的 [设置 → agent 连接](https://ifact.net/settings) 里找到个人访问令牌，点 **生成令牌**，复制下来。

### 第 2 步：写进配置文件

加到 `~/.minimax/mcp.json`，把令牌换进去。桌面版也可以在 **插件管理 → MCP Servers** 里粘贴这段：

文件: `~/.minimax/mcp.json`

```json
{
  "mcpServers": {
    "ifact": {
      "type": "streamable-http",
      "url": "https://ifact.net/mcp",
      "headers": { "Authorization": "Bearer 你的令牌" },
      "enabled": true
    }
  }
}
```

### 第 3 步：装上 ifact skill

它会按 ifact 的约定做事：一个产品一个项目，做完只给一个链接。

```sh
mkdir -p ~/.agents/skills/ifact && curl -fsSL https://ifact.net/skill.md -o ~/.agents/skills/ifact/SKILL.md
```

## Kimi Code

写进配置文件，会话里登录。

### 第 1 步：写进配置文件

加到 `~/.kimi-code/mcp.json`，也可以在 kimi 里输入 `/mcp-config` 一步步添加：

文件: `~/.kimi-code/mcp.json`

```json
{
  "mcpServers": {
    "ifact": { "url": "https://ifact.net/mcp" }
  }
}
```

### 第 2 步：登录

在 kimi 里输入 `/mcp-config login ifact`，在浏览器里登录 ifact，点允许。

### 第 3 步：装上 ifact skill

它会按 ifact 的约定做事：一个产品一个项目，做完只给一个链接。

```sh
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 里登录。

### 第 1 步：写进 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`

```json
{
  "mcpServers": {
    "ifact": { "serverUrl": "https://ifact.net/mcp" }
  }
}
```

### 第 2 步：登录

在 App 的 **Customizations → Installed → MCP Servers** 里点 **Authenticate**，在浏览器里登录 ifact，点允许。再把授权码粘贴回 Antigravity。

### 第 3 步：装上 ifact skill

App、IDE 和命令行 `agy` 都会读这里。它会按 ifact 的约定做事：一个产品一个项目，做完只给一个链接。

```sh
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 里一条命令添加并登录。

### 第 1 步：在 omp 里添加

在 omp 的会话里输入这一行，它会打开浏览器，在浏览器里登录 ifact，点允许。要带上 `--scope user`，不然只加到当前项目。

```sh
/mcp add ifact --scope user --url https://ifact.net/mcp
```

### 第 2 步：装上 ifact skill

它会按 ifact 的约定做事：一个产品一个项目，做完只给一个链接。

```sh
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。

### 第 1 步：打开 ifact 的插件页

打开 ChatGPT 插件目录里的 [ifact](https://chatgpt.com/plugins/plugin_asdk_app_6af0a14e4df0819196caf57652a384dd)，点安装。

### 第 2 步：登录 ifact 并允许

第一次用时会打开 ifact，登录后点允许；没有账号就当场注册。

### 第 3 步：在对话里选上它

在对话里选上 ifact，再说要做什么。

## Cursor

写进 mcp.json，按提示登录。

### 第 1 步：写进 mcp.json

加到 `~/.cursor/mcp.json`；文件已经存在的话，只把 ifact 这一段放进 `mcpServers` 里：

文件: `~/.cursor/mcp.json`

```json
{
  "mcpServers": {
    "ifact": { "url": "https://ifact.net/mcp" }
  }
}
```

### 第 2 步：第一次用时登录

Cursor 会提示登录，在浏览器里登录 ifact，点允许。

## WorkBuddy

一行命令接好，再在界面里点一次「信任」。

### 第 1 步：在终端里运行这一行

macOS 上运行。也可以把这一行发给 WorkBuddy，让它自己运行。它会装好 ifact skill，并把 ifact 写进 WorkBuddy 的 MCP 配置。以后再运行一次，就是更新。

```sh
curl -fsSL https://ifact.net/setup.sh | sh
```

### 第 2 步：在浏览器里点一次允许

授权页会自己打开；没打开的话，复制终端里给的地址。登录 ifact，没有账号会直接注册。

### 第 3 步：在 WorkBuddy 里点「信任」

打开 **MCP 服务管理**，找到 ifact，点它旁边的 **信任**，然后新开一个对话。WorkBuddy 要你本人确认每一个手动接入的服务，这一步只能你来点。

补充: 新对话里还没有 ifact 的工具：**⌘Q** 完全退出 WorkBuddy 再打开，关窗口不算退出。

补充: 不想运行脚本（比如在 Windows 上）：在 ifact 的 [设置 → agent 连接](https://ifact.net/settings) 里生成个人访问令牌，加到 `~/.workbuddy-ai/mcp.json`；文件已经存在的话，只把 ifact 这一段放进 `mcpServers` 里，再点「信任」：

文件: `~/.workbuddy-ai/mcp.json`

```json
{
  "mcpServers": {
    "ifact": {
      "type": "http",
      "url": "https://ifact.net/mcp",
      "headers": { "Authorization": "Bearer 你的令牌" }
    }
  }
}
```

## 其他客户端

任何支持远程 MCP 的客户端都能接。

### 第 1 步：把地址添加为远程 MCP 服务器

VS Code、Windsurf 这类支持远程 MCP 的客户端，都按 HTTP（Streamable HTTP）服务器添加这个地址：

```sh
https://ifact.net/mcp
```

### 第 2 步：第一次用时登录

支持 OAuth 的客户端会打开浏览器，在浏览器里登录 ifact，点允许。不支持的，在 [设置 → agent 连接](https://ifact.net/settings) 里生成个人访问令牌，加上请求头 `Authorization: Bearer 你的令牌`。

### 第 3 步：装上 skill（可选）

支持 skill 的 agent，把 [skill.md](https://ifact.net/skill.md) 放进它的 skills 目录，会按 ifact 的约定做事：一个产品一个项目，做完只给一个链接。

## 遇到问题

### 终端说「没找到 Claude Code、Codex 或 WorkBuddy」

先装好其中一个，再运行一次那一行命令。

### 授权页没有自己打开

把终端里显示的地址复制到浏览器。验证码 10 分钟内有效，过期了就再运行一次。

### agent 说找不到 ifact 的工具

重开客户端，或者在它的 `/mcp` 里看 ifact 是不是已经连上、登录过。用 Claude 或 ChatGPT 的话，确认这次对话里打开了 ifact 连接器。WorkBuddy 要在 MCP 服务管理里点 ifact 旁边的「信任」，再新开一个对话。

### 客户端不支持 OAuth 登录

在 [设置 → agent 连接](https://ifact.net/settings) 里生成个人访问令牌，按客户端的写法加上请求头 `Authorization: Bearer 你的令牌`。令牌只显示一次，记得先复制。

### Codex 提示 config.toml 里已经有 ifact 的配置

打开 `~/.codex/config.toml`，删掉 `[mcp_servers.ifact]` 那一段，再运行一次。

### 怎么更新

再运行一次同一行命令。已经接好的连接不会断，只更新 skill 和命令行。
