2Slides Team
4 min read
用任意 AI 代理对接 2Slides MCP 服务器：2026 完整指南
快速答案（≤60 字）： 2Slides MCP 服务器让任何支持 MCP 的 AI 代理都能生成真正的 PowerPoint 文件。它有两种运行方式：stdio（
npx -y 2slides-mcp@latest配一个API_KEY环境变量）和 Streamable HTTP（https://2slides.com/api/mcp?apikey=KEY）。到 2slides.com/api 取得密钥，把服务器加到你的代理里——Claude Code、Codex、OpenClaw、Gemini CLI、Qwen Code 等等——然后开口要一份演示文稿。
每一个现代 AI 代理都能写出幻灯片大纲。但它们没有一个能凭自己交给你一个真正可编辑、带主题、图表、配音和演讲者备注的 .pptx。这是文件生成的活儿——而 2Slides MCP 服务器 就是那个通用连接器，把这个能力赋予任何 Model Context Protocol 客户端。
把服务器配置写一次，同样的工具就会在你用的任何代理里点亮。本指南讲解两种传输方式、列出受支持的客户端，并为每一个提供分步配置链接。
2Slides MCP 服务器是什么？
它是一个小巧的连接器，把 2Slides 的幻灯片生成 API 暴露成 MCP 工具。代理一旦连上，就能调用：
| 工具 | 作用 | 积分 |
|---|---|---|
themes_search | 为基于主题的演示文稿查找 themeId | 免费 |
slides_generate | 基于主题的 PowerPoint（Fast PPT），同步/异步 | 10 / 页 |
slides_create_pdf_slides | 由文字生成自定义图片设计型幻灯片（Nano Banana） | 100 / 页 (1K/2K), 200 (4K) |
slides_create_like_this | 匹配参考图片风格的幻灯片 | 100 / 页 (1K/2K), 200 (4K) |
slides_generate_narration | 为 Nano Banana 任务添加 AI 语音配音 | 210 / 页 |
slides_download_slides_pages_voices | 把页面 + 音频导出为 ZIP | 免费 |
jobs_get | 轮询异步任务直到完成 | 免费 |
代理负责思考——读取你的文件、组织论点、撰写文案。服务器负责出文件。你用日常语言提问，大约 30–60 秒后下载链接就返回。
两种传输方式：stdio 与 Streamable HTTP
2Slides MCP 服务器两种协议都支持。它们暴露完全相同的工具，差别只在于连接器在哪里运行。
| Stdio 协议 | Streamable HTTP 协议 | |
|---|---|---|
| 运行位置 | 本地，通过 npx -y 2slides-mcp@latest | 远程，由 2Slides 托管 |
| 是否需要本地 Node.js | 需要 | 不需要 |
| 认证 | API_KEY 环境变量 | URL 中的 ?apikey=（或 Authorization 请求头） |
| 端点 / 命令 | npx -y 2slides-mcp@latest | https://2slides.com/api/mcp?apikey=KEY |
| 适用场景 | 本地开发、完全可控、便于离线 | CI、容器、远程主机、瘦客户端 |
通用 stdio 配置（大多数客户端接受的形态）：
{
"mcpServers": {
"2slides": {
"command": "npx",
"args": ["-y", "2slides-mcp@latest"],
"env": { "API_KEY": "YOUR_2SLIDES_API_KEY" }
}
}
}通用 Streamable HTTP： 让你的客户端指向 https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY。（具体键名各有不同——Gemini CLI 和 Qwen Code 用 httpUrl；OpenClaw 用 url + transport: "streamable-http"；Claude Code 和 Codex 用 --transport http 标志或 url 字段。）
到 2slides.com/api?tab=mcp 取得你的密钥、一份可直接粘贴的配置，以及端点。
受支持的代理一览
| 代理 / 客户端 | 配置位置 | Stdio | Streamable HTTP | 配置指南 |
|---|---|---|---|---|
| Claude Code | .mcp.json / claude mcp add | ✅ | ✅（--transport http） | 指南 → |
| OpenAI Codex | ~/.codex/config.toml | ✅ | ✅（url） | 指南 → |
| OpenClaw | ~/.openclaw/openclaw.json（mcp.servers） | ✅ | ✅（transport: streamable-http） | 指南 → |
| Gemini CLI | ~/.gemini/settings.json | ✅ | ✅（httpUrl） | 指南 → |
| Qwen Code | ~/.qwen/settings.json | ✅ | ✅（httpUrl） | 指南 → |
| Claude Desktop | claude_desktop_config.json | ✅ | — | 指南 → |
| Kimi（Moonshot） | 通过 Kimi CLI 或 Claude Code | ✅ | ✅ | 见下文「Kimi 与 MiniMax」 |
| MiniMax | 通过 Mini-Agent 或 Claude Code | ✅ | ✅ | 见下文「Kimi 与 MiniMax」 |
每一份链接的指南都有具体的配置块、（如果存在的话）一行 ... mcp add 快捷方式，以及如何验证连接。
挑选你的代理
- Claude Code —— Anthropic 的 CLI。
claude mcp add 2slides -e API_KEY=xxx -- npx -y 2slides-mcp@latest，远程则用--transport http。可用作用域区分个人与团队使用。 - OpenAI Codex —— 在
config.toml中加一个[mcp_servers.2slides]块，或运行codex mcp add 2slides --env API_KEY=xxx -- npx -y 2slides-mcp@latest。远程通过一个url块。 - OpenClaw —— 在
openclaw.json的mcp.servers下加一条条目；用openclaw mcp probe 2slides --json验证。工具会呈现在coding/messaging配置档中。 - Gemini CLI —— 在
settings.json中配置mcpServers（远程用httpUrl），或用gemini mcp add。 - Qwen Code —— 在
~/.qwen/settings.json中用相同形态；对中文演示文稿很在行。
Kimi 与 MiniMax：两条额外的路径
Kimi（Moonshot）和 MiniMax 本身都不像上面那些代理那样是打磨成熟的 MCP 原生 CLI，但二者都能通过两条可靠的途径接到 2Slides MCP 服务器：
-
用它们的模型驱动一个编码代理。 两者都暴露了与 Anthropic 兼容的端点，所以你可以拿 Claude Code 对接它们，再通过 Claude Code 自己的 MCP 配置接上 2Slides：
# Kimi K2 via Moonshot export ANTHROPIC_BASE_URL="https://api.moonshot.ai/anthropic" export ANTHROPIC_AUTH_TOKEN="YOUR_MOONSHOT_KEY" claude # then: claude mcp add ... 2slides -- npx -y 2slides-mcp@latest # MiniMax export ANTHROPIC_BASE_URL="https://api.minimax.io/anthropic" export ANTHROPIC_AUTH_TOKEN="YOUR_MINIMAX_KEY" claude -
使用它们自己的代理运行时。 Moonshot 推出了 Kimi CLI（一个原生 MCP 客户端，使用标准的
mcpServers/~/.kimi/mcp.json配置），MiniMax 则发布了开源的 Mini-Agent，它读取一个标准的mcp.json。在这两者中，都像上面通用的 stdio 或 Streamable HTTP 块那样添加 2Slides 即可。
无论哪种方式，2Slides 的工具都是一样的——变的只是宿主代理。
一个完整示例（任意代理）
无论用哪个客户端，交互都是一样的。你提要求：
Read ./Q3-report.md and build a 12-slide executive summary.
Find a clean business theme from 2slides, generate the
PowerPoint, then return the download link.代理会运行 themes_search → slides_generate（Fast PPT）→ 返回一个 downloadUrl。想要带 AI 配音的自定义图片设计型幻灯片？提出来，代理就会串联 slides_create_pdf_slides → jobs_get → slides_generate_narration → jobs_get → slides_download_slides_pages_voices。
常见问题
2Slides MCP 服务器是什么？
一个 Model Context Protocol 连接器，把 2Slides 的幻灯片生成、主题、配音和导出 API 暴露成工具。任何连上它的、支持 MCP 的代理都能生成真正可编辑的 PowerPoint 文件（以及带 AI 配音的图片设计型演示文稿）。
Stdio 还是 Streamable HTTP——我该用哪种传输？
在能运行 Node.js（npx -y 2slides-mcp@latest）的机器上用 stdio——这是本地工作的默认选择。当你的代理运行在 CI、容器或一台什么都没装的远程主机上时，用 Streamable HTTP（https://2slides.com/api/mcp?apikey=KEY）。两者暴露完全相同的工具。
哪些 AI 代理能用它？
任何 MCP 客户端。本指南直接覆盖 Claude Code、OpenAI Codex、OpenClaw、Gemini CLI、Qwen Code 和 Claude Desktop，另外通过 Claude Code 或它们各自的代理运行时支持 Kimi 和 MiniMax。Cursor、Windsurf 以及其他 MCP 客户端使用相同的通用配置。
每个代理是否需要不同的 API 密钥？
不需要。一个 2Slides API 密钥适用于每一个客户端和两种传输方式。到 2slides.com/api?tab=mcp 创建一次即可。
它会生成真正的 PowerPoint 文件吗？
会。slides_generate 返回一个带真实图形和主题、可编辑的 .pptx。Nano Banana 工具返回图片设计型演示文稿，还能添加 AI 语音配音以及用于视频的可导出素材包。
这个 MCP 服务器免费吗？
连接器本身免费安装，themes_search / jobs_get / 导出调用都免费。幻灯片生成会消耗 2Slides 积分——Fast PPT 每页 10 积分，图片设计型和带配音的演示文稿更多。
要点总结
把 2Slides MCP 服务器配置一次——本地用 stdio，远程用 Streamable HTTP——你用的每一个 MCP 代理就都获得了一条通往成品 PowerPoint 的一句话路径。代理负责思考，2Slides 负责出文件。
2026 年的转变在于：「给我做一份演示文稿」不再是一个聊天小把戏——它是你的代理代你发起的一次工具调用，返回一个真正的文件。在下面挑一个客户端，你还没读完它的配置指南就能拿到第一份演示文稿：
要了解更多背景，参见 PowerPoint MCP 服务器生态地图 和 如何构建一个 AI 演示文稿代理。
到 2slides.com/api?tab=mcp 取得你的 API 密钥、可复制粘贴的配置，以及 Streamable HTTP 端点——一个服务器，对接每一个代理。
来源：
About 2Slides
Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.
Try For Free
