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

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

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 2slides-mcp
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ăngCredit
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ếu100 / trang (1K/2K), 200 (4K)
slides_generate_narration
Thêm thuyết minh giọng AI vào một job Nano Banana210 / trang
slides_download_pages_voices
Xuất các trang + âm thanh thành một file ZIPMiễn phí
jobs_get
Thăm dò một job bất đồng bộ đến khi hoàn tấtMiễ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 ProtocolStreamable HTTP Protocol
Chạy ở đâuCục bộ, qua
npx 2slides-mcp
Từ xa, do 2Slides host
Cần Node.js cục bộCóKhông
Xác thựcBiến môi trường
API_KEY
?apikey=
trong URL (hoặc header
Authorization
)
Endpoint / lệnh
npx 2slides-mcp
https://2slides.com/api/mcp?apikey=KEY
Phù hợp nhất choDev cục bộ, toàn quyền kiểm soát, thân thiện offlineCI, 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": ["2slides-mcp"],
      "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 / clientVị trí cấu hìnhStdioStreamable HTTPHướ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
MiniMaxqua 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 --env API_KEY=xxx --transport stdio 2slides -- npx 2slides-mcp
    , 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 2slides-mcp
    . 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:

  1. Đ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 2slides-mcp

# MiniMax
export ANTHROPIC_BASE_URL="https://api.minimax.io/anthropic"
export ANTHROPIC_AUTH_TOKEN="YOUR_MINIMAX_KEY"
claude

  2. 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_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 2slides-mcp
) — đó 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ó:

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

About 2Slides

Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.

Try For Free
2Slides logo

Your AI Agent for slides. Save time, shine faster with intelligent presentation creation.

Summarize with AI

ChatGPTClaudeGrokPerplexity

© 2026 2slides. All rights reserved.