# ClipNow MCP 连接器接入指南

Browser page: https://clipnow.art/mcp
MCP Endpoint: https://api.zhiyu.art/assets/mcp
OAuth Discovery: https://api.zhiyu.art/.well-known/oauth-authorization-server

## 支持的 AI 客户端安装指南

- **ChatGPT**: https://clipnow.art/mcp/chatgpt — 在 ChatGPT / Codex 桌面端或 CLI 中接入 ClipNow 云端 MCP，用自然语言驱动生成与时间线剪辑。
- **Claude Code**: https://clipnow.art/mcp/claude — 使用 claude mcp add 一行命令接入 ClipNow，支持 OAuth 2.1 自动发现与令牌自动续期。
- **WorkBuddy**: https://clipnow.art/mcp/workbuddy — 支持腾讯云 WorkBuddy / CodeBuddy 连接器一键接入或通过 ~/.workbuddy/mcp.json 配置远程服务。
- **Cursor**: https://clipnow.art/mcp/cursor — 在 ~/.cursor/mcp.json 中添加一行 URL，通过 Cursor 原生 MCP OAuth 授权连接 ClipNow。
- **TRAE Work**: https://clipnow.art/mcp/trae — 在 TRAE 国际版或国内版全局 MCP 配置中接入 ClipNow 云端创作服务。
- **Qoder**: https://clipnow.art/mcp/qoder — 在 Qoder 的 MCP 服务设置中添加 ClipNow 远程连接器，配置完成后即可在 IDE 内直接生成素材与操作 Studio。
- **豆包工作**: https://clipnow.art/mcp/doubao — 在豆包工作的连接器 / MCP 管理中添加 ClipNow 云端服务，让 AI 助手帮你生成图片视频、整理素材与剪辑成片。
- **千问办公**: https://clipnow.art/mcp/qianwen — 在千问办公的 MCP 连接器设置中接入 ClipNow，用自然语言完成素材生成、文档配图与视频剪辑。
- **其他 MCP 客户端**: https://clipnow.art/mcp/general — 适用于 Windsurf、Cline、GitHub Copilot、Cherry Studio、OpenCode、VS Code 及任何支持 Streamable HTTP 的标准 MCP 宿主。

## 标准 mcp.json 配置

```json
{
  "mcpServers": {
    "clipnow": {
      "type": "streamableHttp",
      "url": "https://api.zhiyu.art/assets/mcp",
      "timeout": 60000,
      "headers": {
        "Accept": "application/json, text/event-stream"
      }
    }
  }
}
```

## 工具发现

不要在页面或文档里枚举工具清单：连接建立后调用 `tools/list` 获取当前令牌可见的工具（本次授权 scope 与平台放行清单的交集），一律以它为准。

连接后的第一件事建议调用 `clipnow_doctor` 与 `auth_whoami` 做自检。

## 可选授权范围

- `clipnow:account:read`（默认勾选）
- `clipnow:asset:read`（默认勾选）
- `clipnow:project:read`（默认勾选）
- `clipnow:material:read`（需手动勾选）
- `clipnow:asset:write`（需手动勾选）
- `clipnow:project:write`（需手动勾选）
- `clipnow:task:write`（需手动勾选）
- `clipnow:material:download`（需手动勾选）