2slides

2slides MCP Server

เปิดเผยเครื่องมือ 2slides.com ให้กับ MCP clients: สร้างชุดงานนำเสนอ PowerPoint และสไลด์ที่ออกแบบเอง เพิ่มเสียงบรรยายด้วย AI และรับไฟล์ที่เสร็จสมบูรณ์กลับมาเป็น ลิงก์ดาวน์โหลด

รับ API Key ของคุณ

ก่อนเชื่อมต่อ รับ API key จาก 2slides.com/api

เชื่อมต่อ

2slides ให้บริการ Streamable HTTP MCP endpoint และยังมาพร้อมกับแพ็คเกจ stdio นี้ด้วย ทั้งสองเปิดเผยเครื่องมือ 7 อย่างเดียวกันกับบัญชีเดียวกันและเครดิตเดียวกัน

	Streamable HTTP	stdio (แพ็คเกจนี้)
การตั้งค่า	คำสั่งเดียว ไม่ต้องติดตั้งอะไร	ต้องใช้ Node.js 18+, npx ดึงแพ็คเกจ
อัปเดต	ฝั่งเซิร์ฟเวอร์ อัปเดตเสมอ	ดาวน์โหลดใหม่บนเครื่องของคุณ
ทำงานใน	MCP client ที่รองรับระยะไกล	client ใดก็ได้ที่สามารถเรียกใช้กระบวนการในเครื่อง

ตัวเลือก 1 — Streamable HTTP (แนะนำ)

เอกสาร MCP ของ Anthropic เรียก HTTP ว่า "ตัวเลือกที่แนะนำสำหรับการเชื่อมต่อกับ MCP servers ระยะไกล" และ 2slides เป็นบริการโฮสต์ที่ไม่มีไฟล์หรือกระบวนการในเครื่องให้เข้าถึง ดังนั้นเริ่มที่นี่

Claude Code

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

ตรวจสอบด้วย claude mcp list — เซิร์ฟเวอร์ควรรายงาน ✔ Connected

การกำหนดค่าโปรเจกต์ (.mcp.json, แชร์กับทีมของคุณ)

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

Claude Desktop / claude.ai: เพิ่มเป็นตัวเชื่อมต่อแบบกำหนดเองที่ claude.ai/customize/connectors ด้วย URL เดียวกัน

ตัวเลือก 2 — stdio (กระบวนการในเครื่อง)

ใช้ตัวเลือกนี้เมื่อ client สามารถเรียกใช้กระบวนการในเครื่องเท่านั้น เมื่อเครื่องไม่มีเส้นทางตรง ไปยัง 2slides.com หรือเมื่อคุณต้องการกำหนดและแก้ไขเซิร์ฟเวอร์ด้วยตัวเอง

Claude Code

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

Claude Desktop — แก้ไข ~/Library/Application Support/Claude/claude_desktop_config.json (%APPDATA%\Claude\claude_desktop_config.json บน Windows):

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

แฟล็ก -y ให้ npx ติดตั้งแพ็คเกจโดยไม่ต้องถาม รีสตาร์ท Claude Desktop ทั้งหมดหลังจากนั้น ในแชท เปิดแผงเครื่องมือแล้วคุณควรเห็นเครื่องมือด้านล่าง

เครื่องมือที่มี

---

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

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

• อาร์กิวเมนต์:
  • userInput (สตริง, จำเป็น) — เนื้อหางานนำเสนอ
  • themeId (สตริง, จำเป็น) — ID ธีมจาก 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 (ms), 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 ไม่รองรับ) เป็น async เสมอ — สอบถามผลลัพธ์ด้วย 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_slides_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 (async) → รับ 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_slides_pages_voices → รับลิงก์ดาวน์โหลด ZIP

---

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

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

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

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

เอกสารอ้างอิง

• สร้าง MCP server (เอกสารทางการ): https://modelcontextprotocol.io/docs/develop/build-server
• เอกสาร API ของ 2slides: https://2slides.com/api
• 2slides: https://2slides.com
• เทมเพลต 2slides: https://2slides.com/templates