如何在 Claude Code 中使用 2Slides MCP 服务器（2026 指南）

快速答案（≤60 字）： Claude Code 连接 2Slides MCP 服务器后即可生成真正的 PowerPoint 文件。先到 2slides.com/api 获取 API 密钥，然后运行

claude mcp add --env API_KEY=xxx --transport stdio 2slides -- npx 2slides-mcp

接入本地 stdio，或运行

claude mcp add --transport http 2slides https://2slides.com/api/mcp?apikey=KEY

接入远程 Streamable HTTP。之后只需让 Claude Code 做一份演示文稿即可。

Claude Code 是 Anthropic 推出的终端编码代理，原生支持 Model Context Protocol（MCP）。这意味着你可以给它一个工具，把文字变成完整的

文件，全程不用离开你的终端。2Slides MCP 服务器正是这样一个工具：一个轻量连接器，把 2Slides 的幻灯片生成、主题、配音和导出 API 暴露成 Claude Code 可以直接调用的 MCP 工具。

本指南将展示两种连接方式——本地 stdio 和远程 Streamable HTTP——告诉你该选哪一种、每个工具的作用，以及把一句话请求变成可下载 PowerPoint 的具体提示词。

为什么要把 Claude Code 连接到 2Slides？

Claude Code 擅长理解你的代码仓库、起草内容、组织论点。它自己做不到的是产出一个真正可编辑、带图形、图表、主题和演讲者备注的

。这是文件生成问题，应该交给专门的工具来做。

分工很清晰：

• Claude Code 读取你的源材料（README、规格文档、CSV、调研笔记），进行推理，决定每一页放什么内容。
• 2Slides MCP 服务器 接过这个方案，渲染出真正的 PowerPoint 文件——或者是带 AI 语音配音、可导出 MP4 的图片型幻灯片。

整个过程你都待在终端里。提问、等约 30–60 秒、拿到下载链接。

你需要先准备什么

1. 已安装并完成认证的 Claude Code（
   claude
   在你的 PATH 中）。
2. 一个 2Slides API 密钥。 到 2slides.com/api 创建一个。同一页面上还有可复制粘贴的 MCP 配置和 Streamable HTTP 端点。
3. Node.js（用于 stdio 传输，它会在本地运行
   npx 2slides-mcp
   ）。HTTP 传输则完全不需要本地依赖。

Stdio 还是 Streamable HTTP：该选哪种传输？

2Slides MCP 服务器支持两种传输方式。两者暴露完全相同的工具集，差别只在于连接器在哪里运行。

经验法则： 日常工作在自己机器上用 stdio；当 Claude Code 运行在你无法安装 Node 的地方（远程主机、CI 任务、受限容器）时用 Streamable HTTP。

方法一：通过 stdio 连接（本地）

运行一次即可。

分隔符把 Claude Code 自身的参数与它要启动的命令分开：

claude mcp add --env API_KEY=YOUR_2SLIDES_API_KEY --transport stdio 2slides -- npx 2slides-mcp

有几点值得了解：

• 把
  --transport stdio
  （或其他参数）放在
  --env
  和服务器名称之间。因为
  --env
  接受多个
  KEY=value
  对，把名称紧跟在它后面可能会让 CLI 把名称当成又一个环境变量来读。
• --
  之后的一切都会原样传给服务器（
  npx 2slides-mcp
  ）。
• 加上
  --scope user
  可以让 2Slides 在每个项目中都可用，或加上
  --scope project
  把它写入团队共享的
  .mcp.json
  。

生成的

（项目作用域）如下所示——你也可以手动编辑：

{
  "mcpServers": {
    "2slides": {
      "command": "npx",
      "args": ["2slides-mcp"],
      "env": { "API_KEY": "YOUR_2SLIDES_API_KEY" }
    }
  }
}

方法二：通过 Streamable HTTP 连接（远程）

无需本地安装——只要让 Claude Code 指向托管端点：

claude mcp add --transport http 2slides https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY

希望把密钥从 URL 里拿出来？改用请求头传递：

claude mcp add --transport http 2slides https://2slides.com/api/mcp \
  --header "Authorization: Bearer YOUR_2SLIDES_API_KEY"

验证连接

claude mcp list          # 2slides 应出现并成功连接
claude mcp get 2slides   # 显示它的配置和已发现的工具

或者在交互式会话中运行

斜杠命令，查看已连接的服务器、工具数量，以及（对远程服务器而言）认证状态。

生成你的第一份演示文稿

连接好之后，你不用手动调用工具——直接提要求即可。Claude Code 会自动串联 2Slides 工具：

Search the 2slides themes for a clean "business" style, then
generate a 7-slide deck introducing our Q3 roadmap. Pull the
content from ./ROADMAP.md. Return the download link.

在幕后，Claude Code 会运行

找到一个 ，然后运行 （Fast PPT），把 交给你。整个过程大约 30–60 秒就能得到一份带主题的 PowerPoint。

想要自定义、图片设计型的幻灯片而非模板？提出要求，Claude Code 就会走 Nano Banana 路径（

），轮询 直到完成，再返回链接。

2Slides MCP 工具列表

连接后，Claude Code 能看到这些工具：

三种典型的工具链：

• Fast PPT：
  themes_search
  →
  slides_generate
  （同步）→ 下载。
• Nano Banana：
  slides_create_pdf_slides
  （异步）→
  jobs_get
  → 下载。
• 带配音的视频素材： 创建幻灯片 →
  jobs_get
  →
  slides_generate_narration
  →
  jobs_get
  →
  slides_download_pages_voices
  。

常见错误与排错

• 服务器没出现在
  claude mcp list
  中。 对 stdio，检查
  --env
  /名称的顺序是否正确（在
  --env
  和名称之间保留一个参数）。对 HTTP，重新核对 URL 以及 API 密钥是否有效。
• 缺少
  API_KEY
  。 stdio 服务器需要环境变量；HTTP 服务器需要
  ?apikey=
  或
  Authorization
  请求头。别把两者搞混。
• 没连工具就想要
  .pptx
  。 没连接 2Slides 时，Claude Code 能写出大纲但产不出真正的 PowerPoint。先连接服务器。
• 忘了指定主题。 如果你不运行
  themes_search
  也不点名风格，Fast PPT 会替你挑一个。明确指定才能掌控外观。
• 轮询太频繁。 异步任务（Nano Banana、配音）应该用
  jobs_get
  大约每 20 秒轮询一次，而不是塞在紧凑的循环里。

常见问题

Claude Code 原生支持 MCP 服务器吗？

支持。Claude Code 是一流的 MCP 客户端。你用

添加服务器（支持 stdio、SSE 或 HTTP 传输），用 列出它们，并在会话中用 查看。2Slides 服务器与这些都兼容。

Stdio 还是 Streamable HTTP——我该用哪个？

在本地机器上用 stdio（它会替你运行

），在任何你不能或不想安装 Node 的地方用 Streamable HTTP——CI、容器、远程服务器。两者暴露相同的工具，产出完全一致的结果。

这真的会生成一个真正的 PowerPoint 文件吗？

会。Fast PPT 路径（

）返回一个带真实图形和主题、可编辑的 。Nano Banana 路径返回图片设计型演示文稿，还能添加 AI 语音配音和可导出的素材。这些都是你可以打开、编辑、演示的文件——不是截图。

API 密钥和配置在哪里获取？

在 2slides.com/api?tab=mcp。该页面会显示你的密钥、一份可直接粘贴的 stdio 配置，以及 Streamable HTTP 端点 URL。

我能把 2Slides 服务器分享给团队吗？

可以。用

添加，会写出一份你提交到仓库的共享 。队友首次使用时会被提示批准。想要私有、覆盖所有项目的设置，则用 。

要点总结

Claude Code 负责思考，2Slides MCP 服务器负责出文件。连接一次——本地用 stdio，远程用 Streamable HTTP——「给我做一份演示文稿」就变成你终端里的一句话。

如果你常驻 Claude Code，这就是从一个想法（或你仓库里的一个文件）到一份成品、可编辑 PowerPoint 的最快路径。想更全面地了解如何把幻灯片接入代理，参见 MCP 如何改变演示文稿工作流 和完整的 PowerPoint MCP 服务器生态地图。在用桌面应用而非 CLI？参见 如何用 Claude MCP 生成演示文稿。

到 2slides.com/api?tab=mcp 取得你的密钥和配置，不到一分钟就能在终端里生成你的第一份演示文稿。

来源：

• Claude Code — Connect to tools via MCP（官方文档）
• 2Slides API & MCP server