2slides

resmi

Bu, dünyadaki 1., en kolay ve en ucuz PPT, slayt, sunum AI üretimi MCP Sunucusudur.

GitHub
31

2slides MCP ile neler yapabilirsiniz?

  • Sunum temalarını arayın — Bir temayı anahtar kelimeyle (örneğin "business", "minimal") bulmak için themes_search kullanın ve slayt oluşturma için themeId'sini alın.
  • Temalı PowerPoint slaytları oluşturun — İçerik ve bir themeId'yi slides_generate'e sağlayın ve indirilmeye hazır bir .pptx dosyası alın.
  • Referans görselle eşleşen slaytlar oluşturun — Görsel stili yansıtan slaytlar üretmek için slides_create_like_this'e bir referans görsel URL'si ve içerik sağlayın.
  • Metinden özel tasarımlı slaytlar oluşturun — Referans görsel olmadan slayt oluşturmak için serbest metin designStyle ile slides_create_pdf_slides kullanın.
  • Slaytlara AI sesli anlatım ekleyin — Tamamlanmış bir Nano Banana slayt işine tek veya çift konuşmacılı anlatım eklemek için slides_generate_narration kullanın.
  • Slaytları ve sesi ZIP olarak dışa aktarın — Anlatımlı bir iş için ayrı ayrı slayt görsellerini, sayfa başına ses dosyalarını ve bir dökümü indirmek için slides_download_pages_voices kullanın.

Dokümantasyon

2slides MCP Sunucusu

2slides

MCP istemcileri (ör. Claude Desktop) için 2slides.com araçlarını kullanıma sunar.

API Anahtarınızı Alın

Bu MCP sunucusunu kullanmadan önce 2slides.com/api adresinden bir API anahtarı edinmeniz gerekir.

Claude Desktop'ta Yapılandırma

~/Library/Application Support/Claude/claude_desktop_config.json dosyasını düzenleyin ve şunu ekleyin:

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

Ardından Claude Desktop'ı tamamen yeniden başlatın. Bir sohbette araçlar panelini açtığınızda aşağıdaki araçları görmelisiniz.

Kullanılabilir Araçlar

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

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

  • Argümanlar:
    • userInput (metin, zorunlu) — sunum içeriği
    • themeId (metin, zorunlu) — themes_search aracından alınan tema kimliği
    • responseLanguage (metin, 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 bir downloadUrl döndürür; async ise jobs_get ile sorgulanacak bir jobId döndürür
  • Kredi: 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 üzere önceden oluşturulmuş temaları arayın.

  • Argümanlar:
    • query (metin, zorunlu) — arama anahtar kelimesi (ör. 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 tema dizisi
  • Kredi: ücretsiz
  • Örnek: 
    { "query": "business", "limit": 5 }

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

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

  • Argümanlar:
    • jobId (metin, 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)
  • Kredi: ücretsiz
  • Not: status değeri success veya failed olana kadar her 20 saniyede bir sorgulayın.
  • Örnek: 
    { "jobId": "D8h9VYDGdTlZ6wWSEoctF" }

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

Bir referans görselin stilini taklit eden slaytlar (Nano Banana) oluşturun.

  • Argümanlar:
    • userInput (metin, zorunlu) — sunum içeriği
    • referenceImageUrl (metin, zorunlu) — stil referans görselinin URL'si
    • responseLanguage (metin, isteğe bağlı, varsayılan: Auto)
    • aspectRatio (metin, 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 (metin, isteğe bağlı, varsayılan: 2K) — 1K, 2K, 4K
    • page (sayı, isteğe bağlı, varsayılan: 0) — 0 = otomatik algıla, 1–100 = tam sayfa sayısı
    • contentDetail (metin, isteğe bağlı, varsayılan: standard) — concise veya standard
    • mode (metin, isteğe bağlı, varsayılan: async) — async bir jobId döndürür; sync hemen bir downloadUrl döndürür
  • Kredi: 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örsel olmadan metin içeriğinden özel tasarım slaytlar (Nano Banana) oluşturun.

  • Argümanlar:
    • userInput (metin, zorunlu) — sunum içeriği
    • designStyle (metin, isteğe bağlı) — görsel stilin serbest metin açıklaması; varsayılan stil için boş bırakın
    • responseLanguage (metin, isteğe bağlı, varsayılan: Auto)
    • aspectRatio (metin, 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 (metin, isteğe bağlı, varsayılan: 2K) — 1K, 2K, 4K
    • page (sayı, isteğe bağlı, varsayılan: 0) — 0 = otomatik algıla, 1–100 = tam sayfa sayısı
    • contentDetail (metin, isteğe bağlı, varsayılan: standard) — concise veya standard
    • mode (metin, isteğe bağlı, varsayılan: async) — async bir jobId döndürür; sync hemen bir downloadUrl döndürür
  • Kredi: 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 sorgulayın.

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

    • jobId (metin, zorunlu) — tamamlanmış bir Nano Banana işinin UUID'si
    • mode (metin, isteğe bağlı, varsayılan: single) — single veya multi
    • speakerName (metin, isteğe bağlı) — anlatıcı adı
    • voice (metin, isteğe bağlı) — 30 sesten biri (aşağıdaki listeye bakın)
    • contentMode (metin, 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 (metin, zorunlu)
    • mode (metin, zorunlu) — multi
    • speaker1Name (metin, zorunlu)
    • speaker2Name (metin, zorunlu)
    • speaker1Voice (metin, isteğe bağlı) — 1. konuşmacı için ses
    • speaker2Voice (metin, isteğe bağlı) — 2. konuşmacı için ses
    • contentMode (metin, 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

  • Kredi: 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_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 (metin, 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
  • Kredi: ü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ı) → doğrudan downloadUrl alın

Nano Banana (özel tasarım slaytlar):

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

Anlatımlı Nano Banana:

  1. slides_create_like_this veya slides_create_pdf_slides → bir 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_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