# ClipNow MCP — ChatGPT / Codex 接入指南

Browser page: https://clipnow.art/mcp/chatgpt
MCP Endpoint: https://api.zhiyu.art/assets/mcp

在 ChatGPT / Codex 桌面端或 CLI 中接入 ClipNow 云端 MCP，用自然语言驱动生成与时间线剪辑。

## 一句话让 Agent 自动配置

如果你正在 ChatGPT / Codex 桌面端或本地 CLI 会话中，可以直接将下方提示词发给 Agent，让它自动读取本页并完成 ClipNow MCP 配置：

```text
中文：
阅读 https://clipnow.art/mcp/chatgpt ，帮我安装配置 ClipNow MCP 并创建一个新的创作任务。

English:
Read https://clipnow.art/mcp/chatgpt to configure ClipNow MCP and set up a new creative task for me.
```

> 若当前会话运行在浏览器网页沙箱中（无法修改本机 ~/.codex 配置），请打开本地桌面端或终端 CLI 执行以下步骤，或在网页端 Connectors 中直接填入远程 MCP 地址 https://api.zhiyu.art/assets/mcp。

## 添加 ClipNow MCP 服务

ClipNow 提供云端托管的 Streamable HTTP MCP 服务，无需在本地安装庞大的渲染依赖。你可以通过命令行或配置文件直接添加：

### 方式 A：通过 Codex CLI 命令添加

```bash
codex mcp add clipnow --url https://api.zhiyu.art/assets/mcp
```

### 方式 B：写入 ~/.codex/config.toml 配置文件

打开 ~/.codex/config.toml（Windows 为 %USERPROFILE%\.codex\config.toml），添加以下配置块：

```toml
[mcp_servers.clipnow]
url = "https://api.zhiyu.art/assets/mcp"
```

## 登录与知鱼账号授权

添加完成后，执行登录命令拉起浏览器完成 OAuth 2.1 授权（知鱼通行证登录）：

```bash
codex mcp login clipnow
```

浏览器会自动打开知鱼账户授权页（account.zhiyu.art），登录并勾选权限后点击「同意授权」即可。如果授权超时或被关闭，重新运行上述命令即可。

## 验证连接

在终端中确认 clipnow 服务已注册并处于启用状态：

```bash
codex mcp list
codex mcp get clipnow
```

注意：MCP 工具列表在会话启动时加载。完成添加和授权后，请务必**新建一个对话（New Thread）**，新对话才能调用 ClipNow 工具。

## 开始第一个创作对话

新建对话后，粘贴以下提示词开启你的第一个 ClipNow 创作任务：

```text
ClipNow MCP 已经连接好了。请先调用 clipnow_doctor 检查连接状态与我的贝壳余额，然后向我整体介绍一下你可以做什么，尤其是这四个部分：
1. AI 生成（视频、图片、音乐、人声配音、音效、3D 模型）
2. Studio 无限画布（灵感分镜发散、多节点编排、批量生成、视频深度信息捕捉）
3. Studio 时间线剪辑（口播去水词、智能字幕、MG 动画、花字与片段模板、转场与 LUT 调色）
4. 素材与资产库（搜索知鱼商用素材库、管理我的个人与项目资产、读取音视频理解档案）
之后问我有什么素材、想做什么样的内容，告诉我你可以根据我的具体需求一步步开始制作，并且我也可以随时打开 ClipNow Studio（https://studio.clipnow.art）自己调整画布、时间线、字幕或 MG 动画。
```