2Slides Logo
如何在 Qwen Code 中使用 2Slides MCP 服务器(2026 指南)
2Slides Team
3 min read

如何在 Qwen Code 中使用 2Slides MCP 服务器(2026 指南)

快速答案(≤60 字): 阿里巴巴的 Qwen Code CLI 可以通过 2Slides MCP 服务器生成真正的 PowerPoint 文件。先到 2slides.com/api 取得密钥,然后往 ~/.qwen/settings.json 加一条 mcpServers 条目——stdio 用 command: "npx"、args: ["2slides-mcp"]、env.API_KEY,Streamable HTTP 用 httpUrl: "https://2slides.com/api/mcp?apikey=KEY"。也可以运行 qwen mcp add。然后让 Qwen 做一份演示文稿即可。

Qwen Code 是阿里巴巴开源的终端编码代理(基于 Gemini CLI 的分叉),针对 Qwen 模型家族做了调优。它是一个原生的 Model Context Protocol(MCP)客户端,因此连接 2Slides MCP 服务器后,Qwen Code 就能把一份简报——或你仓库里的一个文件——变成一份成品、可编辑的 .pptx。

本指南给出两种传输方式(本地 stdio 和远程 Streamable HTTP)的具体 ~/.qwen/settings.json 配置块、qwen mcp add 快捷方式,以及 2Slides 的工具列表。

为什么要把 Qwen Code 连接到 2Slides?

Qwen Code 擅长对代码和内容进行推理,但产不出二进制的幻灯片文件。2Slides MCP 服务器正是那个能做这件事的生成器:

  • Qwen Code 读取你的源材料,规划演示文稿,撰写文案——中英文内容都很在行。
  • 2Slides MCP 服务器 渲染出真正的 PowerPoint——基于主题的 Fast PPT,或图片设计型幻灯片,可选 AI 配音和可导出的素材包。

2Slides 支持包括简体中文和繁体中文在内的 20 种输出语言,因此一份由 Qwen 规划的中文演示文稿能以正确的中日韩(CJK)断行渲染出来。

你需要先准备什么

  1. 已安装的 Qwen Code(qwen 在你的 PATH 中)。
  2. 一个来自 2slides.com/api 的 2Slides API 密钥。
  3. Node.js,用于 stdio 传输(npx -y 2slides-mcp@latest)。HTTP 传输无需任何本地依赖。

Stdio 还是 Streamable HTTP:该选哪种传输?

两者暴露相同的工具;差别在于配置键。

Stdio(本地)Streamable HTTP(远程)
配置键command / args / envhttpUrl
本地 Node.js需要不需要
适用场景本地开发远程/CI、轻量配置

键名很重要: Qwen Code(与 Gemini CLI 一样)用 httpUrl 表示 Streamable HTTP,用 url 表示旧版 SSE。2Slides 的 Streamable HTTP 端点请用 httpUrl。

方法一:在 settings.json 中配置 stdio

Qwen Code 读取 ~/.qwen/settings.json(全局)和 .qwen/settings.json(项目)。加入一个 mcpServers 块:

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

如果你更愿意把密钥放在 shell 环境里,env 的值支持 $VAR_NAME 展开。

方法二:在 settings.json 中配置 Streamable HTTP

对于托管端点,使用 httpUrl:

{ "mcpServers": { "2slides-remote": { "httpUrl": "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY" } } }

可选的请求头认证:"headers": { "Authorization": "Bearer YOUR_2SLIDES_API_KEY" }。

或使用 qwen mcp add 命令

# stdio qwen mcp add -e API_KEY=YOUR_2SLIDES_API_KEY 2slides npx -y 2slides-mcp@latest # Streamable HTTP qwen mcp add --transport http 2slides-remote "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"

相关命令:qwen mcp list、qwen mcp remove <name>,以及不带参数的 qwen mcp(进入交互式管理界面)。

验证连接

在交互式 qwen 会话中:

/mcp

它会按服务器显示连接状态、配置详情和已发现的工具。对受 OAuth 保护的服务器使用 /mcp auth。

生成你的第一份演示文稿

直接提要求——中文或英文都行:

读取 ./季度总结.md,生成一个 10 页的季度业务回顾。 先从 2slides 搜索一个简洁的商务主题,再生成 PowerPoint, 最后把下载链接给我。

Qwen Code 会运行 themes_search → slides_generate(Fast PPT,带 responseLanguage: "Simplified Chinese")→ 返回 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。 Qwen Code 把 url 当作 SSE。2Slides 的 Streamable HTTP 端点请用 httpUrl。
  • 服务器在 /mcp 中显示 DISCONNECTED。 核对 API 密钥;对 stdio 还要确认 Node.js 在场。
  • 编辑后工具不见了。 重启会话,或重新运行 qwen mcp add。
  • 指望 Qwen 单独产出 .pptx。 它负责规划演示文稿;2Slides 才渲染文件。
  • 输出语言不对。 明确设置演示文稿语言,才能让 CJK 内容正确渲染(Qwen 会把 responseLanguage 传给 slides_generate)。

常见问题

Qwen Code 支持 MCP 服务器吗?

支持。Qwen Code 是一个 MCP 客户端(基于 Gemini CLI 分叉)。在 ~/.qwen/settings.json 的 mcpServers 下配置服务器,或用 qwen mcp add 添加。stdio 和 Streamable HTTP 都受支持。

Streamable HTTP 服务器的配置键是什么?

httpUrl。url 仅用于旧版 SSE。2Slides 的 Streamable HTTP 端点放在 httpUrl 里。

Qwen Code 适合做中文演示文稿吗?

适合——Qwen 模型的中文覆盖能力很强,而 2Slides 支持简体和繁体中文输出,并有恰当的 CJK 渲染。这套组合非常适合中英双语和中文商务演示文稿。

它会产出真正的 PowerPoint 吗?

会——slides_generate 返回一个可编辑的 .pptx。Nano Banana 工具返回图片设计型演示文稿,可选 AI 配音。

密钥和配置在哪里获取?

在 2slides.com/api?tab=mcp:你的密钥、一份可复制粘贴的配置,以及 Streamable HTTP 端点。

要点总结

一条 mcpServers 条目——本地用 command,远程用 httpUrl——就把 Qwen Code 变成一个幻灯片生成器,中文英文都能用。用 /mcp 验证,然后直接开口。

要看更广的全景,参见 MCP 如何改变演示文稿工作流 和 PowerPoint MCP 服务器生态地图。在用别的代理?参见用同一个服务器的 Gemini CLI、Claude Code 和 OpenAI Codex。

到 2slides.com/api?tab=mcp 取得你的密钥和配置,今天就生成你第一份用 Qwen 构建的演示文稿。

来源:

About 2Slides

Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.

Try For Free