Claude Code

当用户希望在 Claude Code 项目中调用 DeckFlow 时，可以参考本指南。本页面参考了主流连接配置的结构，并使用已确认的 DeckFlow 端点、仅限 API 密钥的身份验证模型、首批支持客户端以及输出临时下载链接的逻辑。相关的 API 密钥传输细节等仍在待确认状态。

前提条件

• 已安装 Claude Code。
• 已安装 Node.js（如果当前 Claude Code MCP 的解析路径有要求）。
• 具备 MCP 访问权限的 DeckFlow 账户。
• 一个 DeckFlow API 密钥。
• 上传或引用 DeckFlow 工作流中所使用源文件的权限。

添加 MCP 服务器

在 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 版本支持直接编辑配置文件，请将 DeckFlow 添加至 ~/.claude.json 中：

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

编辑完配置文件后，请重新启动 Claude Code。

身份验证

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

最终的文档仍需定义 Claude Code 如何向远程 MCP 服务器安全传输 API 密钥。可能的设计包括客户端机密配置、HTTP 请求头配置或 MCP 身份验证提示。

用户可以在 Claude Code 交互界面中运行以下命令查看 MCP 状态：

/mcp

本配置指南目前在等待确认最终的密钥存储方式、API 密钥创建页面 URL 以及环境变量或请求头名称。

验证连接

设置完成后，确认服务器已处于活动状态：

claude mcp list

或者在 Claude Code 内部：

/mcp

用户应当能看到 deckflow 列在已连接的服务器列表中，并显示 connected 状态和可用的工具。

使用方法

提示词示例如下：

使用 DeckFlow 将此研究 PDF 转换为包含 10 页幻灯片的 PPTX 演示文稿，并在生成的文稿就绪时通知我。

Claude Code 会调用适当的 DeckFlow MCP 工具，轮询任务并返回生成的临时下载链接。

推荐给智能体的指令

为了获得更好的效果，请让 Claude Code 在提交文件任务前先检查 DeckFlow 的功能：

在使用 DeckFlow 之前，调用可用的 capability 或 account 工具，以确认支持的输入格式、输出格式、文件限制，以及 Create、Revamp、Translate 和 Tools 是否可用。

作用域

待确认的参数