2slides

2slides MCP Sunucusu

2slides.com araçlarını MCP istemcilerine sunun: PowerPoint sunumları ve özel tasarlanmış slaytlar oluşturun, yapay zeka sesli anlatım ekleyin ve bitmiş dosyaları indirme bağlantıları olarak geri alın.

API Anahtarınızı Alın

Bağlanmadan önce, 2slides.com/api adresinden bir API anahtarı edinin.

Bağlanma

2slides, barındırılan bir Streamable HTTP MCP uç noktası çalıştırır ve ayrıca bu stdio paketini de sunar. Her ikisi de aynı hesaba ve aynı kredilere karşı aynı 7 aracı kullanıma sunar.

	Streamable HTTP	stdio (bu paket)
Kurulum	tek komut, kurulum gerektirmez	Node.js 18+ gerektirir, npx paketi getirir
Güncellemeler	sunucu tarafında, her zaman güncel	makinenizde yeniden indirilir
Çalıştığı yer	uzaktan bağlantı destekleyen herhangi bir MCP istemcisi	yerel bir süreç başlatabilen herhangi bir istemci

Seçenek 1 — Streamable HTTP (önerilir)

Anthropic'in MCP belgeleri HTTP'yi "uzak MCP sunucularına bağlanmak için önerilen seçenek" olarak adlandırır ve 2slides, erişilecek yerel dosyaları veya süreçleri olmayan barındırılan bir hizmettir, bu yüzden buradan başlayın.

Claude Code

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

claude mcp list ile doğrulayın — sunucu ✔ Connected bildirmelidir.

Proje yapılandırması (.mcp.json, ekibinizle paylaşılır)

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

Claude Desktop / claude.ai: aynı URL ile claude.ai/customize/connectors adresinde özel bir bağlayıcı olarak ekleyin.

Seçenek 2 — stdio (yerel süreç)

İstemci yalnızca yerel süreçler başlatabildiğinde, makinenin 2slides.com'a doğrudan bir yolu olmadığında veya sunucuyu kendiniz sabitlemek ve yamamak istediğinizde bunu kullanın.

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 dosyasını düzenleyin (Windows'ta %APPDATA%\Claude\claude_desktop_config.json):

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

-y bayrağı, npx'in paketi sormadan yüklemesini sağlar. Sonrasında Claude Desktop'u tamamen yeniden başlatın; bir sohbette araçlar panelini açın ve aşağıdaki araçları görmelisiniz.

Kullanılabilir Araçlar

---

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

Önceden oluşturulmuş bir tema kullanarak bir PowerPoint sunumu oluşturun (Hızlı PPT). Bir themeId bulmak için önce themes_search kullanın.

• Argümanlar:
  • userInput (dize, zorunlu) — sunum içeriği
  • themeId (dize, zorunlu) — themes_search adresinden tema kimliği
  • responseLanguage (dize, isteğe bağlı, varsayılan: Auto) — çıktı dili; desteklenen değerler: Auto, English, Spanish, Arabic, Portuguese, Indonesian, Japanese, Russian, Hindi, French, German, Greek, Vietnamese, Turkish, Thai, Polish, Italian, Korean, Simplified Chinese, Traditional Chinese
  • mode (isteğe bağlı, varsayılan: sync) — sync hemen downloadUrl döndürür; async jobs_get ile yoklanacak bir jobId döndürür
• Krediler: sayfa başına 1
• Örnek:

  {
    "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 ile kullanmak için önceden oluşturulmuş temaları arayın.

• Argümanlar:
  • query (dize, zorunlu) — arama anahtar kelimesi (örn. business, minimal, dark)
  • limit (sayı, isteğe bağlı, varsayılan: 10, aralık: 1–100)
• Döndürür: id, name, description, previewUrl, tags içeren temalar dizisi
• Krediler: ücretsiz
• Örnek:

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

---

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

Bir işin durumunu yoklayın ve hazır olduğunda sonucu alın.

• Argümanlar:
  • jobId (dize, zorunlu)
• Döndürür: jobId, status (pending / processing / success / failed), message, downloadUrl (başarılı olduğunda), slidePageCount, createdAt, updatedAt, duration (ms), jobUrl (yalnızca Nano Banana işleri)
• Krediler: ücretsiz
• Not: status success veya failed olana kadar her 20 saniyede bir yoklayın.
• Örnek:

  { "jobId": "D8h9VYDGdTlZ6wWSEoctF" }
  

---

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

Bir referans görselinin stilini eşleştiren slaytlar (Nano Banana) oluşturun.

• Argümanlar:
  • userInput (dize, zorunlu) — sunum içeriği
  • referenceImageUrl (dize, zorunlu) — stil referans görselinin URL'si
  • responseLanguage (dize, isteğe bağlı, varsayılan: Auto)
  • aspectRatio (dize, isteğe bağlı, varsayılan: 16:9) — geçerli değerler: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
  • resolution (dize, isteğe bağlı, varsayılan: 2K) — 1K, 2K, 4K
  • page (sayı, isteğe bağlı, varsayılan: 0) — 0 = otomatik algılama, 1–100 = tam sayfa sayısı
  • contentDetail (dize, isteğe bağlı, varsayılan: standard) — concise veya standard
  • mode (dize, isteğe bağlı, varsayılan: async) — async jobId döndürür; sync hemen downloadUrl döndürür
• Krediler: sayfa başına 100 (1K/2K) veya sayfa başına 200 (4K)
• Örnek:

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

Referans görseli olmadan metin içeriğinden özel tasarlanmış slaytlar (Nano Banana) oluşturun.

• Argümanlar:
  • userInput (dize, zorunlu) — sunum içeriği
  • designStyle (dize, isteğe bağlı) — görsel stilin serbest metin açıklaması; varsayılan stil için boş bırakın
  • responseLanguage (dize, isteğe bağlı, varsayılan: Auto)
  • aspectRatio (dize, isteğe bağlı, varsayılan: 16:9) — geçerli değerler: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
  • resolution (dize, isteğe bağlı, varsayılan: 2K) — 1K, 2K, 4K
  • page (sayı, isteğe bağlı, varsayılan: 0) — 0 = otomatik algılama, 1–100 = tam sayfa sayısı
  • contentDetail (dize, isteğe bağlı, varsayılan: standard) — concise veya standard
  • mode (dize, isteğe bağlı, varsayılan: async) — async jobId döndürür; sync hemen downloadUrl döndürür
• Krediler: sayfa başına 100 (1K/2K) veya sayfa başına 200 (4K)
• Örnek:

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

Tamamlanmış bir Nano Banana işine (yalnızca slides_create_like_this veya slides_create_pdf_slides; Hızlı PPT desteklenmez) yapay zeka sesli anlatım ekleyin. Her zaman eşzamansız — sonucu jobs_get ile yoklayın.

• Argümanlar (tek konuşmacı, mode: "single" varsayılanı):

  • jobId (dize, zorunlu) — tamamlanmış bir Nano Banana işinin UUID'si
  • mode (dize, isteğe bağlı, varsayılan: single) — single veya multi
  • speakerName (dize, isteğe bağlı) — anlatıcı adı
  • voice (dize, isteğe bağlı) — 30 sesten biri (aşağıdaki listeye bakın)
  • contentMode (dize, isteğe bağlı, varsayılan: standard) — concise veya standard
  • includeIntro (boolean, isteğe bağlı, varsayılan: true)

• Argümanlar (iki konuşmacı, mode: "multi"):

  • jobId (dize, zorunlu)
  • mode (dize, zorunlu) — multi
  • speaker1Name (dize, zorunlu)
  • speaker2Name (dize, zorunlu)
  • speaker1Voice (dize, isteğe bağlı) — konuşmacı 1 için ses
  • speaker2Voice (dize, isteğe bağlı) — konuşmacı 2 için ses
  • contentMode (dize, isteğe bağlı, varsayılan: standard) — concise veya standard

• Desteklenen sesler (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

• Krediler: sayfa başına 210 (10 metin + 200 ses)

• Örnek:

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

Slayt sayfalarını ve sesli anlatımı bir ZIP dosyası olarak dışa aktarın. İş tamamlanmış ve anlatım oluşturulmuş olmalıdır.

• Argümanlar:
  • jobId (dize, zorunlu) — anlatımı tamamlanmış bir işin UUID'si
• Döndürür: downloadUrl (1 saat içinde sona erer), fileName, expiresIn (3600 saniye)
• ZIP içeriği:

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

• Krediler: ücretsiz
• Örnek:

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

---

Tipik İş Akışları

Hızlı PPT (tema tabanlı PowerPoint):

1. themes_search → bir themeId alın
2. slides_generate (eşzamanlı) → downloadUrl doğrudan alın

Nano Banana (özel tasarlanmış slaytlar):

1. slides_create_like_this veya slides_create_pdf_slides (eşzamansız) → jobId alın
2. jobs_get (her 20 saniyede bir yoklayın) → status: "success" olduğunda downloadUrl alın

Anlatımlı Nano Banana:

1. slides_create_like_this veya slides_create_pdf_slides → jobId alın
2. jobs_get → slaytların tamamlanmasını bekleyin
3. slides_generate_narration → anlatım jobId alın
4. jobs_get → anlatımın tamamlanmasını bekleyin
5. slides_download_slides_pages_voices → ZIP indirme bağlantısını alın

---

Sorun Giderme (Claude Desktop)

• Araçlar Claude'da görünmüyorsa, yapılandırma yolunun mutlak olduğunu doğrulayın ve uygulamayı yeniden başlatın.
• Claude MCP günlüklerini kontrol edin:

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

• stdio MCP sunucuları için stdout'a günlük kaydı yapmaktan kaçının; bu sunucu yalnızca hataları stderr'e kaydeder.

Referanslar

• Bir MCP sunucusu oluşturun (resmi belgeler): https://modelcontextprotocol.io/docs/develop/build-server
• 2slides API belgeleri: https://2slides.com/api
• 2slides: https://2slides.com
• 2slides Şablonları: https://2slides.com/templates