2slides

chính thức

Đây là MCP Server tạo PPT, slide, bài thuyết trình AI đầu tiên, dễ nhất và rẻ nhất trên thế giới.

GitHub

Bạn có thể làm gì với 2slides MCP?

Tìm kiếm chủ đề trình bày — Sử dụng themes_search để tìm chủ đề theo từ khóa (ví dụ: "doanh nghiệp", "tối giản") và lấy themeId để tạo slide.
Tạo slide PowerPoint theo chủ đề — Cung cấp nội dung và themeId cho slides_generate để nhận tệp .pptx sẵn sàng tải xuống.
Tạo slide khớp với ảnh tham chiếu — Cung cấp URL ảnh tham chiếu và nội dung cho slides_create_like_this để tạo slide có phong cách trực quan tương tự ảnh.
Tạo slide thiết kế tùy chỉnh từ văn bản — Sử dụng slides_create_pdf_slides với designStyle dạng văn bản tự do để tạo slide mà không cần ảnh tham chiếu.
Thêm giọng đọc AI vào slide — Sử dụng slides_generate_narration để đính kèm giọng đọc một hoặc hai người vào tác vụ Nano Banana đã hoàn thành.
Xuất slide và âm thanh dưới dạng ZIP — Sử dụng slides_download_pages_voices để tải xuống từng ảnh slide, tệp âm thanh theo từng trang và bản ghi lời thoại cho tác vụ có giọng đọc.

Tài liệu

Máy chủ MCP 2slides

2slides

Cung cấp các công cụ của 2slides.com cho các máy khách MCP (ví dụ: Claude Desktop).

Lấy Khóa API

Trước khi sử dụng máy chủ MCP này, bạn cần lấy khóa API từ 2slides.com/api.

Cấu hình trong Claude Desktop

Chỉnh sửa ~/Library/Application Support/Claude/claude_desktop_config.json và thêm:

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

Sau đó khởi động lại hoàn toàn Claude Desktop. Trong cuộc trò chuyện, mở bảng công cụ và bạn sẽ thấy các công cụ bên dưới.

Các Công Cụ Khả Dụng

`slides_generate` (POST /api/v1/slides/generate)

Tạo bản trình bày PowerPoint bằng chủ đề dựng sẵn (Fast PPT). Sử dụng themes_search trước để tìm themeId.

Tham số:
- userInput (chuỗi, bắt buộc) — nội dung trình bày
- themeId (chuỗi, bắt buộc) — ID chủ đề từ themes_search
- responseLanguage (chuỗi, tùy chọn, mặc định: Auto) — ngôn ngữ đầu ra; các giá trị được hỗ trợ: Auto, English, Spanish, Arabic, Portuguese, Indonesian, Japanese, Russian, Hindi, French, German, Greek, Vietnamese, Turkish, Thai, Polish, Italian, Korean, Simplified Chinese, Traditional Chinese
- mode (tùy chọn, mặc định: sync) — sync trả về downloadUrl ngay lập tức; async trả về jobId để thăm dò bằng jobs_get
Tín dụng: 1 mỗi trang

Ví dụ:

{
  "themeId": "st-1756528793701-fcg5fblt2",
  "userInput": "Generate a 5-slide intro to machine learning",
  "responseLanguage": "English",
  "mode": "sync"
}

`themes_search` (GET /api/v1/themes/search)

Tìm kiếm các chủ đề dựng sẵn để sử dụng với slides_generate.

Tham số:
- query (chuỗi, bắt buộc) — từ khóa tìm kiếm (ví dụ: business, minimal, dark)
- limit (số, tùy chọn, mặc định: 10, phạm vi: 1–100)
Trả về: mảng các chủ đề với id, name, description, previewUrl, tags
Tín dụng: miễn phí
Ví dụ:
```
{ "query": "business", "limit": 5 }
```

`jobs_get` (GET /api/v1/jobs/{jobId})

Thăm dò trạng thái công việc và lấy kết quả khi sẵn sàng.

Tham số:
- jobId (chuỗi, bắt buộc)
Trả về: jobId, status (pending / processing / success / failed), message, downloadUrl (khi thành công), slidePageCount, createdAt, updatedAt, duration (ms), jobUrl (chỉ dành cho công việc Nano Banana)
Tín dụng: miễn phí
Lưu ý: Thăm dò mỗi 20 giây cho đến khi status là success hoặc failed.
Ví dụ:
```
{ "jobId": "D8h9VYDGdTlZ6wWSEoctF" }
```

`slides_create_like_this` (POST /api/v1/slides/create-like-this)

Tạo các slide (Nano Banana) khớp với phong cách của một hình ảnh tham chiếu.

Tham số:
- userInput (chuỗi, bắt buộc) — nội dung trình bày
- referenceImageUrl (chuỗi, bắt buộc) — URL của hình ảnh tham chiếu phong cách
- responseLanguage (chuỗi, tùy chọn, mặc định: Auto)
- aspectRatio (chuỗi, tùy chọn, mặc định: 16:9) — các giá trị hợp lệ: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
- resolution (chuỗi, tùy chọn, mặc định: 2K) — 1K, 2K, 4K
- page (số, tùy chọn, mặc định: 0) — 0 = tự động phát hiện, 1–100 = số trang chính xác
- contentDetail (chuỗi, tùy chọn, mặc định: standard) — concise hoặc standard
- mode (chuỗi, tùy chọn, mặc định: async) — async trả về jobId; sync trả về downloadUrl ngay lập tức
Tín dụng: 100 mỗi trang (1K/2K) hoặc 200 mỗi trang (4K)

Ví dụ:

{
  "userInput": "Create a presentation about AI trends",
  "referenceImageUrl": "https://example.com/style-reference.jpg",
  "aspectRatio": "16:9",
  "resolution": "2K",
  "page": 5,
  "contentDetail": "standard",
  "mode": "async"
}

`slides_create_pdf_slides` (POST /api/v1/slides/create-pdf-slides)

Tạo các slide thiết kế tùy chỉnh (Nano Banana) từ nội dung văn bản mà không cần hình ảnh tham chiếu.

Tham số:
- userInput (chuỗi, bắt buộc) — nội dung trình bày
- designStyle (chuỗi, tùy chọn) — mô tả văn bản tự do về phong cách trực quan; để trống để dùng kiểu mặc định
- responseLanguage (chuỗi, tùy chọn, mặc định: Auto)
- aspectRatio (chuỗi, tùy chọn, mặc định: 16:9) — các giá trị hợp lệ: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
- resolution (chuỗi, tùy chọn, mặc định: 2K) — 1K, 2K, 4K
- page (số, tùy chọn, mặc định: 0) — 0 = tự động phát hiện, 1–100 = số trang chính xác
- contentDetail (chuỗi, tùy chọn, mặc định: standard) — concise hoặc standard
- mode (chuỗi, tùy chọn, mặc định: async) — async trả về jobId; sync trả về downloadUrl ngay lập tức
Tín dụng: 100 mỗi trang (1K/2K) hoặc 200 mỗi trang (4K)

Ví dụ:

{
  "userInput": "Quarterly business review for Q3 2025",
  "designStyle": "modern, dark background, bold typography",
  "aspectRatio": "16:9",
  "resolution": "2K",
  "page": 8,
  "mode": "async"
}

`slides_generate_narration` (POST /api/v1/slides/generate-narration)

Thêm lồng tiếng AI vào công việc Nano Banana đã hoàn thành (chỉ slides_create_like_this hoặc slides_create_pdf_slides; không hỗ trợ Fast PPT). Luôn bất đồng bộ — thăm dò kết quả bằng jobs_get.

Tham số (một người nói, mode: "single" mặc định):
- jobId (chuỗi, bắt buộc) — UUID của công việc Nano Banana đã hoàn thành
- mode (chuỗi, tùy chọn, mặc định: single) — single hoặc multi
- speakerName (chuỗi, tùy chọn) — tên người dẫn chuyện
- voice (chuỗi, tùy chọn) — một trong 30 giọng (xem danh sách bên dưới)
- contentMode (chuỗi, tùy chọn, mặc định: standard) — concise hoặc standard
- includeIntro (boolean, tùy chọn, mặc định: true)
Tham số (hai người nói, mode: "multi"):
- jobId (chuỗi, bắt buộc)
- mode (chuỗi, bắt buộc) — multi
- speaker1Name (chuỗi, bắt buộc)
- speaker2Name (chuỗi, bắt buộc)
- speaker1Voice (chuỗi, tùy chọn) — giọng cho người nói 1
- speaker2Voice (chuỗi, tùy chọn) — giọng cho người nói 2
- contentMode (chuỗi, tùy chọn, mặc định: standard) — concise hoặc standard
Các giọng được hỗ trợ (30): Puck, Aoede, Charon, Kore, Fenrir, Zephyr, Leda, Orus, Callirrhoe, Autonoe, Enceladus, Iapetus, Umbriel, Algieba, Despina, Erinome, Algenib, Rasalgethi, Laomedeia, Achernar, Alnilam, Schedar, Gacrux, Pulcherrima, Achird, Zubenelgenubi, Vindemiatrix, Sadachbia, Sadaltager, Sulafat
Tín dụng: 210 mỗi trang (10 văn bản + 200 âm thanh)

Ví dụ:

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "mode": "multi",
  "speaker1Name": "Alice",
  "speaker2Name": "Bob",
  "speaker1Voice": "Aoede",
  "speaker2Voice": "Puck",
  "contentMode": "standard"
}

`slides_download_pages_voices` (POST /api/v1/slides/download-slides-pages-voices)

Xuất các trang slide và lồng tiếng dưới dạng tệp ZIP. Công việc phải được hoàn thành và đã tạo lồng tiếng.

Tham số:
- jobId (chuỗi, bắt buộc) — UUID của công việc có lồng tiếng đã hoàn thành
Trả về: downloadUrl (hết hạn sau 1 giờ), fileName, expiresIn (3600 giây)

Nội dung ZIP:

pages/
  page_01.png, page_02.png, …
voices/
  page_01.wav, page_02.wav, …
transcript.txt

Tín dụng: miễn phí

Ví dụ:

{ "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890" }

Quy Trình Làm Việc Điển Hình

Fast PPT (PowerPoint dựa trên chủ đề):

themes_search → lấy themeId
slides_generate (đồng bộ) → lấy trực tiếp downloadUrl

Nano Banana (slide thiết kế tùy chỉnh):

slides_create_like_this hoặc slides_create_pdf_slides (bất đồng bộ) → lấy jobId
jobs_get (thăm dò mỗi 20 giây) → lấy downloadUrl khi status: "success"

Nano Banana có lồng tiếng:

slides_create_like_this hoặc slides_create_pdf_slides → lấy jobId
jobs_get → đợi các slide hoàn thành
slides_generate_narration → lấy jobId lồng tiếng
jobs_get → đợi lồng tiếng hoàn thành
slides_download_pages_voices → lấy liên kết tải xuống ZIP

Khắc Phục Sự Cố (Claude Desktop)

Nếu các công cụ không xuất hiện trong Claude, hãy xác minh đường dẫn cấu hình là tuyệt đối và khởi động lại ứng dụng.
Kiểm tra nhật ký Claude MCP:

tail -n 50 -f ~/Library/Logs/Claude/mcp*.log

Đối với máy chủ MCP stdio, tránh ghi nhật ký ra stdout; máy chủ này chỉ ghi lỗi ra stderr.

Tham Khảo

Xây dựng máy chủ MCP (tài liệu chính thức): https://modelcontextprotocol.io/docs/develop/build-server
Tài liệu API 2slides: https://2slides.com/api
2slides: https://2slides.com
Mẫu 2slides: https://2slides.com/templates

2slides

Bạn có thể làm gì với 2slides MCP?

Tài liệu

Máy chủ MCP 2slides

Lấy Khóa API

Cấu hình trong Claude Desktop

Các Công Cụ Khả Dụng

slides_generate (POST /api/v1/slides/generate)

themes_search (GET /api/v1/themes/search)

jobs_get (GET /api/v1/jobs/{jobId})

slides_create_like_this (POST /api/v1/slides/create-like-this)

slides_create_pdf_slides (POST /api/v1/slides/create-pdf-slides)

slides_generate_narration (POST /api/v1/slides/generate-narration)

slides_download_pages_voices (POST /api/v1/slides/download-slides-pages-voices)

Quy Trình Làm Việc Điển Hình

Khắc Phục Sự Cố (Claude Desktop)

Tham Khảo

`slides_generate` (POST /api/v1/slides/generate)

`themes_search` (GET /api/v1/themes/search)

`jobs_get` (GET /api/v1/jobs/{jobId})

`slides_create_like_this` (POST /api/v1/slides/create-like-this)

`slides_create_pdf_slides` (POST /api/v1/slides/create-pdf-slides)

`slides_generate_narration` (POST /api/v1/slides/generate-narration)

`slides_download_pages_voices` (POST /api/v1/slides/download-slides-pages-voices)