Cách sử dụng QoderWake với 2Slides: MCP cho Nhân viên AI (2026)

Q: Lệnh chính xác để thêm 2Slides vào một Waker là gì?

qoderwake mcp add --waker-id agxxx --name 2slides --transport http --http-url https://2slides.com/api/mcp --header "Authorization=Bearer YOUR2SLIDESAPIKEY". Hãy trích dẫn toàn bộ cặp header, vì giá trị có chứa khoảng trắng.

Q: Tôi nên lưu trữ API key của 2Slides ở đâu trong QoderWake?

Trong header của trình kết nối MCP (--header hoặc --headers) hoặc --env của nó đối với stdio. Tuyệt đối không đưa vào tác vụ, bộ nhớ, cơ sở tri thức hoặc tệp vai trò. Tài liệu của QoderWake nghiêm cấm điều đó.

Q: Waker có thể tự động tạo slide hàng tuần không?

Có. Hãy tạo một quy trình tự động hóa theo lịch trình với qoderwake automation create schedule và một biểu thức cron. Kiểm tra nó với automation run-now trước khi để nó chạy tự động.

Trả lời nhanh (≤60 từ): Tìm ID của Waker bằng qoderwake waker list --json, sau đó chạy qoderwake mcp add --waker-id ag_xxx --name 2slides --transport http --http-url https://2slides.com/api/mcp --header "Authorization=Bearer YOUR_2SLIDES_API_KEY". Waker đó có thể tìm kiếm các Mẫu 2Slides và trả về một file .pptx có thể chỉnh sửa theo yêu cầu từ DingTalk, Feishu hoặc theo lịch trình.

QoderWake, từ đội ngũ Qoder tại Alibaba, gọi sản phẩm của mình là "Nhân viên AI tự chủ, đang làm việc". Mỗi nhân viên kỹ thuật số được gọi là một Waker. Một Waker được kích hoạt bởi tin nhắn IM, lịch trình, sự kiện hook hoặc lệnh gọi API và tự thực hiện công việc. QoderWake chạy trên macOS 13+, Linux và Windows 10+. Nó có bảng điều khiển web cục bộ tại 127.0.0.1:19820, một CLI đầy đủ và kết nối với DingTalk và Feishu.

Các máy chủ và kỹ năng MCP được gắn theo từng Waker. Hướng dẫn này chỉ cách cấp cho một Waker (ví dụ: "Trợ lý báo cáo" của bạn) công cụ trình bày 2Slides. Hướng dẫn sử dụng tài liệu tham khảo CLI chính thức của QoderWake và các endpoint của 2Slides đã được chúng tôi kiểm thử trực tiếp trên môi trường production vào ngày 30 tháng 9 năm 2026.

Tại sao nên cấp 2Slides cho Waker?

Waker được xây dựng cho các công việc định kỳ, và "biến số liệu tuần này thành một bộ slide" chính xác là loại công việc đó.
2Slides tạo ra file thực tế: một bản PowerPoint có thể chỉnh sửa dựa trên chủ đề (Fast PPT, 10 tín dụng mỗi trang), hoặc các slide thiết kế hình ảnh (Nano Banana, 100 tín dụng mỗi trang ở mức 1K/2K) với tùy chọn AI voice narration.
Phạm vi theo từng Waker có nghĩa là chỉ Waker nào cần làm slide mới được cấp công cụ và khóa API.

Những thứ bạn cần chuẩn bị

QoderWake đã cài đặt và đăng nhập. Trên macOS hoặc Linux, tài liệu CLI cung cấp trình cài đặt một dòng:

curl -fsSL https://qoder-ide.oss-ap-southeast-1.aliyuncs.com/qoderwake/install.sh | bash
qoderwake login
qoderwake start      # daemon on 127.0.0.1:19820

Bản cài đặt cho Windows và macOS có sẵn trên trang web QoderWake. Nếu shell không tìm thấy qoderwake, hãy sử dụng ~/.qoderwake/bin/qoderwake.

Khóa API 2Slides từ 2slides.com/api (sk-2slides-...). Các tài khoản mới nhận được 500 tín dụng miễn phí, đủ cho 50 trang Fast PPT.
Node.js trên thiết bị, chỉ dành cho phương thức stdio.

Bước 1: Tìm Waker ID

qoderwake waker list --json

Waker ID bắt đầu bằng ag_. Sao chép ID của Waker mà bạn muốn giao nhiệm vụ tạo slide. Các ví dụ dưới đây sử dụng ag_xxx.

Phương thức 1: Hosted MCP qua HTTP (khuyên dùng)

qoderwake mcp add --waker-id ag_xxx \
  --name 2slides \
  --description "2Slides presentation generator" \
  --transport http \
  --http-url https://2slides.com/api/mcp \
  --header "Authorization=Bearer YOUR_2SLIDES_API_KEY"

Lưu ý về dấu ngoặc kép. Cú pháp của CLI là --header KEY=VALUE (có thể lặp lại). Giá trị ở đây, Bearer YOUR_2SLIDES_API_KEY, có chứa khoảng trắng, vì vậy hãy bao toàn bộ cặp KEY=VALUE trong dấu ngoặc kép như hướng dẫn. Nếu không có ngoặc kép, shell sẽ chia nó thành hai đối số và header gửi đi sẽ chỉ còn là Bearer.

Bạn muốn tránh hoàn toàn việc xử lý = và khoảng trắng? Hãy sử dụng định dạng JSON của cùng tùy chọn đó, --headers <json>:

qoderwake mcp add --waker-id ag_xxx \
  --name 2slides \
  --transport http \
  --http-url https://2slides.com/api/mcp \
  --headers '{"Authorization":"Bearer YOUR_2SLIDES_API_KEY"}'

Trong Windows PowerShell, dấu ngoặc đơn cũng hoạt động, nhưng việc trích dẫn JSON giữa các shell khác nhau có thể khá rắc rối. Trong trường hợp đó, việc nhập từ file ở Phương thức 2 là lựa chọn an toàn hơn.

Phương án dự phòng không dùng header. Nếu header vẫn không được gửi đi (lỗi 401 hoặc Authentication required khi làm mới công cụ), hãy bỏ qua hoàn toàn header. 2Slides cũng chấp nhận khóa API dưới dạng tham số truy vấn URL, và chúng tôi đã kiểm thử thành công phương thức này:

qoderwake mcp add --waker-id ag_xxx \
  --name 2slides \
  --transport http \
  --http-url "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"

Hãy coi URL đó như mật khẩu: đừng dán nó vào các tác vụ hoặc ảnh chụp màn hình, và hãy thu hồi khóa tại 2slides.com/api nếu nó bị lộ.

2Slides sử dụng khóa API thông thường, không phải OAuth, vì vậy hãy tắt tất cả các cờ --oauth-*.

Phương thức 2: Nhập MCP JSON

qoderwake mcp add cũng chấp nhận --json <json> hoặc --json-file <path> để nhập trực tiếp MCP JSON. Lưu nội dung sau thành 2slides-mcp.json:

{
  "mcpServers": {
    "2slides": {
      "type": "streamable-http",
      "url": "https://2slides.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_2SLIDES_API_KEY"
      }
    }
  }
}

qoderwake mcp add --waker-id ag_xxx --json-file 2slides-mcp.json

Tài liệu CLI không nêu rõ trình nhập chấp nhận những cấu trúc JSON nào. Khối mã trên là định dạng mcpServers phổ biến. Nếu việc nhập bị từ chối, hãy sử dụng các cờ của Phương thức 1 vốn đã được tài liệu hóa đầy đủ. Hãy xóa file sau đó, hoặc để nó ngoài các kho lưu trữ Git, vì nó chứa khóa của bạn.

Phương thức 3: Máy chủ stdio cục bộ

Để chạy gói mã nguồn mở 2slides-mcp trên thiết bị của Waker:

qoderwake mcp add --waker-id ag_xxx \
  --name 2slides \
  --transport stdio \
  --command npx \
  --args "-y,2slides-mcp@latest" \
  --env '{"API_KEY":"YOUR_2SLIDES_API_KEY"}'

--args nhận một danh sách cách nhau bởi dấu phẩy, cùng kiểu với ví dụ hệ thống tệp chính thức trong tài liệu CLI. --env nhận JSON. Cách này yêu cầu Node.js trên máy chạy Waker, và QoderWake mặc định được cài đặt trên thiết bị.

Xác minh kết nối

qoderwake mcp list --waker-id ag_xxx                      # 2slides should be listed
qoderwake mcp refresh-tools --waker-id ag_xxx --mcp-id <mid>
qoderwake mcp get --waker-id ag_xxx --mcp-id <mid>        # inspect the entry

Lấy <mid> từ mcp list. Sau đó gửi cho Waker một bài kiểm tra chỉ đọc. Hướng dẫn của chính QoderWake là xác thực một trình kết nối mới bằng một lệnh gọi chỉ đọc trước:

List the tools you have from 2slides, then search for a "minimal" theme and show me the themeId.

themes_search là miễn phí, vì vậy bài kiểm tra này không tốn phí. Nếu một trình kết nối hoạt động không đúng, qoderwake mcp toggle --waker-id ag_xxx --mcp-id <mid> --enabled false sẽ tắt nó mà không xóa.

Phương thức 4: Tải lên skill 2Slides

Các skill của QoderWake là các gói tính năng được quản lý bằng phiên bản git mà bạn có thể so sánh (diff) và khôi phục (roll back). Bạn tải lên "một tệp Markdown hoặc kho lưu trữ chứa SKILL.md". Skill chính thức của 2Slides có tại github.com/2slides/slides-generation-2slides-skills. Hãy nén nó lại sao cho SKILL.md nằm ở thư mục gốc của kho lưu trữ:

git clone https://github.com/2slides/slides-generation-2slides-skills
cd slides-generation-2slides-skills
zip -r ../2slides-skill.zip SKILL.md scripts references
cd ..
qoderwake skill upload 2slides-skill.zip --waker-id ag_xxx

Thao tác này sẽ loại bỏ gói .skill cũ hơn trong repo. Các script Python của skill (Python 3 và requests) sẽ đọc khóa từ biến môi trường SLIDES_2SLIDES_API_KEY.

Quy tắc về bảo mật. Tài liệu của QoderWake nêu rõ: "Không bao giờ đưa bí mật, token hoặc cookie vào các tác vụ (task), bộ nhớ (memory), cơ sở tri thức (knowledge base), tệp vai trò (role file) hoặc ảnh chụp màn hình." Thông tin xác thực phải nằm trong các trường được bảo vệ hoặc biến môi trường. Vì vậy, đừng bao giờ dán khóa của bạn vào prompt tác vụ hoặc yêu cầu Waker "ghi nhớ" nó. QoderWake không cung cấp tài liệu về cách truyền biến môi trường vào các script của skill, vì vậy chúng tôi khuyên bạn nên phân chia như sau:

Sử dụng trình kết nối MCP (Phương thức 1) cho các lệnh gọi API thực tế. Khóa sẽ nằm trong header của nó.
Chỉ sử dụng skill nếu biến SLIDES_2SLIDES_API_KEY đã được thiết lập trong môi trường mà Waker đang chạy. Kiểm tra bằng một tác vụ thử nghiệm chạy scripts/search_themes.py --query minimal --limit 1.

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

Read sales_week39.csv in the project, summarize the key movements,
and build an 8-slide weekly sales review with 2slides. Search for a
clean business theme first, then generate the PowerPoint and send
me the download link.

Waker sẽ gọi themes_search, sau đó là slides_generate, và trả về một downloadUrl. Trong thử nghiệm thực tế của chúng tôi, một bộ Fast PPT 3 trang được trả về trong khoảng 22 giây. Liên kết sẽ hết hạn sau 1 giờ. Tài liệu của QoderWake cho biết việc phân phối tệp "phụ thuộc vào khả năng của kênh. Hãy sử dụng liên kết được trả về hoặc tệp đính kèm của tác vụ (task artifact)". Vì vậy, hãy yêu cầu Waker gửi liên kết ngay lập tức hoặc tải .pptx xuống không gian làm việc của nó. Sau đó, bạn có thể lấy nó từ phiên làm việc bằng qoderwake session artifacts --session-id sess_xxx.

Các trường hợp sử dụng cho nhân viên AI

Kích hoạt từ DingTalk hoặc Feishu. Khi một Waker được ghép nối với kênh DingTalk hoặc Feishu, một đồng nghiệp có thể nhắn tin "@Reporting Assistant hãy tạo một bản cập nhật 6 slide về kế hoạch tuyển dụng Q4". Waker sẽ thu thập ngữ cảnh, gọi 2Slides và trả lời bằng liên kết.

Bộ slide hàng tuần theo lịch trình. Tài liệu tham khảo CLI có hướng dẫn về tự động hóa theo lịch trình:

qoderwake automation create schedule --waker-id ag_xxx \
  --name "Weekly Sales Deck" \
  --schedule-type cron --cron "0 9 * * 1" \
  --timezone Asia/Shanghai \
  --prompt "Build this week's 8-slide sales review from the latest CSV with 2slides and post the download link"
qoderwake automation run-now --waker-id ag_xxx --automation-id tr_xxx   # test once

Chạy thử một lần với run-now và kiểm tra kết quả với qoderwake automation detail trước khi để nó tự chạy.

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 chủ đề	Miễn phí
`slides_generate`	PowerPoint có thể chỉnh sửa dựa trên chủ đề (Fast PPT), đồng bộ hoặc không đồ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 thuyết minh giọng nói cho một tác vụ Nano Banana	210 / trang
`slides_download_slides_pages_voices`	Tệp ZIP chứa ả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ụ không đồng bộ (mỗi 20 đến 30 giây)	Miễn phí

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

Mục	Trạng thái
Các cờ `waker list`, `mcp add` (`--transport`, `--http-url`, `--header`, `--headers`, `--json`, `--command`, `--args`, `--env`), `skill upload`	Đã xác nhận trong tài liệu tham khảo QoderWake CLI
MCP và skill được áp dụng cho từng Waker; bí mật không được đưa vào tác vụ hoặc bộ nhớ	Đã xác nhận trong tài liệu QoderWake
Endpoint 2Slides, xác thực Bearer, 7 công cụ	Đã được 2Slides kiểm tra thực tế
Cấu trúc JSON chính xác được chấp nhận bởi `mcp add --json`	Chưa có tài liệu; định dạng `mcpServers` được hiển thị dưới dạng nỗ lực tốt nhất
Cách `--header` chia tách một giá trị chứa `=`	Chưa có tài liệu; hãy đặt toàn bộ cặp trong dấu ngoặc kép hoặc sử dụng JSON `--headers`
Truyền biến môi trường vào script của skill	Chưa có tài liệu

Khắc phục sự cố

"daemon unreachable". Chạy qoderwake status. Nếu daemon không chạy, qoderwake start. Nếu cổng đã bị chiếm dụng, qoderwake start --port auto.
Lỗi 401 từ chính QoderWake. Chạy qoderwake whoami, và qoderwake login lại nếu cần.
Lỗi 401 từ 2Slides. Header có thể đã được gửi mà không có khóa. Hãy thêm lại bằng --header được đặt trong dấu ngoặc kép hoặc định dạng JSON --headers.
Thiếu công cụ. Chạy qoderwake mcp refresh-tools, và kiểm tra xem trình kết nối đã được bật chưa bằng mcp toggle ... --enabled true.
stdio thất bại. Kiểm tra xem Node.js đã được cài đặt trên thiết bị của Waker chưa và --args có được phân tách bằng dấu phẩy không.
Lỗi trong quá trình chạy. qoderwake log --level error --limit 100 hoặc qoderwake trace list --status failed.
Liên kết hết hạn. downloadUrl có hiệu lực trong 1 giờ. Hãy yêu cầu Waker lưu tệp dưới dạng tệp đính kèm của tác vụ (task artifact).

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

QoderWake có hỗ trợ các máy chủ MCP tùy chỉnh không?

Có. Mỗi Waker có thể gắn nhiều máy chủ MCP thông qua stdio, HTTP hoặc SSE, sử dụng qoderwake mcp add --waker-id <id> hoặc màn hình Custom MCP Connectors trong bảng điều khiển.

Lệnh chính xác để thêm 2Slides vào một Waker là gì?

qoderwake mcp add --waker-id ag_xxx --name 2slides --transport http --http-url https://2slides.com/api/mcp --header "Authorization=Bearer YOUR_2SLIDES_API_KEY". Hãy trích dẫn toàn bộ cặp header, vì giá trị có chứa khoảng trắng.

Tôi nên lưu trữ API key của 2Slides ở đâu trong QoderWake?

Trong header của trình kết nối MCP (--header hoặc --headers) hoặc --env của nó đối với stdio. Tuyệt đối không đưa vào tác vụ, bộ nhớ, cơ sở tri thức hoặc tệp vai trò. Tài liệu của QoderWake nghiêm cấm điều đó.

Waker có thể gửi PowerPoint tới DingTalk hoặc Feishu không?

Waker luôn có thể trả lời bằng liên kết tải xuống của 2Slides. Việc tệp có được đính kèm trực tiếp hay không tùy thuộc vào kênh. Tài liệu của QoderWake khuyên bạn nên sử dụng liên kết được trả về hoặc tệp đính kèm của tác vụ. Liên kết sẽ hết hạn sau 1 giờ.

Waker có thể tự động tạo slide hàng tuần không?

Có. Hãy tạo một quy trình tự động hóa theo lịch trình với qoderwake automation create schedule và một biểu thức cron. Kiểm tra nó với automation run-now trước khi để nó chạy tự động.

Chi phí là bao nhiêu?

Các tài khoản 2Slides mới nhận được 500 tín dụng miễn phí. Fast PPT tốn 10 tín dụng mỗi trang, vì vậy một bộ slide 8 trang hàng tuần sẽ tốn 80 tín dụng. Tìm kiếm chủ đề, kiểm tra trạng thái tác vụ và xuất tệp là miễn phí.

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

Chỉ một lệnh qoderwake mcp add sẽ biến Waker thành một nhân viên AI thực thụ chuyên xuất bản các bộ slide. Hãy lưu khóa trong MCP header, kích hoạt từ DingTalk, Feishu hoặc theo lịch trình cron, và nhận ngay .pptx trong vòng chưa đầy một giờ.

Các hướng dẫn liên quan: các agent AI cá nhân có thể tạo slide, QwenWork với 2Slides, WorkBuddy với 2Slides, sử dụng bất kỳ agent AI nào với MCP server của 2Slides, và kỹ năng của agent so với MCP server cho bài thuyết trình.

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

Nguồn tham khảo: