2Slides Logo
Cách Dùng Qwen Code Với 2Slides MCP Server (Hướng Dẫn 2026)
2Slides Team
7 min read

Cách Dùng Qwen Code Với 2Slides MCP Server (Hướng Dẫn 2026)

Trả lời nhanh (≤60 từ): Qwen Code CLI của Alibaba có thể tạo file PowerPoint thật qua 2Slides MCP server. Lấy key tại 2slides.com/api, rồi thêm một mục mcpServers vào ~/.qwen/settings.json — command: "npx", args: ["2slides-mcp"], env.API_KEY cho stdio, hoặc httpUrl: "https://2slides.com/api/mcp?apikey=KEY" cho Streamable HTTP. Hoặc chạy qwen mcp add. Sau đó yêu cầu Qwen dựng bộ slide.

Qwen Code là agent lập trình terminal mã nguồn mở của Alibaba (một bản fork của Gemini CLI), được tinh chỉnh cho dòng mô hình Qwen. Nó là một Model Context Protocol (MCP) client gốc, nên kết nối 2Slides MCP server cho phép Qwen Code biến một bản tóm tắt yêu cầu — hoặc một file trong repo của bạn — thành một file .pptx hoàn chỉnh, chỉnh sửa được.

Hướng dẫn này cung cấp các khối ~/.qwen/settings.json chính xác cho cả hai transport (stdio cục bộ và Streamable HTTP từ xa), lối tắt qwen mcp add, và bộ công cụ 2Slides.

Tại sao kết nối Qwen Code với 2Slides?

Qwen Code suy luận trên mã và nội dung nhưng không xuất ra file slide nhị phân. 2Slides MCP server là bộ tạo làm được điều đó:

  • Qwen Code đọc nguồn của bạn, lập kế hoạch bộ slide, và viết câu chữ — mạnh ở cả nội dung tiếng Anh lẫn tiếng Trung.
  • 2Slides MCP server kết xuất PowerPoint thật — Fast PPT dựa trên theme, hoặc slide thiết kế bằng hình ảnh kèm thuyết minh AI tùy chọn và một gói xuất được.

2Slides hỗ trợ 20 ngôn ngữ đầu ra bao gồm tiếng Trung Giản thể và Phồn thể, nên một bộ slide tiếng Trung do Qwen lập kế hoạch sẽ được kết xuất với ngắt dòng CJK chính xác.

Bạn cần gì trước tiên

  1. Đã cài Qwen Code (qwen có trong PATH).
  2. Một 2Slides API key từ 2slides.com/api.
  3. Node.js cho transport stdio (npx -y 2slides-mcp@latest). Transport HTTP không cần gì cài cục bộ.

Stdio hay Streamable HTTP: chọn transport nào?

Cả hai phơi bày cùng bộ công cụ; khác biệt là khóa cấu hình.

Stdio (cục bộ)Streamable HTTP (từ xa)
Khóa cấu hìnhcommand / args / envhttpUrl
Node.js cục bộBắt buộcKhông bắt buộc
Phù hợp nhất choDev cục bộTừ xa/CI, thiết lập gọn nhẹ

Tên khóa quan trọng: Qwen Code (giống Gemini CLI) dùng httpUrl cho Streamable HTTP và url cho SSE cũ. Dùng httpUrl cho endpoint Streamable HTTP của 2Slides.

Phương pháp 1: stdio trong settings.json

Qwen Code đọc ~/.qwen/settings.json (toàn cục) và .qwen/settings.json (project). Thêm một khối mcpServers:

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

Giá trị env hỗ trợ mở rộng $VAR_NAME nếu bạn muốn giữ key trong môi trường shell của mình.

Phương pháp 2: Streamable HTTP trong settings.json

Với endpoint được host, dùng httpUrl:

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

Xác thực bằng header tùy chọn: "headers": { "Authorization": "Bearer YOUR_2SLIDES_API_KEY" }.

Hoặc dùng lệnh 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"

Các lệnh liên quan: qwen mcp list, qwen mcp remove <name>, và qwen mcp không kèm tham số để mở một giao diện quản lý tương tác.

Kiểm tra kết nối

Bên trong một phiên qwen tương tác:

/mcp

Nó hiển thị trạng thái kết nối, chi tiết cấu hình, và các công cụ được phát hiện theo từng server. Dùng /mcp auth cho các server được bảo vệ bằng OAuth.

Tạo bộ slide đầu tiên của bạn

Chỉ cần yêu cầu — bằng tiếng Anh hoặc tiếng Trung:

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

Qwen Code chạy themes_search → slides_generate (Fast PPT) với responseLanguage: "Simplified Chinese" → trả về downloadUrl. Với slide tùy biến thiết kế bằng hình ảnh, nó dùng slides_create_pdf_slides và thăm dò jobs_get cho đến khi sẵn sàng.

Bộ công cụ của 2Slides MCP

Công cụChức năngCredit
themes_searchTìm một themeId cho Fast PPTMiễn phí
slides_generatePowerPoint dựa trên theme (Fast PPT), đồng bộ/bất đồng bộ10 / trang
slides_create_pdf_slidesSlide tùy biến thiết kế bằng hình ảnh từ văn bản (Nano Banana)100 / trang (1K/2K), 200 (4K)
slides_create_like_thisSlide khớp phong cách của một ảnh tham chiếu100 / trang (1K/2K), 200 (4K)
slides_generate_narrationThêm thuyết minh giọng AI vào một job Nano Banana210 / trang
slides_download_slides_pages_voicesXuất các trang + âm thanh thành một file ZIPMiễn phí
jobs_getThăm dò một job bất đồng bộ đến khi hoàn tấtMiễn phí

Lỗi thường gặp và xử lý sự cố

  • Dùng url cho Streamable HTTP. Qwen Code coi url là SSE. Dùng httpUrl cho endpoint Streamable HTTP của 2Slides.
  • Server DISCONNECTED trong /mcp. Xác minh API key; với stdio xác nhận Node.js có mặt.
  • Công cụ biến mất sau khi chỉnh. Khởi động lại phiên, hoặc chạy lại qwen mcp add.
  • Kỳ vọng một .pptx từ riêng Qwen. Nó lập kế hoạch bộ slide; 2Slides kết xuất file.
  • Sai ngôn ngữ đầu ra. Đặt ngôn ngữ bộ slide một cách tường minh để nội dung CJK kết xuất đúng (Qwen truyền responseLanguage cho slides_generate).

Câu hỏi thường gặp

Qwen Code có hỗ trợ MCP server không?

Có. Qwen Code là một MCP client (fork từ Gemini CLI). Cấu hình server dưới mcpServers trong ~/.qwen/settings.json, hoặc thêm chúng bằng qwen mcp add. Cả stdio lẫn Streamable HTTP đều được hỗ trợ.

Khóa cấu hình cho một server Streamable HTTP là gì?

httpUrl. Chỉ dùng url cho SSE cũ. Endpoint Streamable HTTP của 2Slides đặt trong httpUrl.

Qwen Code có tốt cho bộ slide tiếng Trung không?

Có — các mô hình Qwen bao phủ tiếng Trung rất mạnh, và 2Slides hỗ trợ đầu ra tiếng Trung Giản thể và Phồn thể với kết xuất CJK đúng chuẩn. Sự kết hợp này rất phù hợp cho bộ slide song ngữ và bộ slide kinh doanh tiếng Trung.

Cái này có tạo ra một PowerPoint thật không?

Có — slides_generate trả về một file .pptx chỉnh sửa được. Các công cụ Nano Banana trả về bộ slide thiết kế bằng hình ảnh kèm thuyết minh AI tùy chọn.

Tôi lấy key và cấu hình ở đâu?

Tại 2slides.com/api?tab=mcp: key của bạn, một cấu hình để dán sẵn, và endpoint Streamable HTTP.

Điểm mấu chốt

Một mục mcpServers — command cho cục bộ, httpUrl cho từ xa — biến Qwen Code thành một bộ tạo slide, bằng tiếng Anh hoặc tiếng Trung. Kiểm tra bằng /mcp, rồi chỉ cần yêu cầu.

Để có bức tranh rộng hơn, hãy xem cách MCP đang thay đổi quy trình làm slide và bản đồ hệ sinh thái PowerPoint MCP server. Đang dùng một agent khác? Xem Gemini CLI, Claude Code, và OpenAI Codex với cùng server này.

Lấy key và cấu hình của bạn tại 2slides.com/api?tab=mcp và tạo bộ slide đầu tiên do Qwen dựng ngay hôm nay.

Nguồn:

About 2Slides

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

Try For Free