DeckFlow Logo 开发者 DeckFlow 文档
开始使用
开发者指南API 参考MCPCLI

MCP 概述

将兼容模型上下文协议 (MCP) 的 AI 智能体（AI Agent）连接到 DeckFlow 演示文稿及文档处理工作流。本概述定义了 MCP 文档规划，并列出了发布前需要进一步确认的产品/API 决策参数。

DeckFlow MCP 旨在赋能 AI 智能体，使其能够在不要求用户手动切换工具的情况下，直接创建、翻新、翻译、转换、提取、合并、拆分或优化演示文稿和办公文档。

本页面参考了 heygen-docs/mcp/ 的结构，并应用了当前已确认的 DeckFlow MCP 端点、仅限 API 密钥的身份验证方式、首批支持客户端列表以及输出临时下载链接的逻辑。目前尚未最终确认的部分标记为 待定 (TBD)。

MCP 端点

https://dev.deckflow.com/mcp/v1/

DeckFlow MCP 仅使用 API 密钥进行身份验证。具体的 API 密钥请求头名称、机密字段、环境变量名称以及密钥创建 URL 仍需在配置页面可投入使用前进行确认。

核心功能

连接成功后，AI 智能体应能够调用以下三大类 DeckFlow 工作流：

产品工作流

能力类型功能描述
创建演示文稿 (Create)通过 PDF、Word、Markdown、网页链接 (URL)、纯文本、研究资料或主题提示词生成 PPTX 演示文稿。输出格式支持 PPTX、PDF、HTML 或图片。
重设计与翻新 (Revamp)在完整保留原始文本、数据和结构的前提下，对现有的 PPTX、Keynote 或 PDF 演示文稿进行视觉层面的重设计。支持应用专业设计模板或品牌 DNA。
语言翻译 (Translate)在完整保留原有排版版式的前提下翻译演示文稿 and 办公文档。支持 PPTX、Keynote、PDF、Word 和 Excel 文件，支持术语表及多国语言控制。

单点工具

工具类别功能描述
文件转换器支持 HTML、Keynote、Markdown、PDF、PowerPoint、Word 及图片等格式转换为便于交付的格式，如 PPTX、PDF、PNG、WebP、HTML 或 MP4。
提取器提取 OCR 文本、PPTX 字体使用情况或 PPTX 文本形状，以便进行审查、迁移和自动化工作流。
合并与拆分器合并 PPTX 演示文稿、按幻灯片拆分 PPTX 文件，或从多个 HTML 文件构建 HTML 播放器包。
优化器在交付前压缩文件和视频、调整图片大小，或将字体嵌入到 PPTX 文件中。

任务管理

由于大多数操作涉及文件上传、渲染、转换或 AI 处理，DeckFlow 工作流采用异步执行模式。因此，MCP 接口应包含一致的任务模型：

能力类型功能描述
提交任务启动创建、翻新、翻译、转换、提取、合并、拆分或优化任务。
查询状态轮询任务状态、进度、警告和失败详情。
获取结果返回生成的文档、预览、元数据和临时下载链接。
取消任务支持时停止已排队或正在运行的任务。

支持的 MCP 客户端

DeckFlow MCP 应适用于以下首批确认的客户端。其他兼容 MCP 的客户端可在支持确认后进行记录。

目前已针对这些智能体/客户端提供了安装配置指南草案：

客户端推荐指南页面
Claude Codeclaude-code.md
Claude 网页端 / 桌面端claude-web.md
Manusmanus.md
OpenAI / ChatGPTopen-ai.md

工作原理

  1. 将 MCP 客户端连接 to DeckFlow MCP 端点。
  2. 使用 API 密钥向 DeckFlow 进行身份验证。
  3. 给智能体分配自然语言任务，并附加或引用所需的源文件。
  4. 智能体选择合适的 DeckFlow MCP 工具并提交任务。
  5. DeckFlow 异步处理该任务。
  6. 智能体检查状态并返回最终文件、预览、元数据或临时下载链接。

远程 MCP 草案

维度远程 MCP
安装配置将 https://dev.deckflow.com/mcp/v1/ 添加到兼容 MCP 的客户端中。
运行环境DeckFlow 托管的基础设施。
身份验证仅限 API 密钥。
计费待定（TBD）：套餐额度、按任务额度、API 计费或包含的使用量。
文件处理待定（TBD）输入文件上传机制。已完成的输出返回临时下载链接。
适用场景确认的发布客户端：Claude Code, Claude Web/Desktop, Manus, 和 OpenAI/ChatGPT。

来源依据

本 MCP 草案基于：

  • deckflow-key-features.md：Create、Revamp 和 Translate 产品工作流。
  • deckflow-tools-summary.md：涵盖文件转换器、提取器、合并与拆分器以及优化器的 23 个浏览器工具。
  • heygen-docs/mcp/：用于概述、安装、支持的客户端、工具和示例的参考结构。

仍需确认的参数

在 MCP 文档达到可实施状态前，必须明确以下决策：

领域缺失的定义
端点生产环境与测试/暂存环境的语义、是否存在区域 URL、版本控制策略以及斜杠策略。
身份验证API 密钥创建 URL、请求头/机密字段名称、令牌有效期、密钥轮换、账户/工作区范围以及重新连接行为。
文件输入上传机制、支持的源 URL 规则、单次任务最大文件数、文件保留策略以及每个 MCP 客户端的附件行为。
任务生命周期状态枚举、进度字段、取消支持、超时行为、重试机制以及结果过期时间。
工具 Schema最终的 MCP 工具名称、必填参数、可选参数、枚举值、默认值和校验规则。
输出交付临时下载 URL 格式、预览格式、元数据、签名 URL 有效期，以及输出是否也持久化存储在 DeckFlow 工作区中。
限制文件大小、页数、幻灯片数、批量限制、速率限制、并发限制和套餐限制。
计费额度扣减模型、免费额度行为、失败任务是否计费以及使用量可视性。

关于完整的清单，请参阅 parameter-checklist.md。

关于需要产品/API 所有者解答的具体问题，请参阅 confirmation-questions.md。