Dùng Bất Kỳ AI Agent Nào Với 2Slides MCP Server: Hướng Dẫn Đầy Đủ 2026

Q: Stdio hay Streamable HTTP — tôi nên dùng transport nào?

Dùng stdio trên một máy nơi bạn có thể chạy Node.js (npx -y 2slides-mcp@latest) — đó là mặc định cho công việc cục bộ. Dùng Streamable HTTP (https://2slides.com/api/mcp?apikey=KEY) khi agent của bạn chạy trong CI, một container, hoặc một máy từ xa không cài gì cả. Cả hai phơi bày cùng bộ công cụ giống hệt.

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

Có. 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 công cụ 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 một gói tài nguyên xuất được cho video.

Q: MCP server có miễn phí không?

Đầu nối miễn phí để cài, và các lệnh gọi themessearch / jobsget / xuất file là miễn phí. Việc tạo slide tiêu tốn credit 2Slides — 10 credit mỗi trang cho Fast PPT, nhiều hơn cho bộ slide thiết kế bằng hình ảnh và có thuyết minh.

Trả lời nhanh (≤60 từ): 2Slides MCP server cho phép bất kỳ AI agent nào có hỗ trợ MCP tạo file PowerPoint thật. Nó chạy theo hai cách: stdio (npx -y 2slides-mcp@latest với một biến môi trường API_KEY) và Streamable HTTP (https://2slides.com/api/mcp?apikey=KEY). Lấy key tại 2slides.com/api, thêm server vào agent của bạn — Claude Code, Codex, OpenClaw, Gemini CLI, Qwen Code, và hơn nữa — rồi yêu cầu một bộ slide.

Mọi AI agent hiện đại đều có thể viết một dàn ý slide. Không cái nào, khi tự thân, có thể trao cho bạn một file .pptx thật, chỉnh sửa được, với theme, biểu đồ, thuyết minh và ghi chú thuyết trình. Đó là một việc tạo file — và 2Slides MCP server là đầu nối phổ quát trao khả năng đó cho bất kỳ client Model Context Protocol nào.

Viết cấu hình server một lần và cùng bộ công cụ ấy sẽ sáng lên trong bất cứ agent nào bạn dùng. Hướng dẫn này giải thích hai transport, chỉ ra những client nào được hỗ trợ, và liên kết đến hướng dẫn cài đặt từng bước cho mỗi cái.

2Slides MCP server là gì?

Đó là một đầu nối nhỏ phơi bày các API tạo slide của 2Slides dưới dạng công cụ MCP. Một khi agent được kết nối, nó có thể gọi:

Công cụ	Chức năng	Credit
`themes_search`	Tìm một `themeId` cho bộ slide dựa trên theme	Miễn phí
`slides_generate`	PowerPoint dựa trên theme (Fast PPT), đồng bộ/bất đồng bộ	10 / trang
`slides_create_pdf_slides`	Slide 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_this`	Slide khớp phong cách của một ảnh tham chiếu	100 / trang (1K/2K), 200 (4K)
`slides_generate_narration`	Thêm thuyết minh giọng AI vào một job Nano Banana	210 / trang
`slides_download_slides_pages_voices`	Xuất các trang + âm thanh thành một file ZIP	Miễn phí
`jobs_get`	Thăm dò một job bất đồng bộ đến khi hoàn tất	Miễn phí

Agent làm phần tư duy — đọc file của bạn, xây dựng lập luận, viết câu chữ. Server làm phần file. Bạn yêu cầu bằng ngôn ngữ đời thường; một link tải về quay lại trong ~30–60 giây.

Hai transport: stdio và Streamable HTTP

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

	Stdio Protocol	Streamable HTTP Protocol
Chạy ở đâu	Cục bộ, qua `npx -y 2slides-mcp@latest`	Từ xa, do 2Slides host
Cần Node.js cục bộ	Có	Không
Xác thực	Biến môi trường `API_KEY`	`?apikey=` trong URL (hoặc header `Authorization`)
Endpoint / lệnh	`npx -y 2slides-mcp@latest`	`https://2slides.com/api/mcp?apikey=KEY`
Phù hợp nhất cho	Dev cục bộ, toàn quyền kiểm soát, thân thiện offline	CI, container, máy từ xa, client gọn nhẹ

Cấu hình stdio chung (dạng mà hầu hết client chấp nhận):

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

Streamable HTTP chung: trỏ client của bạn đến https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY. (Tên khóa chính xác thay đổi tùy client — Gemini CLI và Qwen Code dùng httpUrl; OpenClaw dùng url + transport: "streamable-http"; Claude Code và Codex dùng một cờ --transport http hoặc một trường url.)

Lấy key, một cấu hình để dán sẵn, và endpoint tại 2slides.com/api?tab=mcp.

Tổng quan các agent được hỗ trợ

Agent / client	Vị trí cấu hình	Stdio	Streamable HTTP	Hướng dẫn cài đặt
Claude Code	`.mcp.json` / `claude mcp add`	✅	✅ (`--transport http`)	Hướng dẫn →
OpenAI Codex	`~/.codex/config.toml`	✅	✅ (`url`)	Hướng dẫn →
OpenClaw	`~/.openclaw/openclaw.json` (`mcp.servers`)	✅	✅ (`transport: streamable-http`)	Hướng dẫn →
Gemini CLI	`~/.gemini/settings.json`	✅	✅ (`httpUrl`)	Hướng dẫn →
Qwen Code	`~/.qwen/settings.json`	✅	✅ (`httpUrl`)	Hướng dẫn →
Claude Desktop	`claude_desktop_config.json`	✅	—	Hướng dẫn →
Kimi (Moonshot)	qua Kimi CLI hoặc Claude Code	✅	✅	Xem "Kimi & MiniMax" bên dưới
MiniMax	qua Mini-Agent hoặc Claude Code	✅	✅	Xem "Kimi & MiniMax" bên dưới

Mỗi hướng dẫn được liên kết đều có các khối cấu hình chính xác, lối tắt một dòng ... mcp add ở nơi có, và cách kiểm tra kết nối.

Chọn agent của bạn

Claude Code — CLI của Anthropic. claude mcp add 2slides -e API_KEY=xxx -- npx -y 2slides-mcp@latest, hoặc --transport http cho từ xa. Có các scope cho dùng cá nhân và dùng nhóm.
OpenAI Codex — một khối [mcp_servers.2slides] trong config.toml, hoặc codex mcp add 2slides --env API_KEY=xxx -- npx -y 2slides-mcp@latest. Từ xa qua một khối url.
OpenClaw — một mục dưới mcp.servers trong openclaw.json; kiểm tra bằng openclaw mcp probe 2slides --json. Công cụ hiện ra trong profile coding/messaging.
Gemini CLI — mcpServers trong settings.json (httpUrl cho từ xa), hoặc gemini mcp add.
Qwen Code — cùng dạng trong ~/.qwen/settings.json; mạnh cho bộ slide tiếng Trung.

Kimi và MiniMax: hai con đường bổ sung

Cả Kimi (Moonshot) lẫn MiniMax đều không phải là một CLI MCP-native hoàn chỉnh theo cách như các agent ở trên, nhưng cả hai đều tiếp cận 2Slides MCP server qua hai lộ trình đáng tin cậy:

Điều khiển một coding agent bằng mô hình của họ. Cả hai đều phơi bày một endpoint tương thích Anthropic, nên bạn có thể chạy Claude Code với chúng và gắn 2Slides qua chính cấu hình MCP của Claude Code:

# Kimi K2 via Moonshot export ANTHROPIC_BASE_URL="https://api.moonshot.ai/anthropic" export ANTHROPIC_AUTH_TOKEN="YOUR_MOONSHOT_KEY" claude # then: claude mcp add ... 2slides -- npx -y 2slides-mcp@latest # MiniMax export ANTHROPIC_BASE_URL="https://api.minimax.io/anthropic" export ANTHROPIC_AUTH_TOKEN="YOUR_MINIMAX_KEY" claude
Dùng runtime agent riêng của họ. Moonshot phát hành Kimi CLI (một MCP client gốc với cấu hình mcpServers/~/.kimi/mcp.json chuẩn), và MiniMax công bố Mini-Agent mã nguồn mở, vốn đọc một mcp.json chuẩn. Trong cả hai, hãy thêm 2Slides hệt như khối stdio hoặc Streamable HTTP chung ở trên.

Dù theo cách nào, các công cụ 2Slides đều giống hệt nhau — chỉ agent host là thay đổi.

Một ví dụ thực hành (mọi agent)

Cách tương tác là như nhau bất kể client. Bạn yêu cầu:

Read ./Q3-report.md and build a 12-slide executive summary.
Find a clean business theme from 2slides, generate the
PowerPoint, then return the download link.

Agent chạy themes_search → slides_generate (Fast PPT) → trả về một downloadUrl. Muốn slide tùy biến, thiết kế bằng hình ảnh kèm lồng tiếng AI? Hãy yêu cầu, và agent sẽ xâu chuỗi slides_create_pdf_slides → jobs_get → slides_generate_narration → jobs_get → slides_download_slides_pages_voices.

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

2Slides MCP server là gì?

Một đầu nối Model Context Protocol 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 công cụ. Bất kỳ agent có hỗ trợ MCP nào kết nối với nó đều có thể tạo file PowerPoint thật, chỉnh sửa được (và bộ slide thiết kế bằng hình ảnh kèm thuyết minh AI).

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

Dùng stdio trên một máy nơi bạn có thể chạy Node.js (npx -y 2slides-mcp@latest) — đó là mặc định cho công việc cục bộ. Dùng Streamable HTTP (https://2slides.com/api/mcp?apikey=KEY) khi agent của bạn chạy trong CI, một container, hoặc một máy từ xa không cài gì cả. Cả hai phơi bày cùng bộ công cụ giống hệt.

Những AI agent nào hoạt động với nó?

Bất kỳ MCP client nào. Hướng dẫn này bao quát trực tiếp Claude Code, OpenAI Codex, OpenClaw, Gemini CLI, Qwen Code, và Claude Desktop, cùng với Kimi và MiniMax qua Claude Code hoặc runtime agent riêng của chúng. Cursor, Windsurf, và các MCP client khác dùng cùng cấu hình chung này.

Tôi có cần một API key khác nhau cho mỗi agent không?

Không. Một 2Slides API key hoạt động trên mọi client và cả hai transport. Tạo nó một lần tại 2slides.com/api?tab=mcp.

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

Có. 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 công cụ 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 một gói tài nguyên xuất được cho video.

MCP server có miễn phí không?

Đầu nối miễn phí để cài, và các lệnh gọi themes_search / jobs_get / xuất file là miễn phí. Việc tạo slide tiêu tốn credit 2Slides — 10 credit mỗi trang cho Fast PPT, nhiều hơn cho bộ slide thiết kế bằng hình ảnh và có thuyết minh.

Điểm mấu chốt

Cấu hình 2Slides MCP server một lần — stdio cho cục bộ, Streamable HTTP cho từ xa — và mọi MCP agent bạn dùng có thêm con đường một câu đến một PowerPoint hoàn chỉnh. Agent tư duy; 2Slides dựng file.

Bước chuyển trong năm 2026 là "tạo cho tôi một bộ slide" không còn là một trò chat — nó là một lời gọi công cụ mà agent thực hiện thay bạn, trả về một file thật. Chọn client của bạn bên dưới và bạn sẽ có bộ slide đầu tiên trước khi đọc xong hướng dẫn cài đặt của nó:

Claude Code · OpenAI Codex · OpenClaw · Gemini CLI · Qwen Code

Để có thêm bối cảnh, hãy xem bản đồ hệ sinh thái PowerPoint MCP server và cách xây dựng một AI presentation agent.

Lấy API key, cấu hình để dán sẵn, và endpoint Streamable HTTP tại 2slides.com/api?tab=mcp — một server, mọi agent.

Nguồn:

Dùng Bất Kỳ AI Agent Nào Với 2Slides MCP Server: Hướng Dẫn Đầy Đủ 2026

2Slides MCP server là gì?

Hai transport: stdio và Streamable HTTP

Tổng quan các agent được hỗ trợ

Chọn agent của bạn

Kimi và MiniMax: hai con đường bổ sung

Một ví dụ thực hành (mọi agent)

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

2Slides MCP server là gì?

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

Những AI agent nào hoạt động với nó?

Tôi có cần một API key khác nhau cho mỗi agent không?

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

MCP server có miễn phí không?

Điểm mấu chốt

About 2Slides

Tóm tắt bằng AI

Sản phẩm

Tính năng

Thư viện

Mẫu

Tích hợp

Tài nguyên

So sánh