远程 MCP 私测 · 接入说明

连接你的 Agent，
从一次读取开始。

Vurctube 的完整本地自动化管线已长期用于短剧本地化与海外发行。本指南专门介绍远程 YouTube MCP 连接，它提供频道读取及经所有者批准的元数据编辑。完整管线的云端迁移正在推进。 了解云端进展。

当前接入条件

• 受邀的 Google 账号及其关联 YouTube 频道。
• 预先注册的 MCP 客户端，支持 Streamable HTTP 及带 PKCE 的 OAuth。原生 Codex 和官方 SDK 客户端已通过私测验收。
• 客户端及模型提供方的设置须符合 Google 的 Limited Use 要求。请先阅读 数据流向与保存期限说明 及 使用条款 。

远程私测不要求本地安装连接器，也不要求你创建个人 Google Cloud 项目。本地 CLI/stdio 是独立的私有接口，并非本指南描述的接入方式。

1. 添加远程连接

在已注册的客户端中使用以下地址：

https://mcp.vurctube.com/mcp

只读客户端使用 mcp:read；单独获批的提案客户端还可请求 mcp:metadata.propose。两者均须使用预先登记且完全匹配的客户端 ID 和回调地址。任意新客户端不能自行注册。不要将 Google 刷新令牌、客户端密钥或授权链接粘贴到 Agent 对话中。

2. 分别授权 Google 访问与 Agent 接入

从 MCP 客户端发起登录，在浏览器中完成 Google 同意流程。Vurctube 请求 openid、 email 及 youtube.readonly；启用元数据编辑时还会请求 youtube.force-ssl。这项 Google 权限的范围比远程工具更广：私测只允许修改标题、简介和标签，不允许上传、发布或删除。请核对应用名称和频道，再单独批准指定 Agent 及其返回地址。本私测不请求 Analytics 或 Reporting 权限。

Vurctube 在托管服务中保存加密的 Google 凭据副本。Agent 获取的是独立的 Vurctube 授权及获准读取的结果，不会拿到该 Google 凭据。Agent 可能把结果传给云端模型提供方。

3. 尝试一次只读请求

返回结果反映请求时的 YouTube 状态。可用信息取决于已授予的权限和频道资格。

4. 审核元数据修改提案

获批的提案客户端可以准备标题、简介或标签修改。打开返回的 Vurctube 审批页，核对频道及修改前后的具体值，再由你本人批准或拒绝。Google 授权本身不等于批准某次编辑，Agent 不能替你作出这项浏览器内的决定。

Vurctube 会检查修改冲突，将获批更新发送一次，然后读回结果。已保存的执行结果不是新的审批请求。如果核验显示不一致或结果未知，应先检查，再考虑新的提案；不要重复写入，也不要假定能够自动回滚。

5. 管理或断开连接

访问 管理连接 ，即可断开连接并删除 Vurctube 保存的频道配置和凭据副本。这不会删除 YouTube 视频或 Agent 历史记录中的副本。你也可以前往 Google 应用权限，单独撤销 Google 项目级授权。

私测连接会在七天内到期。在此期限内，Agent 访问令牌可自动刷新；连接到期后需要重新完成 Google 授权。浏览器身份可复用最多八小时，此后仅验证身份的登录可复用有效频道凭据，无需再次申请全部 YouTube 权限。新增权限、凭据撤销或过期，以及新增 Agent 客户端，仍可能需要再次同意。

远程连接的操作范围

此连接支持频道及视频读取，以及经所有者独立批准的标题、简介和标签修改。远程接入权限与完整本地管线分开管理。

• 提案工具需要单独的客户端权限，每次修改均须在浏览器中审核批准。
• 此远程连接不提供上传、发布、删除、评论或字幕编辑、Analytics 报告或 Content ID。
• 当前仅向受邀所有者及已注册客户端开放，不提供公众注册。

服务未启用或权限缺失时，请检查 Google 项目及同意设置。不要不断重复请求，也不要再次批准结果不明的写入。如需帮助，请将脱敏后的错误信息发送至 zw@vurctne.com ，切勿发送凭据。