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 --env API_KEY=xxx --transport stdio 2slides -- npx 2slides-mcp

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

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

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 2slides-mcp
   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:

claude mcp add --env API_KEY=YOUR_2SLIDES_API_KEY --transport stdio 2slides -- npx 2slides-mcp

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 2slides-mcp
  ).
• 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

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

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

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:

claude mcp add --transport http 2slides https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY

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

claude mcp add --transport http 2slides https://2slides.com/api/mcp \
  --header "Authorization: Bearer YOUR_2SLIDES_API_KEY"

Kiểm tra kết nối

claude mcp list          # 2slides sẽ xuất hiện và kết nối
claude mcp get 2slides   # hiển thị cấu hình và các công cụ được phát hiện

Hoặc, trong một phiên tương tác, chạy lệnh slash

để 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:

Search the 2slides themes for a clean "business" style, then
generate a 7-slide deck introducing our Q3 roadmap. Pull the
content from ./ROADMAP.md. Return the download link.

Đằng sau hậu trường, Claude Code chạy

để tìm một , rồi (Fast PPT) và đưa cho bạn một . 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 (

), thăm dò 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_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

(transport stdio, SSE hoặc HTTP), liệt kê chúng bằng , và kiểm tra trong phiên bằng . 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

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 (

) trả về một file 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

để ghi một 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 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