Rendley Mcp

Rendley MCP

Rendley 的 MCP 服务。它为 AI 助手提供完整的视频编辑器：连接一次后，只需描述你的需求，就能在你平时使用的同一聊天中创建和编辑视频。在底层，它会在浏览器中操控托管的 Rendley 编辑器，并代表你调用托管的 Rendley API：

• 编辑器：https://app.rendley.com
• API：https://api.rendley.com/v1

同一个 Agent 也可通过普通 HTTP（POST /v1/agent）访问，供不支持 MCP 的后端使用。请参阅 REST 示例。

有两种使用方式：

1. 使用托管服务：地址为 https://mcp.rendley.com/mcp。无需运行任何程序。请参阅连接客户端。
2. 自托管此服务：连接到托管的 Rendley API。请参阅自托管服务。

📖 完整文档，包含分步设置指南和截图：docs.rendley.com/mcp

---

连接客户端

任何支持远程 MCP 的客户端都可以连接。将客户端指向该端点，然后通过登录或使用 API 密钥进行身份验证：

https://mcp.rendley.com/mcp

• 使用 Rendley 登录（推荐）：客户端会打开 Rendley 登录标签页，你只需批准访问即可。无需复制任何内容，之后也可以撤销授权。
• API 密钥：客户端会发送 Authorization: Bearer YOUR_RENDLEY_API_KEY 标头。请在 Settings → API Keys 创建密钥；参阅获取 API 密钥。

大多数客户端都接受类似这样的 JSON 配置：

{
  "mcpServers": {
    "rendley": {
      "url": "https://mcp.rendley.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_RENDLEY_API_KEY" }
    }
  }
}

若要登录，请移除 headers 代码块，让客户端运行浏览器登录流程。

文档提供了针对各个客户端的图解指南：

• Claude：桌面端、Web 端和 Claude Code。
• Codex：Codex 桌面应用和 CLI。
• 其他客户端：任何其他支持远程 MCP 的客户端，以及供仅支持本地连接的客户端使用的 mcp-remote 桥接程序。

Claude Code 的具体配置方法：

claude mcp add --transport http rendley https://mcp.rendley.com/mcp \
  --header "Authorization: Bearer YOUR_RENDLEY_API_KEY"

试用

询问客户端它能做什么，然后试着提出一个简单请求：

Rendley 在这里能做什么？

列出我的项目。

如果它列出了 Rendley 工具和你的项目，就表示已连接。接下来，描述你想制作的视频，助手会创建项目、完成剪辑并返回链接。

---

自托管服务

此仓库仅包含 MCP 服务；它不会在本地运行完整的 Rendley 技术栈。它会与托管的 Rendley API 和编辑器通信。自托管时，请将客户端指向你自己的 https://<host>/mcp，而不是 https://mcp.rendley.com/mcp。

要求

• Bun >= 1.1（或 Docker）
• 一个用于连接的 Rendley 账户。客户端使用自己的 API 密钥（Settings → API Keys、指南）或通过 OAuth 登录，在每次请求时进行身份验证。服务本身不会存储任何密钥。

本地运行

git clone https://github.com/rendleyhq/rendley-mcp.git
cd rendley-mcp

bun install
bun dev                       # http://localhost:8787

API_BASE_URL 和 APP_BASE_URL 默认指向托管的 Rendley API 和编辑器，因此无需 .env 文件，服务即可开箱运行；只有在要连接其他技术栈时才需复制 .env.example。服务本身不持有任何凭据：每个请求都会使用调用者自己的 API 密钥或 OAuth 令牌进行身份验证。

默认情况下，服务会使用本地 Chrome（BROWSER_MODE=local）操控编辑器，因此无需额外的基础设施。bun install 会下载打包的 Chromium；设置 USE_CHROME_CHANNEL=true 后，服务会优先使用你已安装的 Google Chrome，并在找不到时回退到打包的浏览器。在无可用 GPU 的机器上，可设置 CPU_ONLY=true；设置 HEADLESS=false 可在可见窗口中查看编辑器。

验证服务是否已启动：

curl http://localhost:8787/health
# {"status":"ok","browser_mode":"local"}

Docker

docker compose up -d --build
curl http://localhost:8787/health

将客户端连接到你的实例

使用与托管服务相同的客户端步骤，但将端点替换为你的主机地址（例如 http://localhost:8787/mcp），并使用你的 API 密钥作为 bearer token 进行身份验证：

{
  "mcpServers": {
    "rendley": {
      "url": "http://localhost:8787/mcp",
      "headers": { "Authorization": "Bearer YOUR_RENDLEY_API_KEY" }
    }
  }
}

OAuth。 OAuth 登录始终启用。支持 OAuth 的客户端（Claude connectors、ChatGPT、codex mcp login rendley）可以通过托管登录流程登录，而无需粘贴密钥；服务会通过 RFC 9728 受保护资源元数据公布授权服务器。将 MCP_PUBLIC_URL 设置为此服务的公网 URL，以便发现流程指向正确的主机。

远程浏览器模式

对于托管部署，请设置 BROWSER_MODE=remote，并将服务指向已部署的远程浏览器工作进程。服务会生成一个短期有效的编辑器会话令牌，并将其发送给工作进程，因此调用方的凭据不会离开此进程：

BROWSER_MODE=remote
BROWSER_WORKER_URL=https://<your-browser-worker-host>
BROWSER_WORKER_TOKEN=<must match the worker's secret>

---

配置

所有配置均通过环境变量完成；请从 .env.example 开始，其中记录了每个选项。主要配置如下：

变量	默认值	用途
API_BASE_URL	https://api.rendley.com/v1	Rendley API 根地址。可替换为暂存环境或可自托管技术栈的地址。
APP_BASE_URL	https://app.rendley.com	Rendley 编辑器根地址。可替换为暂存环境或可自托管技术栈的地址。
MCP_PUBLIC_URL	无	此服务的公网 URL，用于 OAuth 发现。
BROWSER_MODE	local	local = 进程内 Playwright Chrome；remote = 远程浏览器工作进程。
HEADLESS	true	仅限本地模式；false 会显示浏览器窗口。
USE_CHROME_CHANNEL	true	仅限本地模式；优先使用已安装的 Chrome，而不是捆绑的 Chromium。
CPU_ONLY	false	在没有 GPU 的主机上强制使用软件 WebGL（SwiftShader）。
QUEUE_CONCURRENCY	120	每个容器中由浏览器支持的并发任务数上限。
CORS_ORIGINS	无	浏览器来源的 CSV 允许列表。留空则禁用 CORS。

端点

方法	路径
POST	/mcp	MCP Streamable HTTP 传输
POST	/v1/agent	启动异步编辑任务
GET	/v1/jobs/:id	轮询任务
GET	/health	存活状态

REST 示例

无需使用 MCP 客户端即可驱动 Agent。同一个 Agent 也可通过纯 HTTP 使用。启动任务后会返回一个 ID，然后轮询，直至视频就绪。完整参考文档：docs.rendley.com/mcp/api-access。

# Start a job (swap in http://localhost:8787 for a self-hosted instance)
curl -X POST https://mcp.rendley.com/v1/agent \
  -H "Authorization: Bearer $RENDLEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Create a 9:16 slideshow from these files",
    "files": [
      { "url": "https://cdn.example.com/photo1.jpg" },
      { "url": "https://cdn.example.com/photo2.jpg" }
    ]
  }'

# Poll it
curl -H "Authorization: Bearer $RENDLEY_API_KEY" \
  https://mcp.rendley.com/v1/jobs/<job_id>

运行时说明

• 每个实例仅支持单租户。
• 首次收到由浏览器支持的请求时，浏览器会按需启动；并发请求会通过单独的标签页复用浏览器，这些标签页会在请求完成后关闭。
• 媒体附件仅支持公开 URL。编辑器通过批量上传 API 导入附件（不支持通过 MCP 上传本地文件）。
• REST 任务为异步任务，必须轮询。任务状态保存在内存中：已完成的记录会保留 1 小时，重启后所有任务状态都会丢失（正在执行的任务会丢失，已完成结果将无法获取）。
• 只要服务能够响应，/health 就会显示健康；浏览器启动失败会在由浏览器支持的请求中显现。

脚本

bun dev          # watch mode, pretty logs
bun start        # production start
bun run typecheck

许可证

Apache License 2.0。© 2026 Rendley。