Treza

Treza 插件

通过编码 Agent 制作 AI 视频。此插件将 Cursor、Codex、Gemini CLI、Claude Code，以及任何支持 Agent Plugins 或 MCP 的客户端连接到 Treza，让你的 Agent 根据描述制作短片、完成你已有的媒体素材，并构建可按计划渲染视频并发布到 YouTube 和 TikTok 的视频工作流。

• 服务：https://www.trezalabs.com/api/mcp（Streamable HTTP，使用动态客户端注册的 OAuth）
• 各应用的设置说明：https://www.trezalabs.com/integrations
• 文档：https://docs.trezalabs.com/api/mcp-server
• 隐私：https://docs.trezalabs.com/terms-and-privacy/privacy

安装

首次连接时，系统会使用 Google 帮你登录 Treza 并创建账号。无需粘贴密钥。

Cursor。 添加到 Cursor，或将以下内容放入 ~/.cursor/mcp.json（或项目中的 .cursor/mcp.json），然后重启 Cursor：

{
  "mcpServers": {
    "treza": { "url": "https://www.trezalabs.com/api/mcp" }
  }
}

Codex CLI。

codex mcp add treza --url https://www.trezalabs.com/api/mcp
codex mcp login treza

在 ChatGPT 桌面应用中，Treza 位于 ChatGPT 和 Codex 共用的插件目录中：打开 Plugins，打开 Treza 并添加。

Gemini CLI。 此仓库是一个 Gemini CLI 扩展：

gemini extensions install https://github.com/treza-labs/treza-plugin

然后在 Gemini CLI 中运行 /mcp auth treza。Gemini 也会加载 skills/ 中的技能。

Antigravity CLI。 将 Treza 添加到 ~/.gemini/config/mcp_config.json，然后输入 /mcp 登录：

{
  "mcpServers": {
    "treza": { "serverUrl": "https://www.trezalabs.com/api/mcp" }
  }
}

Claude Code。

claude mcp add --transport http --scope user treza https://www.trezalabs.com/api/mcp

然后在 Claude Code 中运行 /mcp 并登录。

Cline。 按照 llms-install.md 中的说明操作，或在 MCP Servers 下将 URL 添加到 Remote Servers，选择 Streamable HTTP，然后点击 Authenticate。

仅启动本地服务的客户端。 此仓库提供 treza-mcp，这是一个小型 Node 桥接程序，可将每个工具、提示词和资源转发到托管服务。它需要在 API 密钥页面 获取限定范围的密钥，并将其设置为 TREZA_API_KEY：

{
  "mcpServers": {
    "treza": {
      "command": "npx",
      "args": ["-y", "treza-mcp"],
      "env": { "TREZA_API_KEY": "treza_live_..." }
    }
  }
}

TREZA_MCP_URL 可覆盖端点（用于 staging、可自托管）。桥接程序不会在本地运行任何内容；它只是一个代理。

包含内容

文件	用途
plugin.json	Agent Plugins 清单
.cursor-plugin/plugin.json	Cursor 插件清单：包含相同的服务和技能，以及徽标
mcp.json	为支持插件的客户端声明 Treza 远程 MCP 服务
skills/treza-video-pipelines/	一项技能，指导 Agent 用最短路径制作视频，并在开始前估算渲染价格
gemini-extension.json	Gemini CLI 扩展清单（使用相同的远程服务）
llms-install.md	Agent（例如 Cline）可自行遵循的设置步骤
bin/treza-mcp.mjs	通过 npm 以 treza-mcp 名称发布的 stdio 桥接程序。插件本身不会运行它

工具

Agent 可调用的 26 个工具：

• 制作视频： make_video 可通过一次调用，根据描述制作一个片段。它会选择模型、准备渲染并返回价格；用户接受后，run_pipeline 会启动渲染。
• 处理现有媒体： list_assets 可浏览媒体库，import_media 可添加文件（通过公开链接添加，或通过 create_upload_url 发送本地文件），edit_asset 可对单个文件执行一项操作（字幕、放大、修剪、裁剪、叠加、移除背景），assemble_video 可将片段与旁白和背景音乐合并，并添加字幕。
• 流水线： list_pipeline_templates、list_node_types、get_node_type、create_pipeline、update_pipeline、publish_pipeline、list_pipelines、get_pipeline、set_schedule_paused
• 运行： run_pipeline、get_run、list_runs、cancel_run
• 频道与发布： list_connected_channels、connect_channel 会返回一个链接，供用户在自己的浏览器中连接 YouTube 频道或 TikTok 账号；publish_asset 会整理好已完成的视频，供发布前审核
• 预算与账号： estimate_run_cost、get_credit_balance、get_profile、create_api_key（仅限 OAuth 连接）

另外两个工具 open_library 和 confirm_publish 属于 Treza 的面板：它们只会在用户使用面板时运行，不会由模型调用。

只读工具带有 readOnlyHint。渲染会消耗预付额度，因此 make_video 和 estimate_run_cost 会先报价；用户接受报价后，run_pipeline 会按该价格启动一次运行。渲染会在后台进行，并返回一个可通过 get_run 轮询的运行任务。

在 ChatGPT 和 Claude 等支持 MCP Apps 面板的客户端中，结果会以面板形式显示：完成的文件、附有“开始渲染”按钮的价格、用于选择文件的媒体库、流水线图，以及发布前的帖子。其他客户端会以文本和链接的形式返回相同结果。使用 publish_asset 发布需要面板；如果没有面板，请通过以 youtube-upload 或 tiktok-upload 节点结尾的流水线进行发布。

运行任务会消耗 Treza 账号中的预付额度。拥有钱包的 Agent 可通过 x402 充值，无需人工介入。

采用 MIT 许可证。支持邮箱：[email protected]