2slides

Máy chủ MCP 2slides

Hiển thị các công cụ của 2slides.com cho các máy khách MCP: tạo bản trình bày PowerPoint và các slide được thiết kế tùy chỉnh, thêm tường thuật bằng giọng nói AI, và nhận lại các tệp hoàn chỉnh dưới dạng liên kết tải xuống.

Lấy Khóa API của Bạn

Trước khi kết nối, hãy lấy khóa API từ 2slides.com/api.

Kết nối

2slides chạy một điểm cuối MCP Streamable HTTP được lưu trữ, và cũng cung cấp gói stdio này. Cả hai đều hiển thị cùng 7 công cụ trên cùng một tài khoản và cùng một số tín dụng.

	Streamable HTTP	stdio (gói này)
Thiết lập	một lệnh, không cần cài đặt gì	cần Node.js 18+, npx tải gói
Cập nhật	phía máy chủ, luôn mới nhất	được tải lại trên máy của bạn
Chạy trong	bất kỳ máy khách MCP nào hỗ trợ từ xa	bất kỳ máy khách nào có thể khởi chạy một tiến trình cục bộ

Tùy chọn 1 — Streamable HTTP (khuyến nghị)

Tài liệu MCP của Anthropic gọi HTTP là "tùy chọn được khuyến nghị để kết nối với các máy chủ MCP từ xa", và 2slides là một dịch vụ được lưu trữ không có tệp hoặc tiến trình cục bộ nào để truy cập, vì vậy hãy bắt đầu từ đây.

Claude Code

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

Xác minh bằng claude mcp list — máy chủ sẽ báo cáo ✔ Connected.

Cấu hình dự án (.mcp.json, chia sẻ với nhóm của bạn)

{
  "mcpServers": {
    "2slides": {
      "type": "http",
      "url": "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"
    }
  }
}

Claude Desktop / claude.ai: thêm nó như một trình kết nối tùy chỉnh tại claude.ai/customize/connectors với cùng URL.

Tùy chọn 2 — stdio (tiến trình cục bộ)

Sử dụng tùy chọn này khi máy khách chỉ có thể khởi chạy các tiến trình cục bộ, khi máy không có tuyến đường trực tiếp đến 2slides.com, hoặc khi bạn muốn tự mình ghim và vá máy chủ.

Claude Code

claude mcp add 2slides -e API_KEY=YOUR_2SLIDES_API_KEY -- npx -y 2slides-mcp@latest

Claude Desktop — chỉnh sửa ~/Library/Application Support/Claude/claude_desktop_config.json (%APPDATA%\Claude\claude_desktop_config.json trên Windows):

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

Cờ -y cho phép npx cài đặt gói mà không cần nhắc. Khởi động lại hoàn toàn Claude Desktop sau đó; trong một 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ụ Có sẵn

---

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

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

• Đối số:
  • userInput (chuỗi, bắt buộc) — nội dung bản 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ề một jobId để thăm dò với 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ủ đề được xây dựng sẵn để sử dụng với slides_generate.

• Đối 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ủa một công việc và truy xuất kết quả khi sẵn sàng.

• Đối 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.

• Đối số:
  • userInput (chuỗi, bắt buộc) — nội dung bản 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 được 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.

• Đối số:
  • userInput (chuỗi, bắt buộc) — nội dung bản 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 để có 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 tường thuật bằng giọng nói AI vào một công việc Nano Banana đã hoàn thành (slides_create_like_this hoặc slides_create_pdf_slides chỉ; Fast PPT không được hỗ trợ). Luôn không đồng bộ — thăm dò kết quả với jobs_get.

• Đối số (một người nói, mặc định mode: "single"):

  • jobId (chuỗi, bắt buộc) — UUID của một 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 tường thuật
  • voice (chuỗi, tùy chọn) — một trong 30 giọng nói (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)

• Đối 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 nói cho người nói 1
  • speaker2Voice (chuỗi, tùy chọn) — giọng nói 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 nói đượ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_slides_pages_voices (POST /api/v1/slides/download-slides-pages-voices)

Xuất các trang slide và tường thuật âm thanh dưới dạng tệp ZIP. Công việc phải được hoàn thành và đã tạo tường thuật.

• Đối số:
  • jobId (chuỗi, bắt buộc) — UUID của một công việc có tường thuật đã 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" }
  

---

Các Quy trình Làm việc Điển hình

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

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

Nano Banana (các slide được thiết kế tùy chỉnh):

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

Nano Banana với tường thuật:

1. slides_create_like_this hoặc slides_create_pdf_slides → lấy jobId
2. jobs_get → đợi các slide hoàn thành
3. slides_generate_narration → lấy tường thuật jobId
4. jobs_get → đợi tường thuật hoàn thành
5. slides_download_slides_pages_voices → lấy liên kết tải xuống ZIP

---

Xử lý 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ý MCP của Claude:

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

• Đối với các 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ột 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