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

> 无需本地安装依赖，通过远程 MCP 服务（https://axiomlab.online/mcp）与 REST API 将 Axiom Lab 接入 Claude Code 与 Cursor，让 AI 助手自动完成素材上传、方案预审、成片制作与下载。

Canonical URL: https://axiomlab.online/zh/blog/axiom-mcp-server-claude-code-cursor-video-guide
Published: 2026-10-19 | Updated: 2026-10-24 | Author: Axiom Lab

市面上的普通视频 MCP 只能返回一段 5 秒钟的无声画面片段，无法直接交付成片。Axiom Lab 远程 MCP 服务（https://axiomlab.online/mcp）让 Claude Code、Cursor 等 AI 助手直接调用完整的商业视频生产线：先出方案、经你确认后制作、通过自动质检才交付。

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

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

**[Axiom Lab 远程 MCP 服务（`https://axiomlab.online/mcp`）](/zh/developers/cli-mcp)** 与 **[Claude Skills（`/zh/developers/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`](/dev)**（**开发者 → 概览 → API 密钥**）创建一把密钥，并在终端设置环境变量 `AZIMO_API_KEY`。

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

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

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

```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`](/create/project)） | 30–180 秒 · 16:9 1080p MP4（痛点、方案、实证、下一步） |
| *“用 `./kettle-spec.pdf` 和 `./photos/` 帮我给普利瓦折叠旅行水壶做一条 15 秒科技质感的产品视频。”* | **产品视频**（[`/create/product`](/create/product)） | 15–30 秒 · 16:9 TVC（可选电影感大片 / 科技质感 / 生活暖调） |
| *“读取 `./founder/portrait.jpg` 和 `./founder/facts.md`，生成一支财经网格风格的 9:16 企业家视频名片。”* | **企业家名片**（[`/create/name_card`](/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`](/llms.txt) 或单文件全量文档 [`https://axiomlab.online/zh/llms-full.txt`](/zh/llms-full.txt)（以及任意文档页后缀加 `.md`，如 [`/zh/developers/cli-mcp.md`](/zh/developers/cli-mcp.md)、[`/zh/developers/api.md`](/zh/developers/api.md)）直接喂给 AI 编码助手。

## 常见问题解答 (FAQ)

### Axiom Lab 的远程 MCP 服务地址是什么？需要本地安装 Python 或 Node 环境吗？

远程 MCP 地址为 https://axiomlab.online/mcp，采用标准 HTTP 传输协议，无需在本地安装任何依赖包。只需在 https://axiomlab.online/dev 创建一把 API Key，并通过请求头 Authorization: Bearer <API Key> 鉴权即可。

### 如何在 Claude Code 和 Cursor 中一行命令接入 Axiom Lab MCP？

在 Claude Code 中运行：claude mcp add --transport http azimo https://axiomlab.online/mcp --header "Authorization: Bearer $AZIMO_API_KEY"；或在 Cursor 的 ~/.cursor/mcp.json 中配置该 URL 与请求头。接入后即可直接用自然语言让助手读取本地 PDF 或照片生成视频。

### AI 助手调用 MCP 时会自动扣费生成视频吗？

不会。工具协议强制要求「先出方案（Plan），经用户明确同意后才能启动制作（Produce）」。AI 助手必须先把工作流、建议时长和画幅展示给你，得到你的确认指令后才会发起制作调用；对同一个方案重复调用具有幂等保护，只会返回同一条视频。

### 除了 MCP，有面向 LLM 的纯文本 API 文档索引吗？

有。你可以直接把 https://axiomlab.online/llms.txt（索引）或 https://axiomlab.online/zh/llms-full.txt（单文件完整中文开发者文档与 OpenAPI 参考）交给任意 AI 编码助手。