在 Claude Code 与 Cursor 中接入 Axiom Lab MCP：一句话把本地 PDF 与照片做成商用视频

为什么开发者需要「能直接交付成片」的视频 MCP，而不是 5 秒无声片段？

在使用 Claude Code、Cursor 或自建 Agent 工作流时，很多开发者尝试过接入各类图像/视频生成 MCP，但很快就会发现一个工程痛点：底层模型 MCP 只会返回一段 4～5 秒的无声画面（B-roll），无法直接作为完整产品视频、项目路演片或人物名片交付给业务方。

Axiom Lab 远程 MCP 服务（https://axiomlab.online/mcp） 与 Claude Skills（/zh/developers/skills） 将整条商业视频生产线封装为标准远程 HTTP MCP 接口：

• 免安装即插即用：直接连接 https://axiomlab.online/mcp，通过请求头 Authorization: Bearer <API Key> 认证，本地无需安装 Python/FFmpeg。
• 强制「先看方案、确认后再制作」的安全机制：AI 助手上传本地文件后，必须先调用方案接口（POST /v1/plans），向你展示工作流、建议时长与画幅，得到你的明确同意后才会启动制作（POST /v1/videos）。
• 自动质检才交付：每支成片均包含完整旁白配音、视觉分镜与逐字同步字幕；未通过自动质检或取消的任务不扣费。

---

一分钟接入：在 Claude Code 与 Cursor 中配置 Axiom Lab MCP

首先前往 https://axiomlab.online/dev（开发者 → 概览 → API 密钥）创建一把密钥，并在终端设置环境变量 AZIMO_API_KEY。

方式一：Claude Code 命令行一键添加

claude mcp add --transport http azimo https://axiomlab.online/mcp \
  --header "Authorization: Bearer $AZIMO_API_KEY"

方式二：Cursor 配置文件（~/.cursor/mcp.json）

{
  "mcpServers": {
    "azimo": {
      "url": "https://axiomlab.online/mcp",
      "headers": {
        "Authorization": "Bearer ${env:AZIMO_API_KEY}"
      }
    }
  }
}

---

接好之后，你可以直接让 AI 助手生成哪几类视频？

配置完成后，直接在 Claude Code 或 Cursor 对话框中指向你本地的 PDF、PPT、Markdown 文档或照片文件夹：

自然语言指令示例	调用的 Axiom Lab 工作流	交付成片规格
“用 ./docs/whitepaper.pdf 和 ./ui-shots/ 帮我做一条 60 秒的项目路演视频，受众是企业 IT 安全评审负责人。”	项目视频（/create/project）	30–180 秒 · 16:9 1080p MP4（痛点、方案、实证、下一步）
“用 ./kettle-spec.pdf 和 ./photos/ 帮我给普利瓦折叠旅行水壶做一条 15 秒科技质感的产品视频。”	产品视频（/create/product）	15–30 秒 · 16:9 TVC（可选电影感大片 / 科技质感 / 生活暖调）
“读取 ./founder/portrait.jpg 和 ./founder/facts.md，生成一支财经网格风格的 9:16 企业家视频名片。”	企业家名片（/create/name_card）	30–90 秒 · 9:16 竖屏人物大片 + 3:4 海报封面

---

开发者友好的三大工程保障：幂等防重、预算保护与 .md 文档镜像

1. 方案级幂等保护（Idempotency）：对同一个 plan_id 重复发起开始制作调用，服务端只会返回同一个视频任务，绝不会因为网络重试或 Agent 循环而重复扣费。
2. 免费材料分析与明确确认边界：材料读取完成后，助手会先把建议秒数汇报给你，按你确认的时长继续生产；遇到可批准的预算暂停，同样需经你同意后才会继续。
3. 原生支持 llms.txt 与 .md 纯文本镜像：你可以随时把 https://axiomlab.online/llms.txt 或单文件全量文档 https://axiomlab.online/zh/llms-full.txt（以及任意文档页后缀加 .md，如 /zh/developers/cli-mcp.md、/zh/developers/api.md）直接喂给 AI 编码助手。