2Slides Team
4 min read
如何在 Gemini CLI 中使用 2Slides MCP 服务器（2026 指南）
快速答案（≤60 字）： Google 的 Gemini CLI 可以通过 2Slides MCP 服务器生成真正的 PowerPoint 文件。先到 2slides.com/api 取得密钥，然后往
~/.gemini/settings.json加一条mcpServers条目——stdio 用command: "npx"、args: ["2slides-mcp"]、env.API_KEY，Streamable HTTP 用httpUrl: "https://2slides.com/api/mcp?apikey=KEY"。也可以运行gemini mcp add。然后让 Gemini 做一份演示文稿即可。
Gemini CLI 是 Google 开源的终端 AI 代理，原生支持 Model Context Protocol（MCP）。把它连接到 2Slides MCP 服务器，Gemini 就能把一个提示词——或你工作目录里的一个文件——变成一份成品、可编辑的 .pptx。
本指南给出两种传输方式（本地 stdio 和远程 Streamable HTTP）的具体 settings.json 配置块、gemini mcp add 快捷方式，以及每个 2Slides 工具的作用。
为什么要把 Gemini CLI 连接到 2Slides？
Gemini 是一个强大的多模态推理器，但它自己产不出二进制的 .pptx 文件。2Slides MCP 服务器正是那个专门的生成器：
- Gemini CLI 读取你的源材料，规划幻灯片，撰写文案。
- 2Slides MCP 服务器 渲染出真正的 PowerPoint——基于主题的 Fast PPT，或图片设计型幻灯片，可选 AI 配音和可导出的素材包。
你需要先准备什么
- 已安装的 Gemini CLI（
gemini在你的 PATH 中）。 - 一个来自 2slides.com/api 的 2Slides API 密钥。
- Node.js，用于 stdio 传输（
npx -y 2slides-mcp@latest）。HTTP 传输无需任何本地依赖。
Stdio 还是 Streamable HTTP：该选哪种传输？
两者暴露相同的工具；差别在于配置键和连接器在哪里运行。
| Stdio（本地） | Streamable HTTP（远程） | |
|---|---|---|
| 配置键 | command / args / env | httpUrl |
| 本地 Node.js | 需要 | 不需要 |
| 适用场景 | 本地开发 | 远程/CI、轻量配置 |
键名很重要： Gemini CLI 用
httpUrl表示 Streamable HTTP，用url表示旧版 SSE。对于 2Slides 的 Streamable HTTP 端点，请用httpUrl。
方法一：在 settings.json 中配置 stdio
Gemini CLI 读取 ~/.gemini/settings.json（全局）和 .gemini/settings.json（项目）。加入一个 mcpServers 块：
{
"mcpServers": {
"2slides": {
"command": "npx",
"args": ["-y", "2slides-mcp@latest"],
"env": { "API_KEY": "YOUR_2SLIDES_API_KEY" }
}
}
}如果你不想把密钥内联进去，env 的值也可以引用 shell 变量（例如 "API_KEY": "$TWOSLIDES_API_KEY"）。
方法二：在 settings.json 中配置 Streamable HTTP
对于托管端点，使用 httpUrl：
{
"mcpServers": {
"2slides-remote": {
"httpUrl": "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"
}
}
}更喜欢请求头认证？加一个 headers 对象："headers": { "Authorization": "Bearer YOUR_2SLIDES_API_KEY" }。
或使用 gemini mcp add 命令
# stdio (-e sets env vars)
gemini mcp add -e API_KEY=YOUR_2SLIDES_API_KEY 2slides npx -y 2slides-mcp@latest
# Streamable HTTP
gemini mcp add --transport http 2slides-remote "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"这些命令会把相同的 mcpServers 条目写入 settings.json。可用标志包括 -t, --transport（stdio | sse | http）、-e, --env、-H, --header 和 --timeout。
验证连接
在交互式 gemini 会话中，运行：
/mcp它会显示每个服务器的状态（CONNECTED / CONNECTING / DISCONNECTED）以及已发现的工具。如果某个远程服务器需要 OAuth，使用 /mcp auth。
生成你的第一份演示文稿
直接提要求：
Read ./notes/market-update.md and generate a 9-slide briefing.
Find a professional theme from 2slides, build the PowerPoint,
and give me the download link.Gemini CLI 会运行 themes_search → slides_generate（Fast PPT）→ 返回 downloadUrl。对于自定义的图片设计型幻灯片，它会使用 slides_create_pdf_slides，并轮询 jobs_get 直到演示文稿就绪。
2Slides MCP 工具列表
| 工具 | 作用 | 积分 |
|---|---|---|
themes_search | 为 Fast PPT 查找 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 | 轮询异步任务直到完成 | 免费 |
常见错误与排错
- 给 Streamable HTTP 端点用了
url。 Gemini CLI 把url当作 SSE。2Slides 的 Streamable HTTP 请用httpUrl。 - 服务器在
/mcp中显示 DISCONNECTED。 检查 API 密钥，对 stdio 还要确认已安装 Node.js。 - 没有列出任何工具。 编辑
settings.json后重启会话，或重新运行gemini mcp add。 - 没连工具就别想要
.pptx。 Gemini 单独只起草大纲；2Slides 才产出文件。 - 轮询太紧凑。 对异步的 Nano Banana / 配音任务，让 Gemini 大约每 20 秒轮询一次
jobs_get。
常见问题
Gemini CLI 支持 MCP 服务器吗？
支持。Gemini CLI 是一个 MCP 客户端。在 ~/.gemini/settings.json 的 mcpServers 下配置服务器，或用 gemini mcp add 添加。stdio、SSE 和 Streamable HTTP 传输全都受支持。
Streamable HTTP 服务器的配置键是什么？
httpUrl。url 仅用于旧版 SSE 服务器。2Slides 的 Streamable HTTP 端点放在 httpUrl 里。
Gemini CLI 把 MCP 配置存在哪里？
~/.gemini/settings.json（全局）或 .gemini/settings.json（项目）。MCP 块是顶层的 mcpServers 键。
它会产出真正的 PowerPoint 吗？
会——slides_generate 返回一个可编辑的 .pptx。Nano Banana 工具返回图片设计型演示文稿，可选 AI 配音。
密钥和配置在哪里获取？
在 2slides.com/api?tab=mcp：你的密钥、一份可复制粘贴的配置，以及 Streamable HTTP 端点 URL。
要点总结
一条
mcpServers条目——本地用command，远程用httpUrl——就把 Gemini CLI 变成一个幻灯片生成器。用/mcp验证，然后直接开口要一份演示文稿。
要看更广的全景，参见 MCP 如何改变演示文稿工作流 和 PowerPoint MCP 服务器生态地图。在用别的终端代理？参见用同一个服务器的 Claude Code、OpenAI Codex 和 Qwen Code。
到 2slides.com/api?tab=mcp 取得你的密钥和配置，不到一分钟就能在 Gemini CLI 里生成你的第一份演示文稿。
来源：
About 2Slides
Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.
Try For Free
