MCP 接入配置

本页面是一个配置草案。它参考了主流配置指南的结构，并使用已确认的 DeckFlow 端点、仅限 API 密钥的身份验证模型、首批支持客户端以及输出临时下载链接的逻辑。

前提条件

• 一个 DeckFlow 账户。
• 获得 DeckFlow MCP 测试或生产集成权限。
• 一个支持远程 HTTP MCP 服务器的兼容 MCP 客户端。
• 一个 DeckFlow API 密钥。
• 上传或引用 Create、Revamp、Translate 以及 Tools 工作流中所使用源文件的权限。

MCP 端点

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

当前文档均统一使用该端点。后续请进一步确认这究竟是最终的生产环境 URL，还是开发测试环境端点。

客户端专有配置指南

针对特定客户端的详细配置流程，请参阅对应页面：

本页面作为通用 MCP 配置的共享概述和备用指南。

身份验证

DeckFlow MCP 仅使用 API 密钥进行身份验证。

最终的配置指南仍需确定以下关于 API 密钥的配置信息：

Claude Code

在终端中运行以下命令（在 Claude Code 交互式会话之外）：

claude mcp add --transport http deckflow https://dev.deckflow.com/mcp/v1/

要在全局所有 Claude Code 项目中安装它：

claude mcp add --transport http -s user deckflow https://dev.deckflow.com/mcp/v1/

添加服务器后，请重启 Claude Code 或运行客户端专用的 MCP 刷新命令（如果可用）。

备选配置

如果目标 Claude Code 版本支持直接编辑配置文件，其 MCP 服务器配置应如下所示：

{
  "mcpServers": {
    "deckflow": {
      "type": "http",
      "url": "https://dev.deckflow.com/mcp/v1/"
    }
  }
}

Claude 网页端 / 桌面端

1. 打开连接器（Connector）或集成设置。
2. 添加一个名为 DeckFlow 的自定义连接器。
3. 将远程 MCP 服务器 URL 设置为：

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

1. 保存连接器。
2. 使用 Claude 支持的机密（secret）或连接器流程配置 DeckFlow API 密钥。
3. 当客户端请求工具权限时，允许 DeckFlow 工具。

其他 MCP 客户端

首批确认的 DeckFlow 客户端列表是 Claude Code, Claude Web/Desktop, Manus, 和 OpenAI/ChatGPT。在产品支持确认后，可以按照以下通用模式记录其他兼容 MCP 的客户端。

对于接受 JSON 格式 MCP 服务器定义的客户端，使用相同的远程 HTTP 结构：

{
  "mcpServers": {
    "deckflow": {
      "type": "http",
      "url": "https://dev.deckflow.com/mcp/v1/"
    }
  }
}

如果客户端使用不同的字段名称，请将最终端点映射到其远程 MCP URL 字段中。

验证连接

使用 MCP 客户端的服务器列表或工具发现命令来确认：

• deckflow 服务器出现在已连接服务器列表中。
• DeckFlow 工具可见。
• 客户端可以访问有效的 DeckFlow API 密钥。
• 简单的账户或能力检查成功（如果 DeckFlow 提供了的话）。

建议的验证工具（如果实现）：

get_current_user

或：

get_deckflow_capabilities

在定义最终的工具 Schema 之前，这两个名称均为占位符。

首选 Prompt

安装配置完成后，使用低风险任务进行测试：

使用 DeckFlow 列出可用的 MCP 功能，并告诉我 Create、Revamp、Translate 和文件转换分别支持哪些文件格式。

接着测试文件处理工作流：

使用 DeckFlow 将此 PowerPoint 演示文稿转换为 PDF 并返回临时下载链接。

客户端权限说明

MCP 客户端在每次调用工具之前可能会要求权限。为了获得更顺畅的体验，用户通常可以允许 DeckFlow 工具在当前对话、项目或工作区中始终运行。

最终文档应仔细解释权限范围，因为 DeckFlow 工具可以上传文件、创建派生文件并返回可下载的输出。

待确定的配置参数

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

关于直接的产品/API 问题，请参阅 confirmation-questions.md。