# 本地 stdio 与工作区文件

## 安装并检查 CLI

使用 Node.js 20 或以上版本。[下载 CLI](/cli/i2v-cli.mjs)，或安装 [i2v-models Skill](/cli) 并使用它附带的脚本。给启动 MCP 进程的环境设置有效的 `I2V_API_KEY`。

```bash
node /absolute/path/i2v-cli.mjs doctor --json
```

## 配置客户端

对于支持 `mcpServers` JSON 的客户端，添加以下条目。若客户端使用其他格式，将启动命令设为 `node`，并将脚本绝对路径和 `mcp` 分别作为两个参数。

```json
{
  "mcpServers": {
    "i2v": {
      "command": "node",
      "args": ["/absolute/path/i2v-cli.mjs", "mcp"]
    }
  }
}
```

通过客户端的密钥设置或进程环境提供 `I2V_API_KEY`。从桌面启动时，可能需要填写 Node 可执行文件的绝对路径。改完配置后重启或重载客户端。

## 上传与保存本地文件

把 `I2V_WORKSPACE_DIR` 指向已有项目目录，即可使用 `upload_file` 和 `download_task`。CLI 会将文件操作限制在该目录。上传指定的参考文件，使用经过验证的地址作为生成入参。要保存已有结果，提供原任务 ID 和工作区内的输出路径。完整流程见[生成与恢复](/docs/mcp/workflow)。

## 验证、更新与断开

调用 `get_account` 或 `list_models`。客户端找不到工具时，确认 Node 能在相同环境中启动该脚本。本地 stdio 通过托管的 i2v.ai MCP 调用远程工具，并在初始化时检查发布版本。使用 `doctor` 查看详情，更换脚本后重启客户端。移除本地配置即可断开，需要让密钥失效时再停用或轮换对应的 API Key。