2slides

2slides MCP-Server

Stellen Sie 2slides.com-Tools für MCP-Clients bereit: Erstellen Sie PowerPoint-Präsentationen und individuell gestaltete Folien, fügen Sie KI-Sprachvertonung hinzu und erhalten Sie die fertigen Dateien als Download-Links zurück.

API-Schlüssel abrufen

Bevor Sie eine Verbindung herstellen, holen Sie sich einen API-Schlüssel von 2slides.com/api.

Verbinden

2slides betreibt einen gehosteten Streamable HTTP-MCP-Endpunkt und liefert außerdem dieses stdio-Paket. Beide bieten dieselben 7 Tools für dasselbe Konto und dieselben Credits.

	Streamable HTTP	stdio (dieses Paket)
Einrichtung	ein Befehl, nichts zu installieren	benötigt Node.js 18+, npx lädt das Paket
Updates	serverseitig, immer aktuell	wird auf Ihrem Rechner neu heruntergeladen
Läuft in	jedem Remote-fähigen MCP-Client	jedem Client, der einen lokalen Prozess starten kann

Option 1 — Streamable HTTP (empfohlen)

Die MCP-Dokumentation von Anthropic bezeichnet HTTP als „die empfohlene Option für die Verbindung mit Remote-MCP-Servern", und 2slides ist ein gehosteter Dienst ohne lokale Dateien oder Prozesse, daher beginnen Sie hier.

Claude Code

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

Überprüfen Sie mit claude mcp list — der Server sollte ✔ Connected melden.

Projektkonfiguration (.mcp.json, mit Ihrem Team geteilt)

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

Claude Desktop / claude.ai: Fügen Sie es als benutzerdefinierten Connector unter claude.ai/customize/connectors mit derselben URL hinzu.

Option 2 — stdio (lokaler Prozess)

Verwenden Sie diese Option, wenn der Client nur lokale Prozesse starten kann, wenn der Rechner keine direkte Verbindung zu 2slides.com hat oder wenn Sie den Server selbst festlegen und patchen möchten.

Claude Code

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

Claude Desktop — bearbeiten Sie ~/Library/Application Support/Claude/claude_desktop_config.json (%APPDATA%\Claude\claude_desktop_config.json unter Windows):

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

Das -y-Flag ermöglicht es npx, das Paket ohne Rückfrage zu installieren. Starten Sie Claude Desktop danach vollständig neu; öffnen Sie in einem Chat das Tools-Panel und Sie sollten die folgenden Tools sehen.

Verfügbare Tools

---

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

Erstellen Sie eine PowerPoint-Präsentation mit einem vorgefertigten Design (Fast PPT). Verwenden Sie zuerst themes_search, um eine themeId zu finden.

• Argumente:
  • userInput (Zeichenkette, erforderlich) — Präsentationsinhalt
  • themeId (Zeichenkette, erforderlich) — Design-ID von themes_search
  • responseLanguage (Zeichenkette, optional, Standard: Auto) — Ausgabesprache; unterstützte Werte: Auto, English, Spanish, Arabic, Portuguese, Indonesian, Japanese, Russian, Hindi, French, German, Greek, Vietnamese, Turkish, Thai, Polish, Italian, Korean, Simplified Chinese, Traditional Chinese
  • mode (optional, Standard: sync) — sync gibt downloadUrl sofort zurück; async gibt eine jobId zurück, die mit jobs_get abgefragt wird
• Credits: 1 pro Seite
• Beispiel:

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

---

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

Durchsuchen Sie vorgefertigte Designs zur Verwendung mit slides_generate.

• Argumente:
  • query (Zeichenkette, erforderlich) — Suchbegriff (z. B. business, minimal, dark)
  • limit (Zahl, optional, Standard: 10, Bereich: 1–100)
• Rückgabe: Array von Designs mit id, name, description, previewUrl, tags
• Credits: kostenlos
• Beispiel:

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

---

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

Fragen Sie den Status eines Auftrags ab und rufen Sie das Ergebnis ab, wenn es bereit ist.

• Argumente:
  • jobId (Zeichenkette, erforderlich)
• Rückgabe: jobId, status (pending / processing / success / failed), message, downloadUrl (bei Erfolg), slidePageCount, createdAt, updatedAt, duration (ms), jobUrl (nur Nano-Banana-Aufträge)
• Credits: kostenlos
• Hinweis: Fragen Sie alle 20 Sekunden ab, bis status success oder failed ist.
• Beispiel:

  { "jobId": "D8h9VYDGdTlZ6wWSEoctF" }
  

---

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

Erstellen Sie Folien (Nano Banana), die dem Stil eines Referenzbildes entsprechen.

• Argumente:
  • userInput (Zeichenkette, erforderlich) — Präsentationsinhalt
  • referenceImageUrl (Zeichenkette, erforderlich) — URL des Stil-Referenzbildes
  • responseLanguage (Zeichenkette, optional, Standard: Auto)
  • aspectRatio (Zeichenkette, optional, Standard: 16:9) — gültige Werte: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
  • resolution (Zeichenkette, optional, Standard: 2K) — 1K, 2K, 4K
  • page (Zahl, optional, Standard: 0) — 0 = automatische Erkennung, 1–100 = exakte Seitenanzahl
  • contentDetail (Zeichenkette, optional, Standard: standard) — concise oder standard
  • mode (Zeichenkette, optional, Standard: async) — async gibt jobId zurück; sync gibt downloadUrl sofort zurück
• Credits: 100 pro Seite (1K/2K) oder 200 pro Seite (4K)
• Beispiel:

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

Erstellen Sie individuell gestaltete Folien (Nano Banana) aus Textinhalten ohne Referenzbild.

• Argumente:
  • userInput (Zeichenkette, erforderlich) — Präsentationsinhalt
  • designStyle (Zeichenkette, optional) — Freitextbeschreibung des visuellen Stils; für Standardgestaltung leer lassen
  • responseLanguage (Zeichenkette, optional, Standard: Auto)
  • aspectRatio (Zeichenkette, optional, Standard: 16:9) — gültige Werte: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
  • resolution (Zeichenkette, optional, Standard: 2K) — 1K, 2K, 4K
  • page (Zahl, optional, Standard: 0) — 0 = automatische Erkennung, 1–100 = exakte Seitenanzahl
  • contentDetail (Zeichenkette, optional, Standard: standard) — concise oder standard
  • mode (Zeichenkette, optional, Standard: async) — async gibt jobId zurück; sync gibt downloadUrl sofort zurück
• Credits: 100 pro Seite (1K/2K) oder 200 pro Seite (4K)
• Beispiel:

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

Fügen Sie einem abgeschlossenen Nano-Banana-Auftrag KI-Sprachvertonung hinzu (nur slides_create_like_this oder slides_create_pdf_slides; Fast PPT wird nicht unterstützt). Immer asynchron — fragen Sie das Ergebnis mit jobs_get ab.

• Argumente (ein Sprecher, mode: "single" Standard):

  • jobId (Zeichenkette, erforderlich) — UUID eines abgeschlossenen Nano-Banana-Auftrags
  • mode (Zeichenkette, optional, Standard: single) — single oder multi
  • speakerName (Zeichenkette, optional) — Name des Sprechers
  • voice (Zeichenkette, optional) — eine von 30 Stimmen (siehe Liste unten)
  • contentMode (Zeichenkette, optional, Standard: standard) — concise oder standard
  • includeIntro (boolesch, optional, Standard: true)

• Argumente (zwei Sprecher, mode: "multi"):

  • jobId (Zeichenkette, erforderlich)
  • mode (Zeichenkette, erforderlich) — multi
  • speaker1Name (Zeichenkette, erforderlich)
  • speaker2Name (Zeichenkette, erforderlich)
  • speaker1Voice (Zeichenkette, optional) — Stimme für Sprecher 1
  • speaker2Voice (Zeichenkette, optional) — Stimme für Sprecher 2
  • contentMode (Zeichenkette, optional, Standard: standard) — concise oder standard

• Unterstützte Stimmen (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

• Credits: 210 pro Seite (10 Text + 200 Audio)

• Beispiel:

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

Exportieren Sie Folienseiten und Audio-Vertonung als ZIP-Datei. Der Auftrag muss abgeschlossen sein und eine Vertonung erzeugt haben.

• Argumente:
  • jobId (Zeichenkette, erforderlich) — UUID eines Auftrags mit abgeschlossener Vertonung
• Rückgabe: downloadUrl (läuft in 1 Stunde ab), fileName, expiresIn (3600 Sekunden)
• ZIP-Inhalt:

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

• Credits: kostenlos
• Beispiel:

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

---

Typische Arbeitsabläufe

Fast PPT (designbasierte PowerPoint):

1. themes_search → eine themeId erhalten
2. slides_generate (synchron) → downloadUrl direkt erhalten

Nano Banana (individuell gestaltete Folien):

1. slides_create_like_this oder slides_create_pdf_slides (asynchron) → jobId erhalten
2. jobs_get (alle 20 s abfragen) → downloadUrl erhalten, wenn status: "success"

Nano Banana mit Vertonung:

1. slides_create_like_this oder slides_create_pdf_slides → jobId erhalten
2. jobs_get → warten, bis die Folien abgeschlossen sind
3. slides_generate_narration → Vertonung jobId erhalten
4. jobs_get → warten, bis die Vertonung abgeschlossen ist
5. slides_download_slides_pages_voices → ZIP-Download-Link erhalten

---

Fehlerbehebung (Claude Desktop)

• Wenn Tools in Claude nicht erscheinen, überprüfen Sie, ob der Konfigurationspfad absolut ist, und starten Sie die App neu.
• Überprüfen Sie die Claude-MCP-Protokolle:

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

• Vermeiden Sie bei stdio-MCP-Servern die Protokollierung auf stdout; dieser Server protokolliert nur Fehler auf stderr.

Referenzen

• MCP-Server erstellen (offizielle Dokumentation): https://modelcontextprotocol.io/docs/develop/build-server
• 2slides-API-Dokumentation: https://2slides.com/api
• 2slides: https://2slides.com
• 2slides-Vorlagen: https://2slides.com/templates