Cherry Studio 接入 ChatPPT MCP（HTTP）实操教程

一、教程概述

本文面向国产桌面 AI 客户端 Cherry Studio，适配 ChatPPT 官方 streamableHttp 远程 MCP 协议。

接入后对话可直接调用工具；Cherry Studio 原生完整支持streamableHttp，无需本地部署 MCP 服务，Windows/Mac/Linux 全平台通用。

二、前置准备

1. ChatPPT 专属 APIKEY：提前申请并获取有效 ChatPPT 授权密钥，替换配置中 APIKEY 占位符，密钥错误 / 过期会直接连接失败、无工具列表。
2. MCP 运行依赖：进入 MCP 页面后，若提示uv/bun缺失，点击后方安装按钮完成环境依赖部署。

三、ChatPPT MCP 标准配置参数

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

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

参数释义

• chatppt-http：服务唯一标识，建议不修改
• type: streamableHttp：必填固定值，禁止选 SSE/STDIO，ChatPPT 仅支持流式 HTTP
• url：官方固定域名，鉴权通过 URL 参数key实现，无需额外添加请求头

四、分步配置

步骤1：进入MCP管理面板

1. 打开 Cherry Studio，点击右上角齿轮【设置】
2. 左侧菜单栏找到 MCP 服务器 进入 MCP 管理面板
3. 右上角点击 添加服务器 → 从 JSON 导入

步骤2：JSON 一键导入

1. 清空输入框，粘贴上方完整 JSON，把APIKEY替换为自己的密钥，点击确定导入
2. 返回 MCP 列表，找到chatppt-http，右侧启用开关绿色开启