MCP

连接AI客户端

使用无状态 Streamable HTTP 端点，并通过 Bearer API 密钥验证每个请求： https://video2url.com/api/mcp.

推荐方式

方式 A：让 Agent 自动安装

复制下面整段提示词，发送给 Codex、Claude Code、Cursor 或其他编程 Agent。Agent 会先识别你正在使用的 MCP 客户端，再带你完成配置。

Agent installation prompt

请在我当前使用的 AI 编程客户端中安装并配置 Video2URL 远程 MCP 服务。第一步先识别我使用的操作系统和支持 MCP 的客户端。只在需要时向我索取 Video2URL API 密钥，不要复述、记录或把密钥提交到任何代码仓库。创建名为 video2url 的服务，使用 Streamable HTTP 地址 https://video2url.com/api/mcp，并设置 Authorization 请求头 Bearer <我的_API_密钥>。请使用该客户端正确的用户级配置文件，保留已有的全部 MCP 服务，并逐项说明修改了哪个文件。如果客户端需要重载或重启，请帮我执行或明确告诉我操作。最后通过列出 Video2URL 工具验证连接，确认 create_upload、complete_upload、get_upload_status、create_share_link、get_share_link 和 revoke_share_link 都可用。如果无法自动写入配置，请告诉我准确的配置文件路径，并且每次只给我一个操作。最终报告中不得显示我的 API 密钥。

预期结果：重启或重新加载客户端，打开 MCP 工具列表，确认出现 6 个 Video2URL 工具。如果没有，请依次检查服务地址、Bearer 前缀和密钥权限范围。

方式 B：手动配置

如果你的客户端支持 Streamable HTTP，可使用下面的通用远程服务配置。只替换 YOUR_API_KEY 占位符，再把 video2url 节点合并进现有配置，不要覆盖其他 MCP 服务。

MCP 客户端配置

{
  "mcpServers": {
    "video2url": {
      "url": "https://video2url.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

验证连接

重启或重新加载客户端，打开 MCP 工具列表，确认出现 6 个 Video2URL 工具。如果没有，请依次检查服务地址、Bearer 前缀和密钥权限范围。

create_upload

需要文件名、MIME 类型和字节大小；返回上传前生成的预签名 URL。

complete_upload

原始文件 PUT 成功后需要 uploadId。

get_upload_status

需要 uploadId 并返回上传状态以及准备就绪时的文件记录。

create_share_link

需要文件ID；标题、可见性和密码是可选的，可见性默认为不列出。

get_share_link

需要 shareId 并返回经过身份验证的用户拥有的共享链接。

revoke_share_link

需要 shareId 并撤销经过身份验证的用户拥有的共享链接。

对于上传，请遵循以下顺序：

create_upload → 获取 uploadId 和临时 PUT URL。
PUT → 把原始文件直接发送到返回的 URL。
complete_upload → 校验已经存储的文件。
create_share_link → 获取最终分享链接。