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

Trả lời nhanh (≤60 từ): Claude Code có thể tạo file PowerPoint thật bằng cách kết nối với 2Slides MCP server. Lấy API key tại 2slides.com/api, rồi chạy claude mcp add 2slides -e API_KEY=xxx -- npx -y 2slides-mcp@latest cho stdio cục bộ, hoặc claude mcp add --transport http 2slides https://2slides.com/api/mcp?apikey=KEY cho Streamable HTTP từ xa. Sau đó chỉ cần yêu cầu Claude Code dựng bộ slide.

Claude Code là agent lập trình chạy trên terminal của Anthropic, và nó hỗ trợ Model Context Protocol (MCP) một cách tự nhiên. Điều đó nghĩa là bạn có thể trao cho nó một công cụ biến văn bản thành file .pptx hoàn chỉnh mà không cần rời khỏi shell. 2Slides MCP server chính là công cụ đó: một đầu nối gọn nhẹ phơi bày các API tạo slide, áp theme, thuyết minh và xuất file của 2Slides dưới dạng những công cụ MCP mà Claude Code có thể gọi trực tiếp.

Hướng dẫn này chỉ cho bạn cả hai cách kết nối — stdio cục bộ và Streamable HTTP từ xa — nên chọn cách nào, mỗi công cụ làm gì, và những prompt chính xác biến một yêu cầu một dòng thành file PowerPoint tải về được.

Tại sao phải kết nối Claude Code với 2Slides?

Claude Code rất giỏi suy luận trên repo của bạn, soạn nội dung và xây dựng lập luận. Điều nó không thể tự làm là xuất ra một file .pptx thật, chỉnh sửa được, với hình khối, biểu đồ, theme và ghi chú thuyết trình. Đó là bài toán tạo file, và nó thuộc về một công cụ chuyên dụng.

Sự phân chia rất rõ ràng:

• Claude Code đọc tài liệu nguồn của bạn (một README, một bản đặc tả, một file CSV, một ghi chú nghiên cứu), suy luận về nó, và quyết định nội dung trên từng slide.
• 2Slides MCP server nhận kế hoạch đó và kết xuất ra một file PowerPoint thực sự — hoặc các slide dạng hình ảnh kèm thuyết minh bằng giọng AI và xuất MP4.

Bạn ở yên trong terminal suốt quá trình. Yêu cầu, chờ ~30–60 giây, nhận link tải về.

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

1. Đã cài Claude Code và đã xác thực (claude có trong PATH).
2. Một 2Slides API key. Tạo tại 2slides.com/api. Cũng trang đó có cấu hình MCP để dán sẵn và endpoint Streamable HTTP.
3. Node.js (cho transport stdio, vốn chạy npx -y 2slides-mcp@latest cục bộ). Transport HTTP không cần gì cài cục bộ cả.

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

2Slides MCP server hỗ trợ hai transport. Cả hai phơi bày cùng một bộ công cụ giống hệt; chúng chỉ khác ở chỗ đầu nối chạy ở đâu.

Nguyên tắc chung: dùng stdio trên máy của bạn cho công việc hằng ngày, và Streamable HTTP khi Claude Code chạy ở nơi bạn không thể cài Node (một máy từ xa, một tác vụ CI, một container bị khóa chặt).

Phương pháp 1: Kết nối qua stdio (cục bộ)

Chạy lệnh này một lần. Dấu phân tách -- tách các cờ riêng của Claude Code khỏi lệnh mà nó khởi chạy:

Vài điều đáng lưu ý:

• Giữ --transport stdio (hoặc một cờ khác) giữa --env và tên server. Vì --env chấp nhận nhiều cặp KEY=value, đặt tên ngay sau nó có thể khiến CLI hiểu tên đó là một biến môi trường khác.
• Mọi thứ sau -- được truyền nguyên vẹn cho server (npx -y 2slides-mcp@latest).
• Thêm --scope user để 2Slides khả dụng trong mọi project, hoặc --scope project để commit nó vào một .mcp.json dùng chung cho nhóm của bạn.

File .mcp.json kết quả (phạm vi project) trông như thế này — bạn cũng có thể chỉnh tay:

Phương pháp 2: Kết nối qua Streamable HTTP (từ xa)

Không cài đặt cục bộ — chỉ trỏ Claude Code đến endpoint được host:

Muốn giữ key ngoài URL? Gửi nó dưới dạng header thay thế:

Kiểm tra kết nối

Hoặc, trong một phiên tương tác, chạy lệnh slash /mcp để xem các server đã kết nối, số lượng công cụ, và (với server từ xa) trạng thái xác thực.

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

Sau khi kết nối, bạn không gọi công cụ thủ công — bạn chỉ cần yêu cầu. Claude Code tự động xâu chuỗi các công cụ 2Slides:

Đằng sau hậu trường, Claude Code chạy themes_search để tìm một themeId, rồi slides_generate (Fast PPT) và đưa cho bạn một downloadUrl. Tổng thời gian: khoảng 30–60 giây cho một file PowerPoint có theme.

Muốn slide tùy biến, thiết kế bằng hình ảnh thay vì template? Hãy yêu cầu điều đó và Claude Code sẽ dùng đường Nano Banana (slides_create_pdf_slides), thăm dò jobs_get cho đến khi sẵn sàng, rồi trả về link.

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

Sau khi kết nối, Claude Code nhìn thấy các công cụ này:

Ba chuỗi tiêu biểu:

• Fast PPT: themes_search → slides_generate (đồng bộ) → tải về.
• Nano Banana: slides_create_pdf_slides (bất đồng bộ) → jobs_get → tải về.
• Tài nguyên video có thuyết minh: tạo slide → jobs_get → slides_generate_narration → jobs_get → slides_download_slides_pages_voices.

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

• Server không xuất hiện trong claude mcp list. Với stdio, kiểm tra thứ tự --env/tên có đúng không (giữ một cờ giữa --env và tên). Với HTTP, kiểm tra lại URL và rằng API key còn hợp lệ.
• Thiếu API_KEY. Server stdio cần biến môi trường; server HTTP cần ?apikey= hoặc một header Authorization. Đừng nhầm lẫn giữa chúng.
• Yêu cầu một file .pptx mà không có công cụ. Khi chưa kết nối 2Slides, Claude Code có thể viết dàn ý nhưng không thể xuất một PowerPoint thật. Hãy kết nối server trước.
• Quên theme. Nếu bạn không chạy themes_search hoặc không nêu phong cách, Fast PPT sẽ tự chọn giúp bạn. Hãy chỉ định để kiểm soát diện mạo.
• Thăm dò quá nhanh. Job bất đồng bộ (Nano Banana, thuyết minh) nên được thăm dò bằng jobs_get khoảng mỗi 20 giây, không phải trong một vòng lặp dồn dập.

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

Claude Code có hỗ trợ MCP server một cách tự nhiên không?

Có. Claude Code là một MCP client hạng nhất. Bạn thêm server bằng claude mcp add (transport stdio, SSE hoặc HTTP), liệt kê chúng bằng claude mcp list, và kiểm tra trong phiên bằng /mcp. Server 2Slides hoạt động với tất cả những cách này.

Stdio hay Streamable HTTP — tôi nên dùng cái nào?

Dùng stdio trên máy cục bộ của bạn (nó chạy npx -y 2slides-mcp@latest giúp bạn) và Streamable HTTP ở bất cứ đâu bạn không thể hoặc không muốn cài Node — CI, container, server từ xa. Cả hai phơi bày cùng bộ công cụ và cho kết quả giống hệt nhau.

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

Có. Đường Fast PPT (slides_generate) trả về một file .pptx chỉnh sửa được với hình khối và theme thật. Các đường Nano Banana trả về bộ slide thiết kế bằng hình ảnh và có thể thêm thuyết minh giọng AI cùng các tài nguyên xuất được. Đây là những file bạn có thể mở, chỉnh sửa và trình chiếu — không phải ảnh chụp màn hình.

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

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

Tôi có thể chia sẻ server 2Slides với nhóm của mình không?

Có. Thêm nó bằng --scope project để ghi một .mcp.json dùng chung mà bạn commit vào repo. Đồng đội sẽ được hỏi phê duyệt khi dùng lần đầu. Dùng --scope user cho thiết lập riêng tư, áp dụng cho mọi project.

Điểm mấu chốt

Claude Code làm phần tư duy; 2Slides MCP server làm phần file. Kết nối một lần — stdio cho cục bộ, Streamable HTTP cho từ xa — và "tạo cho tôi một bộ slide" trở thành một câu duy nhất trong terminal của bạn.

Nếu bạn sống trong Claude Code, đây là con đường nhanh nhất từ một ý tưởng (hoặc một file trong repo) đến một file PowerPoint hoàn chỉnh, chỉnh sửa được. Để có cái nhìn rộng hơn về việc gắn slide vào các agent, 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 đầy đủ. Dùng ứng dụng desktop thay vì CLI? Xem cách dùng Claude MCP để tạo bài thuyết trình.

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 từ terminal trong chưa đầy một phút.

Nguồn:

• Claude Code — Connect to tools via MCP (official docs)
• 2Slides API & MCP server