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

MCP 待确认的问题清单

在将 MCP 文档占位符替换为最终参数前，需要向 DeckFlow 产品/API 负责人确认的问题。

在 MCP 开发文档由草案状态转为正式的生产就绪参考手册前，请先答复这些问题。

目前已确认的事项

事项领域已确认的取值
MCP 端点https://dev.deckflow.com/mcp/v1/
身份验证方式仅限 API 密钥
首批支持客户端claude-code, claude-web, manus, open-ai
文件交付方式临时签名下载链接

1. 接口端点与传输协议

  1. https://dev.deckflow.com/mcp/v1/ 是公开的生产端点，还是开发/测试端点？
  2. 是否存在预发（Staging）、区域级或额外的版本化端点？
  3. 示例中是否应始终包含尾部斜杠？
  4. DeckFlow 是否仅支持远程 HTTP MCP，还是也将提供 SSE、stdio 或本地服务器支持？
  5. 规范的 MCP 配置键名应该是 deckflow、DeckFlow 还是其他名称？

2. 身份验证

  1. 用户在何处创建或复制 DeckFlow API 密钥？
  2. 客户端在发送 API 密钥时应该使用哪个 HTTP 请求头、机密字段或环境变量？
  3. 文档中应该使用统一的环境变量（如 DECKFLOW_API_KEY），还是仅使用客户端专用的机密配置项？
  4. API 密钥是个人级别的、工作区级别的、组织级别的还是项目级别的？
  5. 用户如何撤销或轮换 DeckFlow API 密钥？

3. 官方客户端支持

  1. 确认发布文档中是否仅应包含 Claude Code、Claude Web/Desktop、Manus 和 OpenAI/ChatGPT？
  2. 虽然 HeyGen 仅在概述中提及 Cursor，但后续是否需要为 Cursor 提供专用的指南页面？
  3. 是否有任何客户端在调用时需要域名白名单、应用注册或私测（Private Beta）准入资格？
  4. 哪些客户端接入页面在发布前需要附带配置界面截图？

4. 工具命名规范

  1. create_deck、revamp_deck 和 translate_deck 是否为最终确定的工具名称？
  2. 单点工具（Tools）是应该使用分组后的工具（如 convert_file、extract_file_content、compose_files 和 optimize_file），还是每个网页端工具对应一个 MCP 工具？
  3. 最终的任务工具名称是什么：get_task、list_tasks、cancel_task 和 get_task_result，还是其他名称？
  4. get_deckflow_capabilities 是否为首选的能力发现工具名称？
  5. 是否需要提供 get_current_user、list_brand_profiles、list_templates、list_glossaries 和 list_supported_languages 等工具？

5. 文件输入与输出

  1. 智能体应该如何传递文件：MCP 附件、DeckFlow 上传 ID、预签名上传 URL、外部 URL、内联内容，还是混合方式？
  2. 智能体能否从终端客户端直接传递本地文件路径，还是必须先进行上传？
  3. 输入文件在服务器上保留多长时间？
  4. 临时下载链接已确认，但签名的 URL 有效期是多久？
  5. 输出文件是否也会持久保存在 DeckFlow 工作区中，还是仅通过临时链接提供？

6. 任务生命周期

  1. 任务的状态枚举是什么？
  2. 是否每个任务都返回进度百分比、阶段名称、预估剩余时间（ETA），还是仅返回状态？
  3. 哪些任务支持取消？
  4. 是否支持幂等性键以防止重复提交任务？
  5. 规范的错误 Schema 是什么？

7. 产品工作流参数

  1. Create 的最终输入源类型和输出格式是什么？
  2. 对于幻灯片数量、长宽比、语言、品牌 DNA、模板以及复杂元素保留，应该存在哪些 Create 参数？
  3. 对于样式模式、模板、品牌 DNA、内容保留、批量模式以及输出格式，应该存在哪些 Revamp 参数？
  4. 对于目标语言、源语言、术语表、排版保留、同格式输出以及图片文本翻译，应该存在哪些 Translate 参数？
  5. 哪些参数是必填的、选填的，或者由 DeckFlow 提供默认值？

8. 限制与计费

  1. MCP 工作流是否使用与公开的网页端工具相同的文件大小限制？
  2. 单次任务的最大文件数、总批量大小、幻灯片页数、总页数、视频时长以及内联提示词的最大长度是多少？
  3. 速率限制和并发任务限制是多少？
  4. 哪些 DeckFlow 套餐包含 MCP 接入权限？
  5. 针对成功、失败、已取消或部分成功的任务，额度是如何扣减的？

9. 安全与合规

  1. 文档是否也应该声明对 MCP 上传的文件进行 AES-256 加密以及在处理完成后进行删除？
  2. MCP 输入文件是否会用于模型训练？
  3. 是否存在针对 MCP 任务创建和下载的工作区审计日志？
  4. 是否有启用/禁用 MCP 的管理员控制选项？
  5. 是否出于安全原因封禁了某些文件类型或域名？

10. 发布事宜

  1. 哪些占位符现在可以进行替换？
  2. 哪些页面在集成上线前应保持仅限内部可见？
  3. 示例中应该包含真实的屏幕截图，还是先提供纯文本配置说明？
  4. 文档中应当使用 OpenAI、ChatGPT 还是 OpenAI / ChatGPT 作为页面标题？
  5. 谁来签字批准端点、计费和保留期相关的措辞？