Dify 接入 ChatPPT MCP（HTTP）实操教程

一、教程概述

本教程专为Dify 公有云/自部署版本接入 ChatPPT MCP 服务定制，适配 ChatPPT 官方 streamableHttp 协议模式，接入后Dify智能体可直接调用ChatPPT所有工具。

核心适配说明：ChatPPT MCP 专属协议为 streamableHttp，无需本地部署MCP服务，仅需配置官方远程URL+专属APIKEY即可使用，不支持stdio、传统WebSocket模式。

二、前置准备

ChatPPT 专属 APIKEY：提前申请并获取有效 ChatPPT 授权密钥，密钥失效、错误均会导致接入失败、功能无法调用。

三、ChatPPT MCP 标准配置参数

本次接入使用 ChatPPT 官方标准配置，所有参数固定，仅需替换个人专属APIKEY，完整标准配置如下：

{
  "mcpServers": {
    "chatppt-http": {
      "url": "http://mcp.yoo-ai.com/mcp?key=APIKEY",
      "type": "streamableHttp"
    }
  }
}

参数释义

• 服务标识：chatppt-http（固定名称，建议不修改）
• 请求协议类型：streamableHttp（ChatPPT专属，不可选普通HTTP/SSE）
• 请求URL： http://mcp.yoo-ai.com/mcp?key=APIKEY （固定域名，仅替换末尾APIKEY）

四、分步配置

步骤1：进入Dify MCP工具配置页面

1. 登录Dify后台，进入目标工作区。
2. 点击顶部导航栏【工具（Tools）】，找到【MCP】服务管理模块。
3. 点击【添加 MCP Server（HTTP）】，进入新建配置弹窗。

步骤2：填写 ChatPPT MCP 专属参数

1. Server URL（核心必填）：粘贴官方地址并替换密钥，完整格式：http://mcp.yoo-ai.com/mcp?key=你的ChatPPT专属APIKEY
2. 名称和图标：自定义，便于识别
3. 服务器标识符：chatppt-http
4. 请求头（无需配置）：ChatPPT MCP 仅通过URL参数鉴权，无需额外添加Authorization等请求头

步骤3：保存并校验服务连通性

1. 参数填写无误后，点击【添加并授权】，Dify将自动适配streamableHttp协议拉取ChatPPT工具列表。
2. 接入成功标准：服务状态显示「已连接」，自动加载出PPT生成等ChatPPT专属工具。
3. 接入失败：出现解析失败、无法获取工具列表、密钥报错等问题，参考下文专属排查方案。