2slides

Server MCP 2slides

Ekspos alat 2slides.com ke klien MCP: buat deck PowerPoint dan slide dengan desain kustom, tambahkan narasi suara AI, dan dapatkan file jadi sebagai tautan unduhan.

Dapatkan Kunci API Anda

Sebelum terhubung, dapatkan kunci API dari 2slides.com/api.

Terhubung

2slides menjalankan endpoint MCP Streamable HTTP yang di-hosting, dan juga menyediakan paket stdio ini. Keduanya mengekspos 7 alat yang sama terhadap akun dan kredit yang sama.

	Streamable HTTP	stdio (paket ini)
Pengaturan	satu perintah, tidak perlu instalasi	membutuhkan Node.js 18+, npx mengambil paket
Pembaruan	sisi server, selalu terbaru	diunduh ulang di mesin Anda
Berjalan di	klien MCP apa pun yang mendukung jarak jauh	klien apa pun yang dapat menjalankan proses lokal

Opsi 1 — Streamable HTTP (disarankan)

Dokumentasi MCP Anthropic menyebut HTTP sebagai "opsi yang disarankan untuk terhubung ke server MCP jarak jauh", dan 2slides adalah layanan yang di-hosting tanpa file atau proses lokal yang perlu diakses, jadi mulailah dari sini.

Claude Code

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

Verifikasi dengan claude mcp list — server seharusnya melaporkan ✔ Connected.

Konfigurasi proyek (.mcp.json, dibagikan dengan tim Anda)

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

Claude Desktop / claude.ai: tambahkan sebagai konektor kustom di claude.ai/customize/connectors dengan URL yang sama.

Opsi 2 — stdio (proses lokal)

Gunakan ini ketika klien hanya dapat menjalankan proses lokal, ketika mesin tidak memiliki rute langsung ke 2slides.com, atau ketika Anda ingin memasang dan menambal server sendiri.

Claude Code

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

Claude Desktop — edit ~/Library/Application Support/Claude/claude_desktop_config.json (%APPDATA%\Claude\claude_desktop_config.json di Windows):

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

Bendera -y memungkinkan npx menginstal paket tanpa diminta. Mulai ulang Claude Desktop sepenuhnya setelahnya; dalam obrolan, buka panel alat dan Anda akan melihat alat-alat di bawah.

Alat yang Tersedia

---

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

Buat presentasi PowerPoint menggunakan tema yang sudah dibuat sebelumnya (Fast PPT). Gunakan themes_search terlebih dahulu untuk menemukan themeId.

• Argumen:
  • userInput (string, wajib) — konten presentasi
  • themeId (string, wajib) — ID tema dari themes_search
  • responseLanguage (string, opsional, default: Auto) — bahasa keluaran; nilai yang didukung: Auto, English, Spanish, Arabic, Portuguese, Indonesian, Japanese, Russian, Hindi, French, German, Greek, Vietnamese, Turkish, Thai, Polish, Italian, Korean, Simplified Chinese, Traditional Chinese
  • mode (opsional, default: sync) — sync mengembalikan downloadUrl segera; async mengembalikan jobId untuk dipoll dengan jobs_get
• Kredit: 1 per halaman
• Contoh:

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

---

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

Cari tema yang sudah dibuat sebelumnya untuk digunakan dengan slides_generate.

• Argumen:
  • query (string, wajib) — kata kunci pencarian (mis. business, minimal, dark)
  • limit (angka, opsional, default: 10, rentang: 1–100)
• Mengembalikan: array tema dengan id, name, description, previewUrl, tags
• Kredit: gratis
• Contoh:

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

---

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

Poll status pekerjaan dan ambil hasilnya saat sudah siap.

• Argumen:
  • jobId (string, wajib)
• Mengembalikan: jobId, status (pending / processing / success / failed), message, downloadUrl (saat berhasil), slidePageCount, createdAt, updatedAt, duration (ms), jobUrl (khusus pekerjaan Nano Banana)
• Kredit: gratis
• Catatan: Poll setiap 20 detik hingga status adalah success atau failed.
• Contoh:

  { "jobId": "D8h9VYDGdTlZ6wWSEoctF" }
  

---

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

Buat slide (Nano Banana) yang sesuai dengan gaya gambar referensi.

• Argumen:
  • userInput (string, wajib) — konten presentasi
  • referenceImageUrl (string, wajib) — URL gambar referensi gaya
  • responseLanguage (string, opsional, default: Auto)
  • aspectRatio (string, opsional, default: 16:9) — nilai valid: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
  • resolution (string, opsional, default: 2K) — 1K, 2K, 4K
  • page (angka, opsional, default: 0) — 0 = deteksi otomatis, 1–100 = jumlah halaman pasti
  • contentDetail (string, opsional, default: standard) — concise atau standard
  • mode (string, opsional, default: async) — async mengembalikan jobId; sync mengembalikan downloadUrl segera
• Kredit: 100 per halaman (1K/2K) atau 200 per halaman (4K)
• Contoh:

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

Buat slide dengan desain kustom (Nano Banana) dari konten teks tanpa gambar referensi.

• Argumen:
  • userInput (string, wajib) — konten presentasi
  • designStyle (string, opsional) — deskripsi teks bebas tentang gaya visual; biarkan kosong untuk gaya default
  • responseLanguage (string, opsional, default: Auto)
  • aspectRatio (string, opsional, default: 16:9) — nilai valid: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
  • resolution (string, opsional, default: 2K) — 1K, 2K, 4K
  • page (angka, opsional, default: 0) — 0 = deteksi otomatis, 1–100 = jumlah halaman pasti
  • contentDetail (string, opsional, default: standard) — concise atau standard
  • mode (string, opsional, default: async) — async mengembalikan jobId; sync mengembalikan downloadUrl segera
• Kredit: 100 per halaman (1K/2K) atau 200 per halaman (4K)
• Contoh:

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

Tambahkan narasi suara AI ke pekerjaan Nano Banana yang selesai (khusus slides_create_like_this atau slides_create_pdf_slides; Fast PPT tidak didukung). Selalu asinkron — poll hasilnya dengan jobs_get.

• Argumen (satu pembicara, default mode: "single"):

  • jobId (string, wajib) — UUID pekerjaan Nano Banana yang selesai
  • mode (string, opsional, default: single) — single atau multi
  • speakerName (string, opsional) — nama narator
  • voice (string, opsional) — salah satu dari 30 suara (lihat daftar di bawah)
  • contentMode (string, opsional, default: standard) — concise atau standard
  • includeIntro (boolean, opsional, default: true)

• Argumen (dua pembicara, mode: "multi"):

  • jobId (string, wajib)
  • mode (string, wajib) — multi
  • speaker1Name (string, wajib)
  • speaker2Name (string, wajib)
  • speaker1Voice (string, opsional) — suara untuk pembicara 1
  • speaker2Voice (string, opsional) — suara untuk pembicara 2
  • contentMode (string, opsional, default: standard) — concise atau standard

• Suara yang didukung (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

• Kredit: 210 per halaman (10 teks + 200 audio)

• Contoh:

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

Ekspor halaman slide dan narasi audio sebagai file ZIP. Pekerjaan harus selesai dan memiliki narasi yang dibuat.

• Argumen:
  • jobId (string, wajib) — UUID pekerjaan dengan narasi yang selesai
• Mengembalikan: downloadUrl (kedaluwarsa dalam 1 jam), fileName, expiresIn (3600 detik)
• Isi ZIP:

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

• Kredit: gratis
• Contoh:

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

---

Alur Kerja Umum

Fast PPT (PowerPoint berbasis tema):

1. themes_search → dapatkan themeId
2. slides_generate (sinkron) → dapatkan downloadUrl secara langsung

Nano Banana (slide dengan desain kustom):

1. slides_create_like_this atau slides_create_pdf_slides (asinkron) → dapatkan jobId
2. jobs_get (poll setiap 20 detik) → dapatkan downloadUrl saat status: "success"

Nano Banana dengan narasi:

1. slides_create_like_this atau slides_create_pdf_slides → dapatkan jobId
2. jobs_get → tunggu slide selesai
3. slides_generate_narration → dapatkan narasi jobId
4. jobs_get → tunggu narasi selesai
5. slides_download_slides_pages_voices → dapatkan tautan unduhan ZIP

---

Pemecahan Masalah (Claude Desktop)

• Jika alat tidak muncul di Claude, verifikasi jalur konfigurasi absolut dan mulai ulang aplikasi.
• Periksa log MCP Claude:

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

• Untuk server MCP stdio, hindari logging ke stdout; server ini hanya mencatat kesalahan ke stderr.

Referensi

• Membangun server MCP (dokumentasi resmi): https://modelcontextprotocol.io/docs/develop/build-server
• Dokumentasi API 2slides: https://2slides.com/api
• 2slides: https://2slides.com
• Template 2slides: https://2slides.com/templates