demovela

Demovela MCP

来自真实工作流的产品演示和营销视频。

Demovela 帮助创始人和产品营销人员展示产品的实际运作方式。从受支持的产品 URL 开始：视频 Agent 会探索工作流、采集真实的桌面和移动端画面，并制作演示视频和营销剪辑。查看输出库，并在聊天中指示下一步编辑，同时保留原始录制内容，供后续版本使用。

网站 · MCP 仓库 · Agent 技能 · npm 软件包

此连接器的功能

此软件包将本地 stdio MCP 客户端连接到托管的 Demovela MCP 服务。托管工具在 Cloudflare 上运行；本地软件包负责桥接连接并打开基于浏览器的 OAuth。你无需部署 Worker，也不必将产品密码粘贴到助手中。

工具	功能
get_profile	读取已登录账户的上下文。
list_templates	浏览可用于需求说明的模板选项。
list_videos	浏览已有的自有输出和已保存草稿。
get_video	读取现有视频或草稿记录。
get_video_status	查看已保存的状态，不会启动渲染。
create_video_draft	将标题、需求说明和选定模板保存为草稿对话，以供审核。

MCP 可浏览已有内容并保存需求说明。它不会录制浏览器会话、渲染视频、生成媒体或消耗额度。草稿并非成品视频。该产品目前的录制预览仅支持有限数量的产品；开始前请先查看预览范围。下载链接可能需要登录产品账户。

示例工作流

1. 浏览已有输出和可用模板。
2. 编写需求说明，包含目标受众、一项实用工作流、吸引点和预期格式。
3. 将所需需求说明保存为草稿，然后打开返回的 Demovela 链接，在工作室中审核并继续操作。

可以向助手提出的问题

找到我最新的产品演示，告诉我其已保存状态以及打开位置。

帮我为新用户撰写一份移动端演示需求说明。请先浏览可用模板，再推荐一个。

将这份已批准的发布视频需求说明保存为草稿。返回审核链接；不要开始录制或渲染。

连接远程 MCP 客户端

1. 打开客户端的自定义 MCP 或连接器设置。
2. 输入 https://mcp.demovela.com/mcp 作为远程服务 URL。
3. 在浏览器中登录 Demovela，并查看授权页面上的权限。
4. 返回客户端并加载可用工具。

请使用支持 Streamable HTTP MCP 和 OAuth 的客户端。自定义连接器是否可用取决于客户端和你的账户。公开仓库或 npm 版本并不代表该集成已获准进入客户端的市场。

Claude Desktop 和其他 stdio 客户端

需要 Node.js 22 或更高版本以及现有的 Demovela 账户。将以下条目添加到客户端的 MCP 配置中：

{
  "mcpServers": {
    "demovela": {
      "command": "npx",
      "args": [
        "-y",
        "demovela-mcp"
      ]
    }
  }
}

你也可以在终端运行 npx -y demovela-mcp 来启动桥接程序。它通过 stdio 使用 MCP 通信，不是交互式聊天界面。对于支持 MCPB 扩展的桌面客户端，请从 Demovela 版本发布页下载 .mcpb 文件。

权限和账户访问

请求的权限范围：profile:read videos:read drafts:write。仅有旧版个人资料权限的连接需要重新连接，并明确批准新增权限，之后才能使用内容工具。

只批准你有意发起的连接。如果登录页面在新标签页中打开，请完成登录，返回授权页面并刷新。管理或撤销已连接的应用。

此软件包使用固定版本的 mcp-remote 处理 OAuth、PKCE 和本地令牌存储。你电脑上的令牌属于凭据。此连接器使用上述固定端点，并拒绝命令行端点覆盖。此软件包不会请求产品密码或底层服务提供方凭据。

重试创建草稿

每次创建新草稿都使用新的 UUID requestId。只有在响应不确定时重试完全相同的请求，才重复使用同一个 ID。更改概要或幻灯片后，就属于新请求。请返回已保存草稿的 ID 和审核链接；不要将已保存的草稿描述为已渲染或已发布的内容。

故障排除

• 没有工具或权限不足： 通过浏览器授权重新连接，并检查所选账户。
• 列表为空： 确认该账户拥有预期的条目。结果为空与请求失败不同。
• 链接要求登录： 使用拥有该内容的产品账户打开链接；产品私有链接不是公开分享链接。
• 浏览器阻止授权： 查看浏览器显示的错误，并从客户端重新发起已过期的请求。切勿在问题报告中发送 Cookie 或令牌。

添加配套技能

Demovela Agent 技能介绍了如何选择合适的记录、解读结果并遵守工作流的限制：

npx skills add demovela/agent-skill

了解更多 Demovela 信息

• AI 产品演示工作区
• 真实产品视频示例
• 当前录制预览范围
• 视频模板
• 产品演示指南
• 视频规划工具

开发与支持

npm ci
npm test
npm run bundle

请通过报告连接器问题，并提供所用客户端、Node.js 版本及已删去敏感信息的错误内容。发布时请确保 package.json、manifest.json、server/config.json、server.json 和锁文件中的版本保持一致。GitHub Actions 会发布带版本号的 npm 软件包和 MCPB 资源。MIT 许可证详见 LICENSE。