2slides

2slides MCP Server

เปิดเผยเครื่องมือ 2slides.com สำหรับไคลเอนต์ MCP (เช่น Claude Desktop)

รับ API Key ของคุณ

ก่อนใช้เซิร์ฟเวอร์ MCP นี้ คุณต้องขอรับ API key จาก 2slides.com/api

กำหนดค่าใน Claude Desktop

แก้ไข ~/Library/Application Support/Claude/claude_desktop_config.json และเพิ่ม:

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

จากนั้นรีสตาร์ท Claude Desktop อย่างสมบูรณ์ ในการแชท เปิดแผงเครื่องมือแล้วคุณควรเห็นเครื่องมือด้านล่าง

เครื่องมือที่พร้อมใช้งาน

---

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

สร้างงานนำเสนอ PowerPoint โดยใช้ธีมที่สร้างไว้ล่วงหน้า (Fast PPT) ใช้ themes_search ก่อนเพื่อค้นหา themeId

• อาร์กิวเมนต์:
  • userInput (สตริง, จำเป็น) — เนื้อหางานนำเสนอ
  • themeId (สตริง, จำเป็น) — รหัสธีมจาก themes_search
  • responseLanguage (สตริง, ไม่บังคับ, ค่าเริ่มต้น: Auto) — ภาษาผลลัพธ์; ค่าที่รองรับ: Auto, English, Spanish, Arabic, Portuguese, Indonesian, Japanese, Russian, Hindi, French, German, Greek, Vietnamese, Turkish, Thai, Polish, Italian, Korean, Simplified Chinese, Traditional Chinese
  • mode (ไม่บังคับ, ค่าเริ่มต้น: sync) — sync ส่งคืน downloadUrl ทันที; async ส่งคืน jobId เพื่อโพลด้วย jobs_get
• เครดิต: 1 ต่อหน้า
• ตัวอย่าง:

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

---

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

ค้นหาธีมที่สร้างไว้ล่วงหน้าเพื่อใช้กับ slides_generate

• อาร์กิวเมนต์:
  • query (สตริง, จำเป็น) — คำค้นหา (เช่น business, minimal, dark)
  • limit (ตัวเลข, ไม่บังคับ, ค่าเริ่มต้น: 10, ช่วง: 1–100)
• ส่งคืน: อาร์เรย์ของธีมพร้อม id, name, description, previewUrl, tags
• เครดิต: ฟรี
• ตัวอย่าง:

  { "query": "business", "limit": 5 }
  

---

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

โพลสถานะของงานและดึงผลลัพธ์เมื่อพร้อม

• อาร์กิวเมนต์:
  • jobId (สตริง, จำเป็น)
• ส่งคืน: jobId, status (pending / processing / success / failed), message, downloadUrl (เมื่อสำเร็จ), slidePageCount, createdAt, updatedAt, duration (มิลลิวินาที), jobUrl (เฉพาะงาน Nano Banana)
• เครดิต: ฟรี
• หมายเหตุ: โพลทุก 20 วินาทีจนกว่า status จะเป็น success หรือ failed
• ตัวอย่าง:

  { "jobId": "D8h9VYDGdTlZ6wWSEoctF" }
  

---

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

สร้างสไลด์ (Nano Banana) ที่ตรงกับสไตล์ของรูปภาพอ้างอิง

• อาร์กิวเมนต์:
  • userInput (สตริง, จำเป็น) — เนื้อหางานนำเสนอ
  • referenceImageUrl (สตริง, จำเป็น) — URL ของรูปภาพอ้างอิงสไตล์
  • responseLanguage (สตริง, ไม่บังคับ, ค่าเริ่มต้น: Auto)
  • aspectRatio (สตริง, ไม่บังคับ, ค่าเริ่มต้น: 16:9) — ค่าที่ถูกต้อง: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
  • resolution (สตริง, ไม่บังคับ, ค่าเริ่มต้น: 2K) — 1K, 2K, 4K
  • page (ตัวเลข, ไม่บังคับ, ค่าเริ่มต้น: 0) — 0 = ตรวจจับอัตโนมัติ, 1–100 = จำนวนหน้าที่แน่นอน
  • contentDetail (สตริง, ไม่บังคับ, ค่าเริ่มต้น: standard) — concise หรือ standard
  • mode (สตริง, ไม่บังคับ, ค่าเริ่มต้น: async) — async ส่งคืน jobId; sync ส่งคืน downloadUrl ทันที
• เครดิต: 100 ต่อหน้า (1K/2K) หรือ 200 ต่อหน้า (4K)
• ตัวอย่าง:

  {
    "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)

สร้างสไลด์ที่ออกแบบเอง (Nano Banana) จากเนื้อหาข้อความโดยไม่มีรูปภาพอ้างอิง

• อาร์กิวเมนต์:
  • userInput (สตริง, จำเป็น) — เนื้อหางานนำเสนอ
  • designStyle (สตริง, ไม่บังคับ) — คำอธิบายสไตล์ภาพแบบข้อความอิสระ; เว้นว่างไว้สำหรับสไตล์เริ่มต้น
  • responseLanguage (สตริง, ไม่บังคับ, ค่าเริ่มต้น: Auto)
  • aspectRatio (สตริง, ไม่บังคับ, ค่าเริ่มต้น: 16:9) — ค่าที่ถูกต้อง: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
  • resolution (สตริง, ไม่บังคับ, ค่าเริ่มต้น: 2K) — 1K, 2K, 4K
  • page (ตัวเลข, ไม่บังคับ, ค่าเริ่มต้น: 0) — 0 = ตรวจจับอัตโนมัติ, 1–100 = จำนวนหน้าที่แน่นอน
  • contentDetail (สตริง, ไม่บังคับ, ค่าเริ่มต้น: standard) — concise หรือ standard
  • mode (สตริง, ไม่บังคับ, ค่าเริ่มต้น: async) — async ส่งคืน jobId; sync ส่งคืน downloadUrl ทันที
• เครดิต: 100 ต่อหน้า (1K/2K) หรือ 200 ต่อหน้า (4K)
• ตัวอย่าง:

  {
    "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)

เพิ่มเสียงบรรยาย AI ให้กับงาน Nano Banana ที่เสร็จสมบูรณ์แล้ว (เฉพาะ slides_create_like_this หรือ slides_create_pdf_slides; ไม่รองรับ Fast PPT) แบบอะซิงก์เสมอ — โพลผลลัพธ์ด้วย jobs_get

• อาร์กิวเมนต์ (ผู้พูดคนเดียว, mode: "single" ค่าเริ่มต้น):

  • jobId (สตริง, จำเป็น) — UUID ของงาน Nano Banana ที่เสร็จสมบูรณ์
  • mode (สตริง, ไม่บังคับ, ค่าเริ่มต้น: single) — single หรือ multi
  • speakerName (สตริง, ไม่บังคับ) — ชื่อผู้บรรยาย
  • voice (สตริง, ไม่บังคับ) — หนึ่งใน 30 เสียง (ดูรายการด้านล่าง)
  • contentMode (สตริง, ไม่บังคับ, ค่าเริ่มต้น: standard) — concise หรือ standard
  • includeIntro (บูลีน, ไม่บังคับ, ค่าเริ่มต้น: true)

• อาร์กิวเมนต์ (ผู้พูดสองคน, mode: "multi"):

  • jobId (สตริง, จำเป็น)
  • mode (สตริง, จำเป็น) — multi
  • speaker1Name (สตริง, จำเป็น)
  • speaker2Name (สตริง, จำเป็น)
  • speaker1Voice (สตริง, ไม่บังคับ) — เสียงสำหรับผู้พูด 1
  • speaker2Voice (สตริง, ไม่บังคับ) — เสียงสำหรับผู้พูด 2
  • contentMode (สตริง, ไม่บังคับ, ค่าเริ่มต้น: standard) — concise หรือ standard

• เสียงที่รองรับ (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

• เครดิต: 210 ต่อหน้า (10 ข้อความ + 200 เสียง)

• ตัวอย่าง:

  {
    "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)

ส่งออกหน้าสไลด์และเสียงบรรยายเป็นไฟล์ ZIP งานต้องเสร็จสมบูรณ์และมีการสร้างเสียงบรรยายแล้ว

• อาร์กิวเมนต์:
  • jobId (สตริง, จำเป็น) — UUID ของงานที่มีเสียงบรรยายเสร็จสมบูรณ์
• ส่งคืน: downloadUrl (หมดอายุใน 1 ชั่วโมง), fileName, expiresIn (3600 วินาที)
• เนื้อหา ZIP:

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

• เครดิต: ฟรี
• ตัวอย่าง:

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

---

เวิร์กโฟลว์ทั่วไป

Fast PPT (PowerPoint แบบใช้ธีม):

1. themes_search → รับ themeId
2. slides_generate (ซิงก์) → รับ downloadUrl โดยตรง

Nano Banana (สไลด์ที่ออกแบบเอง):

1. slides_create_like_this หรือ slides_create_pdf_slides (อะซิงก์) → รับ jobId
2. jobs_get (โพลทุก 20 วินาที) → รับ downloadUrl เมื่อ status: "success"

Nano Banana พร้อมเสียงบรรยาย:

1. slides_create_like_this หรือ slides_create_pdf_slides → รับ jobId
2. jobs_get → รอให้สไลด์เสร็จสมบูรณ์
3. slides_generate_narration → รับ jobId เสียงบรรยาย
4. jobs_get → รอให้เสียงบรรยายเสร็จสมบูรณ์
5. slides_download_pages_voices → รับลิงก์ดาวน์โหลด ZIP

---

การแก้ไขปัญหา (Claude Desktop)

• หากเครื่องมือไม่ปรากฏใน Claude ให้ตรวจสอบว่าพาธการกำหนดค่าเป็นแบบสัมบูรณ์และรีสตาร์ทแอป
• ตรวจสอบบันทึก Claude MCP:

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

• สำหรับเซิร์ฟเวอร์ MCP แบบ stdio หลีกเลี่ยงการบันทึกไปยัง stdout; เซิร์ฟเวอร์นี้บันทึกเฉพาะข้อผิดพลาดไปยัง stderr

ข้อมูลอ้างอิง

• สร้างเซิร์ฟเวอร์ MCP (เอกสารอย่างเป็นทางการ): https://modelcontextprotocol.io/docs/develop/build-server
• เอกสาร 2slides API: https://2slides.com/api
• 2slides: https://2slides.com
• เทมเพลต 2slides: https://2slides.com/templates