把 PPTBot 接入你的智能体（MCP）

用 API Key 连接 Cursor、Claude Code、Codex、Gemini CLI、Trae、WorkBuddy 等客户端。智能体可查询文稿、进度、点数与账单，创建文稿，由本地智能体生成大纲后回写，并触发出图与导出。写操作均需二次确认。

第一步：生成 API Key

进入「通用配置」页签，找到「智能体（MCP）」。页内提供与下文相同的各客户端配置片段，可直接复制。

点击「生成 API Key」并复制。密钥形如 pptbot_xxxxxxxx…，泄露时请重新生成（旧 Key 立即失效）。

第二步：接入你的智能体

端点：https://pptbot.eeebit.com/mcp（Streamable HTTP）。点开你使用的客户端，把片段里的 YOUR_PPTBOT_API_KEY 换成你的密钥。各客户端远程 URL 字段名略有差异，已分别标注。

CursorSettings → MCP · ~/.cursor/mcp.json · url

打开 Cursor Settings，搜索 MCP。
选择 New MCP Server，类型选 HTTP / URL；或直接编辑 ~/.cursor/mcp.json。
粘贴下方 JSON；把 YOUR_PPTBOT_API_KEY 换成真实密钥后重启 Cursor。
在聊天里确认工具列表出现「点数余额」「文稿列表」等。

Cursor · mcp.json

{
  "mcpServers": {
    "pptbot": {
      "url": "https://pptbot.eeebit.com/mcp",
      "headers": { "x-api-key": "YOUR_PPTBOT_API_KEY" }
    }
  }
}

Claude CodeCLI · 项目 .mcp.json · type 必填 http

在本机终端执行下面的 claude mcp add（用户级）；只给当前仓库用则加 --scope project。
或把第二段 JSON 存为项目根目录 .mcp.json。type: "http" 不能省——缺 type 会被当 stdio 解析并跳过。
新开一次 Claude Code 会话，输入 /mcp 确认 pptbot 已连接。

Claude Code · CLI

claude mcp add --transport http pptbot "https://pptbot.eeebit.com/mcp" --header "x-api-key: YOUR_PPTBOT_API_KEY"

Claude Code · 项目 .mcp.json

{
  "mcpServers": {
    "pptbot": {
      "type": "http",
      "url": "https://pptbot.eeebit.com/mcp",
      "headers": { "x-api-key": "YOUR_PPTBOT_API_KEY" }
    }
  }
}

Codex~/.codex/config.toml · http_headers · TOML

打开或新建 ~/.codex/config.toml（TOML 格式，表键是 mcp_servers 带下划线）。
粘贴下方服务器块，把 Key 换成设置页生成的密钥。
重启 Codex / 新开会话后再问：「我还剩多少点」。

Codex · config.toml

[mcp_servers.pptbot]
url = "https://pptbot.eeebit.com/mcp"

[mcp_servers.pptbot.http_headers]
x-api-key = "YOUR_PPTBOT_API_KEY"

也可用命令添加：codex mcp add pptbot --url "https://pptbot.eeebit.com/mcp" --header "x-api-key: YOUR_PPTBOT_API_KEY"。2025 年底起 Codex 原生支持 Streamable HTTP，无需 mcp-remote 桥接；老版本连不上先升级。

Gemini CLI~/.gemini/settings.json · 远程字段是 httpUrl

编辑 ~/.gemini/settings.json，合并下方条目。注意 Streamable HTTP 字段是 httpUrl（url 保留给 SSE）。
把 Key 换成真实密钥后重启会话。

Gemini CLI · settings.json

{
  "mcpServers": {
    "pptbot": {
      "httpUrl": "https://pptbot.eeebit.com/mcp",
      "headers": { "x-api-key": "YOUR_PPTBOT_API_KEY" },
      "timeout": 30000
    }
  }
}

也可用命令：gemini mcp add --transport http --header "x-api-key: YOUR_PPTBOT_API_KEY" pptbot https://pptbot.eeebit.com/mcp。

Trae设置 → MCP · 手动添加 · url + headers

Trae 右上角设置 → MCP → 添加 MCP Server → 手动配置。
粘贴下方 JSON；项目级可存为 .trae/mcp.json（需在设置开启项目 MCP）。
保存后若未连接，重启 Trae。

Trae · mcpServers

{
  "mcpServers": {
    "pptbot": {
      "url": "https://pptbot.eeebit.com/mcp",
      "headers": { "x-api-key": "YOUR_PPTBOT_API_KEY" }
    }
  }
}

WorkBuddy专家·技能·连接器 · 自定义连接器 · 需 type: http

打开左侧边栏「专家·技能·连接器」，选择「连接器」。
点击右上角「自定义连接器」，进入 MCP 服务管理后点「配置」（或右上角「配置 MCP」）。
把下方 pptbot 条目合并进已有的 mcpServers 中，保存后等待连接。
首次连接会提示「需要您的信任确认」，点「信任」即完成连接；随后列表显示绿色开关与「13/13 个工具已启用」。
也可用 CLI：codebuddy mcp add-json --scope user pptbot '{…}'。

WorkBuddy · mcp.json

{
  "mcpServers": {
    "pptbot": {
      "type": "http",
      "url": "https://pptbot.eeebit.com/mcp",
      "headers": { "x-api-key": "YOUR_PPTBOT_API_KEY" }
    }
  }
}

连接成功后对话即可用 PPTBot 工具；若显示失败，先确认密钥已替换、再点信任。

Windsurf~/.codeium/windsurf/mcp_config.json · 远程字段是 serverUrl（不是 url）

打开 Windsurf Cascade → Manage MCPs → View Raw Config。
合并下方片段；注意远程 URL 字段是 serverUrl——抄成 url 会显示连接成功但 0 个工具。
保存后点 Refresh（🔄）。

Windsurf · mcp_config.json

{
  "mcpServers": {
    "pptbot": {
      "serverUrl": "https://pptbot.eeebit.com/mcp",
      "headers": { "x-api-key": "YOUR_PPTBOT_API_KEY" }
    }
  }
}

VS Code Copilot.vscode/mcp.json · 顶层键是 servers

命令面板执行「MCP: Open User Configuration」或新建工作区 .vscode/mcp.json。
注意 VS Code 的顶层键是 servers 而非 mcpServers。
保存后在 Agent 模式使用工具。

VS Code · mcp.json

{
  "servers": {
    "pptbot": {
      "type": "http",
      "url": "https://pptbot.eeebit.com/mcp",
      "headers": { "x-api-key": "YOUR_PPTBOT_API_KEY" }
    }
  }
}

官方不建议把密钥写死在文件里；VS Code 支持 ${input:…} 变量，可按需改为交互输入。

Claude Desktopstdio · 远程用 mcp-remote 桥接

打开 Claude Desktop → Settings → Developer → Edit Config。
把下方片段并入 claude_desktop_config.json 的 mcpServers。
完全退出并重开 Claude Desktop。

Claude Desktop · mcp-remote

{
  "mcpServers": {
    "pptbot": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://pptbot.eeebit.com/mcp",
        "--header",
        "x-api-key: YOUR_PPTBOT_API_KEY"
      ]
    }
  }
}

mcp-remote 由官方维护，npx 按需运行、无需预装。

第三步：确认连接

重启 / 刷新你的智能体客户端，在 MCP 服务器列表里看到 pptbot 为已连接。

问一句「我还剩多少点」，智能体应调用 get_me 返回余额。

连不上时优先检查：密钥是否已重新生成（旧 Key 吊销即失效）、远程 URL 字段（url / httpUrl / serverUrl）是否按上面用对、Claude Code 条目是否带 type:"http"。

操作示例（直接复制到对话）

先确认智能体已连接 pptbot，再复制下面的示例提问。模板 ID 在工作台卡片名称右侧括号里，单击即可复制；也可用 list_official_templates 按名称检索。未指定时：模板 ppt_election_01_monitor（班长竞选）、8 页、封面+内容+结尾（无目录）、充实、不加小标题/总结、加页码、精准收敛。

可用工具

工具	做什么
get_me	点数余额、赠点到期、导出权限
list_decks / get_deck	文稿列表与详情（含每页标题与口播摘要）
get_generation_progress	出图进度、队列与全站容量
list_bills / list_spends	充值账单与点数消耗明细
get_pricing	公开价目
list_official_templates	按名称/分类检索官方模板 ID
get_outline_contract	获取大纲页 JSON 契约（供智能体本地生成大纲）
create_deck	新建 AI 草稿；可指定模板 ID、页结构、密度、生图方式，未传用缺省
save_outline_pages	把智能体本地生成的大纲整稿回写
start_generation	触发出图（预扣点数，失败自动退回）
export_images	图片包 PPTX / PDF 导出（不扣点）
export_editable	转可编辑 PPTX（第一期仅普通档）

安全与边界

API Key 与账号一一对应，智能体只能看到你自己的数据；工作台可随时重新生成或吊销。
所有写操作两步确认：先返回预估（点数、页数），确认后才执行。
大纲由你的本地智能体生成，PPTBot 不代出大纲。
暂不支持：上传 PDF/图片进稿、PPT 换皮、高精档转可编辑。