So nutzen Sie QoderWake mit 2Slides: MCP für KI-Mitarbeiter (2026)

Kurzantwort (≤ 60 Wörter): Finden Sie die ID Ihres Wakers mit qoderwake waker list --json und führen Sie dann qoderwake mcp add --waker-id ag_xxx --name 2slides --transport http --http-url https://2slides.com/api/mcp --header "Authorization=Bearer YOUR_2SLIDES_API_KEY" aus. Dieser Waker kann anschließend 2Slides-Themes durchsuchen und bei Bedarf eine editierbare .pptx erstellen – direkt über DingTalk, Feishu oder nach Zeitplan.

QoderWake vom Qoder-Team bei Alibaba bezeichnet sein Produkt als „Autonome KI-Mitarbeiter im Einsatz“. Jeder digitale Mitarbeiter wird als Waker bezeichnet. Ein Waker wird durch IM-Nachrichten, Zeitpläne, Hook-Ereignisse oder API-Aufrufe ausgelöst und erledigt die Arbeit eigenständig. QoderWake läuft auf macOS 13+, Linux und Windows 10+. Es verfügt über eine lokale Web-Konsole unter 127.0.0.1:19820, eine vollständige CLI und lässt sich mit DingTalk und Feishu verbinden.

MCP-Server und Skills werden pro Waker zugewiesen. Diese Anleitung zeigt, wie Sie einem Waker (beispielsweise Ihrem „Reporting Assistant“) die 2Slides-Präsentations-Engine zur Verfügung stellen. Wir nutzen hierfür die offizielle QoderWake-CLI-Referenz und 2Slides-Endpunkte, die wir am 30. September 2026 live in der Produktion getestet haben.

Warum sollte ein Waker 2Slides nutzen?

• Waker sind für wiederkehrende Aufgaben konzipiert, und „verwandle die Zahlen dieser Woche in ein Deck“ ist genau diese Art von Job.
• 2Slides erstellt die Datei: eine vorlagenbasierte, editierbare PowerPoint (Fast PPT, 10 Credits pro Seite) oder bildgestaltete Folien (Nano Banana, 100 Credits pro Seite bei 1K/2K) mit optionaler KI-Sprachnarration.
• Scope pro Waker bedeutet, dass nur der Waker, der tatsächlich Folien benötigt, das Tool und den Schlüssel erhält.

Was Sie vorab benötigen

1. QoderWake installiert und angemeldet. Unter macOS oder Linux bietet die CLI-Referenz einen One-Line-Installer:

Windows- und macOS-Pakete sind auf der QoderWake-Website verfügbar. Falls die Shell qoderwake nicht findet, nutzen Sie ~/.qoderwake/bin/qoderwake.

1. Einen 2Slides API-Key von 2slides.com/api (sk-2slides-...). Neue Konten erhalten 500 Gratis-Credits, was für 50 Fast-PPT-Seiten reicht.
2. Node.js auf dem Gerät, jedoch nur für die stdio-Methode.

Schritt 1: Waker-ID finden

Waker-IDs beginnen mit ag_. Kopieren Sie die ID des Wakers, der Decks erstellen soll. Die folgenden Beispiele verwenden ag_xxx.

Methode 1: Gehostetes MCP über HTTP (empfohlen)

Hinweis zum Quoting: Die Syntax der CLI lautet --header KEY=VALUE (wiederholbar). Der Wert hier, Bearer YOUR_2SLIDES_API_KEY, enthält ein Leerzeichen. Setzen Sie daher das gesamte KEY=VALUE-Paar in doppelte Anführungszeichen, wie oben gezeigt. Ohne Anführungszeichen teilt die Shell dies in zwei Argumente auf, und der Header kommt lediglich als Bearer an.

Möchten Sie das Parsing von = und Leerzeichen komplett umgehen? Nutzen Sie die JSON-Form derselben Option, --headers <json>:

In der Windows PowerShell funktionieren auch einfache Anführungszeichen, aber das Quoting von JSON über verschiedene Shells hinweg kann knifflig sein. In diesem Fall ist der dateibasierte Import in Methode 2 die sicherere Wahl.

Fallback ohne Header. Falls der Header dennoch nicht ankommt (ein 401-Fehler oder Authentication required beim Aktualisieren der Tools), lassen Sie die Header ganz weg. 2Slides akzeptiert den Key auch als URL-Query-Parameter – diese Form haben wir durchgehend erfolgreich getestet:

Behandeln Sie diese URL wie ein Passwort: Fügen Sie sie nicht in Tasks oder Screenshots ein und rotieren Sie den Key unter 2slides.com/api, falls er bekannt wird.

2Slides verwendet einen einfachen API-Key, kein OAuth. Lassen Sie daher alle --oauth-*-Flags weg.

Methode 2: MCP-JSON importieren

qoderwake mcp add akzeptiert auch --json <json> oder --json-file <path>, um MCP-JSON direkt zu importieren. Speichern Sie dies als 2slides-mcp.json:

Die CLI-Referenz gibt nicht explizit an, welche JSON-Strukturen der Importer akzeptiert. Der obige Block entspricht dem gängigen mcpServers-Format. Falls der Import abgelehnt wird, nutzen Sie die Flags aus Methode 1, die vollständig dokumentiert sind. Löschen Sie die Datei anschließend oder halten Sie sie aus Git-Repositories fern, da sie Ihren Key enthält.

Methode 3: Lokaler stdio-Server

Um das Open-Source-Paket 2slides-mcp auf dem Gerät des Wakers auszuführen:

--args erwartet eine kommagetrennte Liste, analog zum offiziellen Dateisystem-Beispiel in der CLI-Referenz. --env erwartet JSON. Dies erfordert Node.js auf dem Rechner, auf dem der Waker läuft; QoderWake ist standardmäßig gerätegebunden.

Verbindung überprüfen

Entnehmen Sie die <mid> aus mcp list. Senden Sie dem Waker dann einen schreibgeschützten Test. Die Empfehlung von QoderWake lautet, einen neuen Connector zunächst mit einem Read-only-Aufruf zu validieren:

themes_search ist kostenlos, dieser Test verursacht also keine Kosten. Falls ein Connector Probleme bereitet, schaltet qoderwake mcp toggle --waker-id ag_xxx --mcp-id <mid> --enabled false ihn aus, ohne ihn zu löschen.

Methode 4: Den 2Slides-Skill hochladen

QoderWake-Skills sind Git-versionierte Funktionspakete, für die Sie Diffs erstellen und die Sie zurückrollen können. Sie laden „eine Markdown-Datei oder ein Archiv hoch, das SKILL.md enthält“. Der offizielle 2Slides-Skill befindet sich unter github.com/2slides/slides-generation-2slides-skills. Zippen Sie ihn so, dass SKILL.md im Stammverzeichnis des Archivs liegt:

Dadurch wird das ältere .skill-Bundle im Repository ausgelassen. Die Python-Skripte des Skills (Python 3 und requests) lesen den Schlüssel aus der Umgebungsvariablen SLIDES_2SLIDES_API_KEY.

Regel für Geheimnisse. In der Dokumentation von QoderWake heißt es: „Geben Sie niemals Geheimnisse, Token oder Cookies in Aufgaben, Memorys, Wissensdatenbanken, Rollendateien oder Screenshots an.“ Anmeldedaten gehören in geschützte Felder oder Umgebungsvariablen. Fügen Sie Ihren Schlüssel also niemals in einen Aufgaben-Prompt ein und weisen Sie den Waker nicht an, ihn sich zu „merken“. Da QoderWake keinen Weg dokumentiert, Umgebungsvariablen an Skill-Skripte zu übergeben, empfehlen wir diese Aufteilung:

• Nutzen Sie den MCP-Connector (Methode 1) für die eigentlichen API-Aufrufe. Der Schlüssel befindet sich in dessen Header.
• Nutzen Sie den Skill nur, wenn die Variable SLIDES_2SLIDES_API_KEY bereits in der Umgebung gesetzt ist, in der der Waker läuft. Prüfen Sie dies mit einer Testaufgabe, die scripts/search_themes.py --query minimal --limit 1 ausführt.

Erstellen Sie Ihr erstes Deck

Der Waker sollte themes_search aufrufen, dann slides_generate und eine downloadUrl zurückgeben. In unserem Produktionstest wurde ein 3-seitiges Fast-PPT-Deck in etwa 22 Sekunden zurückgegeben. Der Link läuft nach 1 Stunde ab. Laut QoderWake-Dokumentation hängt die Dateibereitstellung „von den Kanalfähigkeiten ab. Verwenden Sie den zurückgegebenen Link oder das Aufgaben-Artefakt“. Lassen Sie den Waker den Link also sofort posten oder die .pptx in seinen Arbeitsbereich herunterladen. Sie können sie dann mit qoderwake session artifacts --session-id sess_xxx aus der Sitzung abrufen.

Anwendungsfälle für einen KI-Mitarbeiter

Ausgelöst durch DingTalk oder Feishu. Sobald ein Waker mit einem DingTalk- oder Feishu-Kanal gekoppelt ist, kann ein Teammitglied eine Nachricht senden: „@Reporting Assistant erstelle ein 6-Folien-Update zum Einstellungsplan für Q4“. Der Waker sammelt den Kontext, ruft 2Slides auf und antwortet mit dem Link.

Ein wöchentliches Deck nach Zeitplan. Die CLI-Referenz dokumentiert geplante Automatisierungen:

Führen Sie dies einmal mit run-now aus und prüfen Sie das Ergebnis mit qoderwake automation detail, bevor Sie es eigenständig laufen lassen.

Die 2Slides MCP-Tools

Bestätigt vs. noch nicht dokumentiert (Stand 30. September 2026)

Fehlerbehebung

• „daemon unreachable“. Führen Sie qoderwake status aus. Wenn der Daemon nicht läuft, qoderwake start. Wenn der Port belegt ist, qoderwake start --port auto.
• 401 von QoderWake selbst. Führen Sie qoderwake whoami aus, und falls nötig erneut qoderwake login.
• 401 von 2Slides. Der Header wurde wahrscheinlich ohne den Schlüssel übertragen. Fügen Sie ihn erneut mit dem in Anführungszeichen gesetzten --header oder der --headers JSON-Form hinzu.
• Tools fehlen. Führen Sie qoderwake mcp refresh-tools aus und prüfen Sie mit mcp toggle ... --enabled true, ob der Connector aktiviert ist.
• stdio schlägt fehl. Prüfen Sie, ob Node.js auf dem Gerät des Wakers installiert ist und ob --args durch Kommas getrennt ist.
• Fehler während eines Durchlaufs. qoderwake log --level error --limit 100 oder qoderwake trace list --status failed.
• Link abgelaufen. downloadUrl ist 1 Stunde lang gültig. Lassen Sie den Waker die Datei als Aufgaben-Artefakt speichern.

Häufig gestellte Fragen

Unterstützt QoderWake benutzerdefinierte MCP-Server?

Ja. Jeder Waker kann mehrere MCP-Server über stdio, HTTP oder SSE einbinden, indem er qoderwake mcp add --waker-id <id> oder den Bildschirm für benutzerdefinierte MCP-Connectoren in der Konsole verwendet.

Wie lautet der genaue Befehl, um 2Slides zu einem Waker hinzuzufügen?

qoderwake mcp add --waker-id ag_xxx --name 2slides --transport http --http-url https://2slides.com/api/mcp --header "Authorization=Bearer YOUR_2SLIDES_API_KEY". Setzen Sie das gesamte Header-Paar in Anführungszeichen, da der Wert ein Leerzeichen enthält.

Wo sollte ich den 2Slides API-Key in QoderWake speichern?

Im Header des MCP-Connectors (--header oder --headers) oder in dessen --env für stdio. Geben Sie ihn niemals in einer Aufgabe, einem Speicher, einer Wissensdatenbank oder einer Rollendatei an. Die Dokumentation von QoderWake untersagt dies ausdrücklich.

Kann ein Waker die PowerPoint an DingTalk oder Feishu senden?

Der Waker kann immer mit dem 2Slides-Download-Link antworten. Ob die Datei selbst angehängt wird, hängt vom jeweiligen Kanal ab. Die QoderWake-Dokumentation empfiehlt, den zurückgegebenen Link oder das Aufgaben-Artefakt zu verwenden. Der Link läuft nach 1 Stunde ab.

Kann ein Waker jede Woche automatisch ein Deck erstellen?

Ja. Erstellen Sie eine geplante Automatisierung mit qoderwake automation create schedule und einem Cron-Ausdruck. Testen Sie diese mit automation run-now, bevor Sie sie unbeaufsichtigt laufen lassen.

Wie hoch sind die Kosten?

Neue 2Slides-Konten erhalten 500 kostenlose Guthaben. Fast PPT kostet 10 Guthaben pro Seite, ein wöchentliches Deck mit 8 Folien entspricht also 80 Guthaben. Vorlagensuche, Job-Abfragen und Exporte sind kostenlos.

Das Wichtigste im Überblick

Ein einziger qoderwake mcp add-Befehl verwandelt einen Waker in einen KI-Mitarbeiter, der fertige Decks liefert. Hinterlegen Sie den Schlüssel im MCP-Header, lösen Sie den Prozess über DingTalk, Feishu oder einen Cron-Zeitplan aus und speichern Sie die .pptx innerhalb einer Stunde.

Verwandte Leitfäden: Persönliche KI-Agenten, die Folien erstellen können, QwenWork mit 2Slides, WorkBuddy mit 2Slides, Jeden KI-Agenten mit dem 2Slides MCP-Server nutzen und Agenten-Skills vs. MCP-Server für Präsentationen.

Holen Sie sich Ihren Schlüssel und Ihre Konfiguration unter 2slides.com/api?tab=mcp.

Quellen:

• QoderWake CLI-Referenz
• QoderWake Skills und Integrationen
• QoderWake Produktseite
• 2Slides API und MCP-Server
• 2Slides Skill auf GitHub
• 2slides-mcp auf GitHub