Cách sử dụng WorkBuddy với 2Slides MCP Server (Hướng dẫn 2026)

Q: Cấu hình WorkBuddy MCP chính xác cho 2Slides là gì?

Mục nhập được khuyến nghị là "2slides": {"command": "npx", "args": ["-y", "2slides-mcp@latest"], "env": {"APIKEY": "YOUR2SLIDESAPIKEY"}} bên trong mcpServers. Cấu hình này yêu cầu Node.js. Lựa chọn thay thế từ xa là "type": "streamableHttp" với "url": "https://2slides.com/api/mcp?apikey=YOUR2SLIDESAPI_KEY".

Trả lời nhanh (≤60 từ): Trong WorkBuddy, mở Plugins → MCP Server → Configure MCP (hoặc Connectors → Custom Connector) và dán một mục mcpServers chạy npx -y 2slides-mcp@latest với env.API_KEY là khóa 2Slides của bạn. Dấu tích xanh hiện lên nghĩa là đã kết nối. Sau đó, bạn có thể yêu cầu WorkBuddy tạo slide (ngay cả từ WeChat), nó sẽ trả về một liên kết tải xuống .pptx.

WorkBuddy là không gian làm việc AI agent trên máy tính của Tencent, được phát triển bởi đội ngũ CodeBuddy. Nó có thể đọc tệp, thực hiện tác vụ trên máy tính, nhận lệnh từ WeChat, WeCom (企业微信), Feishu, DingTalk, QQ và chạy tự động hóa theo lịch trình. Tuy nhiên, nó thiếu một công cụ chuyên dụng để tạo bài thuyết trình. Bằng cách thêm 2Slides MCP server, WorkBuddy có thể biến một bản tóm tắt, báo cáo hoặc tin nhắn chat thành tệp PowerPoint có thể chỉnh sửa. Bạn sẽ nhận lại tệp dưới dạng một liên kết.

Hướng dẫn này bao gồm ba cách thiết lập, được sắp xếp từ cách WorkBuddy hỗ trợ trực tiếp nhất đến ít trực tiếp hơn:

Local stdio MCP server (khuyên dùng, đúng theo cấu trúc cấu hình trong hướng dẫn MCP của WorkBuddy)
Remote Streamable HTTP endpoint (không cần cài đặt Node.js)
2Slides Agent Skill (cài đặt dưới dạng một gói kỹ năng thay vì MCP server)

Tại sao nên kết nối WorkBuddy với 2Slides?

WorkBuddy rất giỏi trong việc lập kế hoạch, đọc tài liệu và làm việc trên nhiều công cụ khác nhau. Việc kết xuất một bộ slide được thiết kế chuyên nghiệp là một công việc riêng biệt. Khi tích hợp 2Slides:

WorkBuddy sẽ viết dàn ý và nội dung slide từ tệp, ghi chú hoặc yêu cầu trò chuyện của bạn.
2Slides sẽ tạo ra bộ slide thực tế: một tệp .pptx dựa trên chủ đề và có thể chỉnh sửa (Fast PPT, từ hơn 1.500 mẫu), hoặc các slide thiết kế dạng hình ảnh với tùy chọn AI voice narration.

Vì WorkBuddy cũng lắng nghe trên các ứng dụng nhắn tin và chạy các tác vụ theo lịch trình, bạn có thể yêu cầu tạo slide từ điện thoại hoặc nhận một bộ slide được tạo tự động hàng tuần mà không cần mở ứng dụng trên máy tính.

Điều kiện cần thiết

WorkBuddy bản desktop đã cài đặt và đăng nhập (workbuddy.cn tại Trung Quốc hoặc workbuddy.ai quốc tế).
Một API key 2Slides lấy từ 2slides.com/api. Khóa có dạng sk-2slides-.... Tài khoản mới nhận được 500 tín dụng miễn phí, tương đương 50 trang Fast PPT với mức 10 tín dụng mỗi trang. Tín dụng được tính theo mô hình billing model (pay-per-use, không đăng ký) và không bao giờ hết hạn.
Node.js trên cùng máy tính (chỉ dành cho Cách 1, lệnh node -v phải hiển thị phiên bản). Cách 2 không cần cài đặt gì trên máy. Cách 3 cần Python 3 với requests.

Những gì đã xác nhận và những gì chưa được tài liệu hóa (tính đến 30/09/2026)

Hạng mục	Trạng thái
Cấu hình MCP qua Plugins → MCP Server → Configure MCP, các tệp `~/.workbuddy/mcp.json` (người dùng) và `<project>/.workbuddy/mcp.json` (dự án)	Đã có trong hướng dẫn MCP của WorkBuddy
Các mục stdio với `command` / `args` / `env`, xanh = đã kết nối, đỏ = lỗi cấu hình	Đã có trong hướng dẫn MCP của WorkBuddy
Các mục Remote với `"type": "streamableHttp"` + `url`	Xuất hiện trong tài liệu connector của Open Platform WorkBuddy và các trang hướng dẫn bên thứ ba, không có trong hướng dẫn MCP cho người dùng cuối
Headers (`Authorization: Bearer ...`) cho các mục remote trong WorkBuddy	Được hiển thị bởi hướng dẫn WorkBuddy của các nhà cung cấp bên thứ ba; không có trong tài liệu gốc của WorkBuddy
Skills: kéo gói kỹ năng cục bộ vào, hoặc dùng 查找技能 / 创建技能 trong chat	Đã có trong hướng dẫn kỹ năng của WorkBuddy
Thiết lập biến môi trường cho một kỹ năng đã nhập	Chưa có tài liệu; xem cách xử lý tạm thời bên dưới
2Slides MCP endpoint, xác thực key-in-URL, gói stdio	Đã được 2Slides kiểm tra thực tế vào ngày 30/09/2026

Cách 1: Local stdio server (Khuyên dùng)

Cách này khớp với cấu trúc ví dụ chính thức trong hướng dẫn MCP của WorkBuddy (command, args, env), vì vậy đây là lựa chọn ổn định nhất.

Bước 1. Mở trình chỉnh sửa MCP. Sử dụng một trong hai đường dẫn:

Thanh bên → 插件 (Plugins) → MCP 服务器 (MCP Server) (góc trên bên phải) → 配置 MCP (Configure MCP)
连接器 (Connectors) → 自定义连接器 (Custom Connector) (góc trên bên phải) → 配置 MCP (Configure MCP)

Hoặc chỉnh sửa trực tiếp ~/.workbuddy/mcp.json cho tất cả dự án, hoặc <project>/.workbuddy/mcp.json cho một dự án cụ thể.

Bước 2. Dán mục này vào (hợp nhất vào mcpServers nếu bạn đã có các server khác):

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

Bước 3. Lưu và kiểm tra trạng thái. Dấu tích xanh ✓ cạnh 2slides nghĩa là WorkBuddy đã khởi động server và tải các công cụ thành công. Dấu X đỏ ✗ nghĩa là cấu hình có vấn đề (xem phần khắc phục lỗi).

Lưu ý:

Biến môi trường phải được đặt tên chính xác là API_KEY. Đó là tên mà gói npm 2slides-mcp sẽ đọc.
Tài liệu Open Platform của WorkBuddy viết các mục stdio với một trường "type": "stdio" bổ sung. Bạn có thể thêm vào, nhưng ví dụ trong hướng dẫn người dùng cuối vẫn hoạt động mà không cần nó.
Server chạy trên máy tính của bạn, vì vậy máy tính phải đang bật và WorkBuddy phải đang mở để xử lý các yêu cầu đến từ WeChat hoặc theo lịch trình.

Cách 2: Remote Streamable HTTP endpoint

2Slides lưu trữ một MCP server tại https://2slides.com/api/mcp. Nó chấp nhận khóa dưới dạng Bearer header hoặc trực tiếp trong URL. Không có OAuth, vì vậy bạn tự truyền khóa của mình.

Hướng dẫn MCP cho người dùng cuối của WorkBuddy chỉ hiển thị ví dụ stdio. Tuy nhiên, tài liệu connector của WorkBuddy Open Platform sử dụng "type": "streamableHttp" cho các server từ xa, và các hướng dẫn WorkBuddy bên thứ ba (ví dụ của Wolters Kluwer) cũng sử dụng giá trị tương tự thông qua Connectors → Custom Connector → Configure MCP. Hãy sử dụng định dạng này:

{
  "mcpServers": {
    "2slides": {
      "type": "streamableHttp",
      "url": "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY",
      "timeout": 60000
    }
  }
}

Nếu bạn muốn giữ khóa không hiển thị trong URL, hãy sử dụng header:

{
  "mcpServers": {
    "2slides": {
      "type": "streamableHttp",
      "url": "https://2slides.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_2SLIDES_API_KEY"
      },
      "timeout": 60000
    }
  }
}

Nếu trạng thái vẫn báo đỏ: WorkBuddy cùng họ với Tencent CodeBuddy, và tài liệu CLI của CodeBuddy viết các server từ xa là "type": "http" với url + headers. Hãy thử đổi "streamableHttp" thành "http". Nếu cả hai đều không hoạt động trong phiên bản của bạn, hãy quay lại Cách 1, vốn sử dụng cấu trúc đã được tài liệu hóa rõ ràng.

Bảo mật: Một URL chứa ?apikey= là một bí mật, giống như chính API key đó. Đừng dán nó vào các cuộc trò chuyện chung hoặc ảnh chụp màn hình, và đừng commit tệp .workbuddy/mcp.json cấp dự án có chứa nó. Nếu bị lộ, hãy xóa khóa và tạo khóa mới tại 2slides.com/api.

Phương thức 3: Cài đặt skill 2Slides

WorkBuddy hỗ trợ các skill dựa trên SKILL.md. Skill 2Slides chính thức (name: 2slides) đóng gói các script Python gọi REST API của 2Slides. Bạn không cần máy chủ MCP cho phương thức này.

Lựa chọn A: Tải lên gói skill.

Trên GitHub, mở 2slides/slides-generation-2slides-skills → Code → Download ZIP.
Trong trang skill của WorkBuddy, chọn 上传技能 (Tải lên Skill) và kéo tệp ZIP vào, hoặc nhấp 选择文件. WorkBuddy sẽ tự hoàn tất việc nhập.

Hãy cài đặt từ tệp ZIP của repo hiện tại, không phải bản đóng gói 2slides.skill cũ hơn bên trong repo.

Lựa chọn B: Yêu cầu trong chat. Nhập nội dung như "查找技能：2Slides presentation generation" (tìm skill), hoặc dán URL repo GitHub và yêu cầu WorkBuddy cài đặt nó như một skill.

Thiết lập khóa. Các script đọc khóa từ biến môi trường SLIDES_2SLIDES_API_KEY, không phải API_KEY. WorkBuddy không có tài liệu về trường biến môi trường riêng cho từng skill. Cách xử lý thực tế là thiết lập nó trong hồ sơ shell của bạn (ví dụ export SLIDES_2SLIDES_API_KEY=YOUR_2SLIDES_API_KEY trong ~/.zshrc trên macOS, hoặc biến môi trường người dùng trên Windows) rồi khởi động lại WorkBuddy. Kiểm tra bằng câu lệnh: "Sử dụng skill 2slides để tìm kiếm một mẫu tối giản." Lệnh này sẽ chạy search_themes.py và không tốn tín dụng.

MCP hay skill? MCP cung cấp cho WorkBuddy các công cụ có cấu trúc và đèn báo trạng thái. Skill thì không cần Node.js và hoạt động tốt nếu bạn đã quen quản lý skill. Hãy chọn một trong hai; bạn không cần cả hai. Để so sánh sâu hơn, hãy xem Agent Skills vs MCP servers cho bài thuyết trình.

Kiểm tra hoạt động

Bắt đầu một tác vụ WorkBuddy mới và yêu cầu:

List the tools you have from the 2slides MCP server, then search
2slides themes for "business" and show me the top 3 theme IDs.

Bạn sẽ thấy themes_search được gọi và một danh sách các ID mẫu hiện ra. Việc tìm kiếm mẫu là miễn phí, nên bước kiểm tra này không tốn phí.

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

Read the Q3 report in my Documents folder and turn it into a
10-slide English deck for management. Search 2slides for a clean
corporate theme first, generate it with Fast PPT, and give me the
download link.

WorkBuddy gọi themes_search, sau đó là slides_generate, và trả về một downloadUrl cho .pptx. Trong thử nghiệm riêng của 2Slides, một bộ Fast PPT 3 trang hoàn thành trong khoảng 22 giây. Mười trang sẽ tốn 100 tín dụng.

Liên kết tải xuống sẽ hết hạn sau 1 giờ. Hãy yêu cầu WorkBuddy lưu tệp vào thư mục cục bộ ngay lập tức ("tải nó về ~/Documents/Decks"), hoặc mở tệp ngay khi có.

Hai quy trình làm việc WorkBuddy đặc biệt hiệu quả

1. Yêu cầu tạo slide từ WeChat hoặc WeCom

WorkBuddy có thể nhận lệnh từ WeChat, WeCom (企业微信), Feishu, DingTalk và QQ. Sau khi kết nối 2Slides, hãy nhắn tin từ điện thoại của bạn:

Make a 6-slide Chinese deck introducing our new membership plan,
use a minimal theme, send me the link.

WorkBuddy chạy tác vụ trên máy tính của bạn và trả lời trong cùng cửa sổ chat kèm liên kết tải xuống. Vì liên kết chỉ tồn tại trong một giờ, hãy thêm câu lệnh "đồng thời lưu một bản sao vào Desktop của tôi" để bạn vẫn có tệp sau đó. Nếu kênh chat của bạn hỗ trợ gửi tệp, bạn có thể yêu cầu WorkBuddy gửi trực tiếp tệp đó.

2. Lập lịch tạo slide với các tác vụ tự động hóa

Mô-đun tự động hóa của WorkBuddy chạy các tác vụ theo lịch trình. Một tác vụ hàng tuần có thể là:

Every Monday at 9:00, read the latest file in ~/Reports/weekly,
create an 8-slide summary deck with 2slides (Fast PPT), save it to
~/Decks, and send me the link on WeCom.

Trang giá của WorkBuddy liệt kê giới hạn tác vụ tự động hóa cho mỗi gói: 3 ở bản 体验版 miễn phí, 15 ở bản 标准版 (99 ¥/tháng), 30 ở bản 高级版 (199 ¥/tháng) và 99 ở bản 旗舰版 (999 ¥/tháng). Tín dụng WorkBuddy và tín dụng 2Slides là riêng biệt. Mỗi bộ slide được tạo sẽ sử dụng tín dụng 2Slides từ API key của bạn (10 tín dụng cho mỗi trang Fast PPT).

Các công cụ MCP của 2Slides

Công cụ	Chức năng	Tín dụng
`themes_search`	Tìm một `themeId` trong hơn 1.500 mẫu	Miễn phí
`slides_generate`	Tạo `.pptx` có thể chỉnh sửa dựa trên mẫu (Fast PPT), đồng bộ hoặc bất đồng bộ	10 / trang
`slides_create_pdf_slides`	Slide thiết kế hình ảnh từ văn bản (Nano Banana)	100 / trang (1K/2K), 200 (4K)
`slides_create_like_this`	Slide khớp với phong cách của ảnh tham chiếu	100 / trang (1K/2K), 200 (4K)
`slides_generate_narration`	AI narration cho tác vụ Nano Banana (không áp dụng cho Fast PPT)	210 / trang
`slides_download_slides_pages_voices`	Tệp ZIP gồm ảnh các trang, âm thanh và bản ghi văn bản	Miễn phí
`jobs_get`	Kiểm tra trạng thái tác vụ bất đồng bộ (mỗi 20–30 giây)	Miễn phí

Các tác vụ Nano Banana và lời tường thuật là bất đồng bộ và thường mất 1–3 phút. WorkBuddy sẽ thăm dò jobs_get cho đến khi hoàn tất.

Xử lý sự cố

Dấu X đỏ ở mục stdio. Kiểm tra xem Node.js đã được cài đặt chưa (node -v), tệp JSON có hợp lệ không (không có dấu phẩy thừa), và env có chứa API_KEY không. Trong lần chạy đầu tiên, npx sẽ tải gói về, nên mạng chậm có thể làm chậm trạng thái đèn xanh.
Dấu X đỏ ở mục remote. Thử dùng "type": "http" thay vì "streamableHttp". Đảm bảo URL chính xác là https://2slides.com/api/mcp cộng với chuỗi truy vấn. Nếu vẫn thất bại, hãy sử dụng Phương thức 1.
401 / unauthorized. Khóa sai, đã bị xóa hoặc đặt sai trường. Đối với stdio, biến môi trường là API_KEY; đối với skill là SLIDES_2SLIDES_API_KEY.
Không đủ tín dụng. Nạp thêm tại 2slides.com/pricing, từ $5 cho 2.000 tín dụng.
Liên kết hết hạn. downloadUrl chỉ tồn tại 1 giờ. Yêu cầu WorkBuddy tạo lại, hoặc yêu cầu lưu tệp cục bộ từ nay về sau.
Muốn có lời tường thuật trên bộ slide Fast PPT. Lời tường thuật chỉ hoạt động trên các tác vụ Nano Banana. Hãy yêu cầu slides_create_pdf_slides trước.

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

WorkBuddy có hỗ trợ các MCP server tùy chỉnh không?

Có. WorkBuddy có trình chỉnh sửa MCP tại Plugins → MCP Server → Configure MCP, và một mục Custom Connector trên trang Connectors. Cấu hình được lưu trữ tại ~/.workbuddy/mcp.json (cấp người dùng) hoặc <project>/.workbuddy/mcp.json (cấp dự án). Dấu ✓ màu xanh lá cây cho biết server đã được kết nối thành công.

Cấu hình WorkBuddy MCP chính xác cho 2Slides là gì?

Mục nhập được khuyến nghị là "2slides": {"command": "npx", "args": ["-y", "2slides-mcp@latest"], "env": {"API_KEY": "YOUR_2SLIDES_API_KEY"}} bên trong mcpServers. Cấu hình này yêu cầu Node.js. Lựa chọn thay thế từ xa là "type": "streamableHttp" với "url": "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY".

Tôi có thể yêu cầu WorkBuddy tạo PPT từ WeChat không?

Có. Sau khi WorkBuddy được liên kết với WeChat hoặc WeCom và 2Slides đã được kết nối, bạn chỉ cần gửi yêu cầu trong chat. WorkBuddy sẽ tạo bộ slide trên máy tính của bạn và phản hồi bằng link tải xuống. Link này sẽ hết hạn sau 1 giờ, vì vậy hãy yêu cầu nó lưu một bản sao cục bộ.

WorkBuddy có thể sử dụng skill của 2Slides thay vì MCP không?

Có. Hãy tải xuống tệp ZIP của kho lưu trữ skill từ GitHub và kéo nó vào hộp thoại Upload Skill của WorkBuddy, hoặc yêu cầu WorkBuddy tìm và cài đặt nó. Skill này sẽ đọc SLIDES_2SLIDES_API_KEY từ môi trường và yêu cầu Python 3 cùng với requests.

Chi phí là bao nhiêu?

WorkBuddy có gói miễn phí (500 WorkBuddy credits/tháng, 3 tác vụ tự động hóa) và các gói trả phí từ ¥99/tháng. 2Slides được tính phí riêng: 500 tín dụng miễn phí cho tài khoản mới, Fast PPT tốn 10 tín dụng mỗi trang, và slide thiết kế hình ảnh tốn 100 tín dụng mỗi trang.

Cấu hình từ xa có được WorkBuddy hỗ trợ chính thức không?

Một phần. Tài liệu connector của Open Platform trên WorkBuddy sử dụng "type": "streamableHttp" cho các server từ xa, nhưng hướng dẫn MCP cho người dùng cuối chỉ hiển thị stdio. Đó là lý do tại sao hướng dẫn này ưu tiên khuyến nghị stdio và cung cấp "type": "http" như một phương án dự phòng cho kết nối từ xa.

Điểm chính cần nhớ

Một mục nhập mcpServers chạy npx -y 2slides-mcp@latest sẽ biến WorkBuddy thành một công cụ tạo slide mà bạn có thể truy cập từ WeChat, WeCom hoặc theo lịch trình sáng thứ Hai hàng tuần. Hãy chú ý dấu ✓ màu xanh lá, lưu file trước khi link hết hạn sau 1 giờ, và sử dụng skill nếu bạn muốn bỏ qua Node.js.

Các agent khác trong chuỗi bài viết này: trung tâm AI agent cá nhân cho bài thuyết trình, QwenWork (千问办公), QoderWake, Manus và OpenClaw. Đối với bất kỳ MCP client nào khác, hãy xem cách sử dụng mọi AI agent với 2Slides MCP server.

Lấy khóa API và cấu hình mẫu tại 2slides.com/api?tab=mcp.

Nguồn tham khảo: