# ClipNow MCP — Claude Code 接入指南

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

使用 claude mcp add 一行命令接入 ClipNow，支持 OAuth 2.1 自动发现与令牌自动续期。

## 一句话让 Claude Code 自动接入

直接把下面这句话发给 Claude Code，它会自动读取本页指令并替你注册 ClipNow MCP 服务：

```text
中文：
阅读 https://clipnow.art/mcp/claude ，帮我配置 ClipNow MCP 服务并引导我完成授权。

English:
Read https://clipnow.art/mcp/claude to set up the ClipNow MCP server and guide me through authentication.
```

## 安装与登录授权

ClipNow 使用标准 Streamable HTTP 传输协议与 OAuth 2.1 动态注册。在终端运行以下命令将 ClipNow 添加为用户级全局 MCP 服务：

```bash
claude mcp add --transport http --scope user clipnow https://api.zhiyu.art/assets/mcp
```

或者直接写入 ~/.claude.json（或项目根目录 .mcp.json）：

```json
{
  "mcpServers": {
    "clipnow": {
      "type": "http",
      "url": "https://api.zhiyu.art/assets/mcp"
    }
  }
}
```

### 完成 OAuth 登录授权

方式 1（交互式会话内推荐）：启动 claude 后，在输入框输入 /mcp，选择 clipnow 并点击 Authenticate，浏览器将自动打开知鱼账户授权页面，点击「同意授权」即可完成绑定。

```text
/mcp
```

方式 2（终端命令登录）：确认已安装最新 Claude Code CLI 后，可在交互终端中执行：

```bash
claude mcp get clipnow
```

## 验证与排障

验证服务端连通性与 OAuth 元数据是否可达：

```bash
curl -fsS https://api.zhiyu.art/.well-known/oauth-authorization-server
curl -fsS https://api.zhiyu.art/assets/.well-known/oauth-protected-resource/mcp
```

- Claude Code CLI 与桌面端共享 ~/.claude 配置，一次授权后两端均可使用，且 refresh_token 会自动轮换续期。
- 授权完成后请开启一个新会话（New session），首次提问可让 Claude 调用 clipnow_doctor 检查连接与贝壳余额。
- 如果在 Windows PowerShell 中使用 curl，请显式调用 curl.exe 以避免 PowerShell 别名干扰。

## 开始第一个创作对话

在新的 Claude Code 会话中发送以下提示词，快速体验 ClipNow 全链路能力：

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