面向 AI 智能体的 VlogMe MCP 服务器

位于 https://vlogme.ai/mcp 的 MCP 服务器让 AI 智能体完成与 VlogMe 应用相同的工作，使用您的账户、您的积分余额和您的 Lab：

• 从想法到成片。 Director 规划场景、撰写台词，准备画面、配音和音乐，并渲染带字幕的视频。
• 单个片段和图片。 文生视频和图生视频模型、会说话的照片、数字人、口型同步、画质提升和图片生成；目录列出每个模型的限制和价格。
• 配音与声音。 旁白、变声、音乐、音效、转写和字幕；配音翻译成其他语言。
• 用 Aisma 剪辑您自己的素材，以及根据您选择的文章制作 新闻视频。
• 您的文件。 上传本地文件、通过公开链接导入、列出和重命名 Lab 文件，并获取结果的下载链接。

每个结果都会保存到 Lab，您可以在应用中打开。共有 59 个工具；REST API 参考 列出了每个工具及其所需的密钥权限。

只有您启动的任务（渲染和其他生成）会消耗积分。

不收费：连接、工具列表、任务目录、报价、查看您的文件和任务，以及 Director 的规划、对话和免费准备。规划和准备与您账户在应用中的免费额度共享；额度暂时用完时，智能体收到的应答中会有 limited: true。

消耗积分：渲染，与应用中相同。智能体支付的积分与您在网站上支付的完全一样，并从同一余额中扣除：

1. 智能体获取报价。不收取任何费用。
2. 它向您展示积分数并等待您同意。
3. 它按该报价启动任务。任务不会以其他价格运行：如果价格或输入发生变化，启动会被拒绝，且不收取任何费用。

失败的任务不收费。积分在网站的 Account 中购买；密钥无法购买积分。余额不足时，智能体会收到说明原因的拒绝结果，并附带充值页面的链接。积分包和套餐见价格。

登录即可，无需复制密钥。 支持 MCP 登录的客户端（Claude Code、claude.ai 和 ChatGPT 连接器、Cursor、VS Code）只需填写地址 https://vlogme.ai/mcp。客户端会在浏览器中打开 VlogMe：您登录、选择允许智能体做的事，然后点击 Allow。该应用随后会出现在 Account → API & MCP → Connected apps 中，您可以随时断开连接。

也可以使用 API 密钥（适用于脚本、n8n 和不支持登录的客户端）：

1. 在 Account → API & MCP 中创建密钥（账户后台目前仅提供英文界面）。密钥只显示一次，请立即复制：它以 vma_ 开头。
2. 将它保存在环境变量中，以免写进您共享的文件：

export VLOGME_API_KEY="vma_…"

3. 用以下值将服务器添加到客户端：

下面是每个客户端的具体步骤。若要让客户端把全部 59 个工具作为独立条目加载，请在 URL 后加上 ?tools=all：https://vlogme.ai/mcp?tools=all。

任务目录（https://vlogme.ai/api/catalog）和 OpenAPI 描述（https://vlogme.ai/api/openapi.json）无需密钥，任何人都可以读取，因此智能体在连接之前就能规划工作。

使用登录： 运行 claude mcp add --transport http vlogme https://vlogme.ai/mcp，然后在 Claude Code 中输入 /mcp，选择 vlogme 并选择 Authenticate。浏览器会打开 VlogMe，点击 Allow 即可。

使用密钥： 在已设置 VLOGME_API_KEY 的终端中运行一次：

claude mcp add --transport http vlogme https://vlogme.ai/mcp --header "Authorization: Bearer $VLOGME_API_KEY"

用 claude mcp list 检查，然后试着说：“用 VlogMe 做一个 5 秒的片段：池塘上的一只纸船。先报价。”除非您已允许某个工具，否则 Claude Code 会在每次调用工具前询问您。

将服务器添加到 ~/.cursor/mcp.json（或项目中的 .cursor/mcp.json）。Cursor 从环境变量读取密钥：

{
  "mcpServers": {
    "vlogme": {
      "url": "https://vlogme.ai/mcp",
      "headers": { "Authorization": "Bearer ${env:VLOGME_API_KEY}" }
    }
  }
}

在 Cursor Settings → MCP 中可以看到服务器及其工具。如果工具没有出现，请从已设置该变量的终端启动 Cursor。

在工作区中添加 .vscode/mcp.json。VS Code 会在首次使用时询问密钥，并将其保存在安全存储中：

{
  "inputs": [
    { "type": "promptString", "id": "vlogme-key", "description": "VlogMe API key", "password": true }
  ],
  "servers": {
    "vlogme": {
      "type": "http",
      "url": "https://vlogme.ai/mcp",
      "headers": { "Authorization": "Bearer ${input:vlogme-key}" }
    }
  }
}

从该文件或 MCP 视图启动服务器，然后在 Chat 的智能体模式中使用这些工具。

运行一次即可。单引号会在用户设置中保存对 VLOGME_API_KEY 的引用，而不是密钥本身；Gemini CLI 会在启动时读取该变量：

gemini mcp add --scope user --transport http vlogme https://vlogme.ai/mcp --header 'Authorization: Bearer $VLOGME_API_KEY'

或者自己将服务器添加到 ~/.gemini/settings.json：

{
  "mcpServers": {
    "vlogme": {
      "httpUrl": "https://vlogme.ai/mcp",
      "headers": { "Authorization": "Bearer $VLOGME_API_KEY" }
    }
  }
}

在 Gemini CLI 中，/mcp 会列出服务器及其工具。

将服务器添加到 ~/.codex/config.toml。Codex 会发送您指定的变量中的密钥：

[mcp_servers.vlogme]
url = "https://vlogme.ai/mcp"
bearer_token_env_var = "VLOGME_API_KEY"
tool_timeout_sec = 120

tool_timeout_sec 让等待任务的工具（每次调用最多 30 秒）有足够的时间应答。

在带有 AI Agent 节点的工作流中添加 MCP Client Tool，并设置：

• Endpoint：https://vlogme.ai/mcp
• Server Transport：HTTP Streamable
• Authentication：Bearer Auth，使用保存了您密钥的凭据

之后智能体就可以获取报价、启动任务并等待任务完成。每次付费启动都需要新的报价及其指纹，因此工作流始终按报价付费。对于每天的视频，请让工作流在启动任务前，将报价的积分与您设定的上限进行比较。

密钥只能做您创建时勾选的事：

• read（每个密钥都有）：目录、报价、您的文件、任务和余额。只需 read 密钥，就能让智能体了解功能并估算价格。
• write：上传和导入文件、在 Director 中规划，并按报价启动付费任务。
• delete、share 和 publish：删除文件和项目、公开分享链接，以及在已连接的社交账号上发布。除非智能体需要，否则请不要勾选。

密钥永远不能购买积分、更改套餐、创建其他密钥或删除账户。密钥有效期为 1 至 365 天；在 Account → API & MCP 中撤销后，所有使用它的客户端都会立即停止。请妥善保管密钥：它以您账户的权限运行（服务条款）。

已连接的应用。 通过登录连接的应用拥有您在 Allow 页面上勾选的权限（同一列表）。其访问会自动续期，在 Account → API & MCP → Connected apps 中断开连接后立即停止。

连接后，试试下面的请求：

• “用 VlogMe 做一个 30 秒的视频，讲解太阳能板如何工作。渲染之前先给我看计划和价格。”
• “把 ./photo.jpg 做成一个缓慢推近的 5 秒片段。先报价。”
• “让我的照片 ./me.png 说出‘欢迎光临我们的店’。哪个模型合适，要多少钱？”
• “VlogMe 能做什么？一个 10 秒的视频要多少钱？”

智能体每次都按相同的步骤进行：读取目录，获取报价，向您展示积分，用该报价和新的幂等键启动任务，等待任务完成，然后给您一个 15 分钟内有效的下载链接。Director 视频在报价之前还会先规划和准备。每个步骤都在 REST API 参考的 MCP 章节中说明。

MCP 服务器免费吗？连接、目录、报价以及 Director 的规划和准备，在与应用相同的使用额度内不收费；您启动的任务（包括渲染）消耗的积分与应用中相同。

智能体会不经询问就花掉我的积分吗？每个付费工具都会要求智能体向您展示报价并等待您同意；除非您已允许，客户端也会在每次调用工具前询问您。任务只会按其报价启动。如果只想让智能体了解功能而不产生任何花费，请给它一个只有 read 权限的密钥。

通过智能体会比网站更贵吗？不会。价格、余额和免费额度都相同。

结果带水印吗？VlogMe 不会在您制作的内容上添加可见水印。

哪些客户端可以使用？任何能通过 Streamable HTTP 发送 Authorization 请求头的 MCP 客户端，包括 Claude Code、Cursor、VS Code、Gemini CLI、Codex 和 n8n。通过 OAuth 登录连接的客户端（例如 claude.ai 和 ChatGPT 连接器）无需密钥：登录后点击 Allow 即可。

智能体会看到多少个工具？最多 59 个。在 URL 后加上 ?tools=all，即可把每个工具作为独立条目加载。不加时，服务器可能只返回较短的核心列表，其余工具可通过 vlogme_find_tools 和 vlogme_call_tool 使用。两个付费工具始终在简短列表中，因此客户端会逐次确认每次调用。删除、分享或发布类工具从不通过 vlogme_call_tool 运行；如需使用，请以 ?tools=all 连接。

我的文件在哪里？在 Lab 中，与您在应用中制作的内容一样。工具应答中的下载链接有效期为 15 分钟；需要时可以再次获取新链接。

请求被拒绝怎么办？工具应答会用通俗的语言说明原因，被拒绝的调用不收取任何费用。短时间内请求过多会以 rate_limited 被拒绝，并告知需要等待的秒数。