Comment utiliser QoderWake avec 2Slides : MCP pour les employés IA (2026)

Réponse rapide (≤ 60 mots) : Identifiez l'ID de votre Waker avec qoderwake waker list --json, puis lancez 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". Ce Waker pourra alors rechercher des thèmes 2Slides et générer une présentation .pptx éditable, à la demande (via DingTalk ou Feishu) ou selon un calendrier défini.

QoderWake, développé par l'équipe Qoder d'Alibaba, définit son produit comme des « Employés IA autonomes, en poste ». Chaque employé numérique est appelé un Waker. Un Waker est déclenché par des messages de messagerie instantanée, des planifications, des événements hook ou des appels API, et exécute son travail de manière autonome. QoderWake fonctionne sur macOS 13+, Linux et Windows 10+. Il dispose d'une console web locale sur 127.0.0.1:19820, d'une CLI complète et se connecte à DingTalk et Feishu.

Les serveurs et compétences MCP sont rattachés par Waker. Ce guide explique comment doter un Waker (par exemple, votre « Assistant Reporting ») du moteur de présentation 2Slides. Il s'appuie sur la documentation officielle de la CLI QoderWake et sur les points de terminaison 2Slides testés en production le 30 septembre 2026.

Pourquoi doter un Waker de 2Slides ?

• Les Wakers sont conçus pour les tâches récurrentes, et « transformer les chiffres de la semaine en deck » est précisément ce type de mission.
• 2Slides génère le fichier : un PowerPoint éditable basé sur un thème (Fast PPT, 10 crédits par page) ou des diapositives au design image (Nano Banana, 100 crédits par page en 1K/2K) avec narration IA optionnelle.
• La portée par Waker garantit que seul le Waker ayant besoin de créer des présentations dispose de l'outil et de la clé API.

Prérequis

1. QoderWake installé et connecté. Sur macOS ou Linux, la référence CLI propose un installateur en une ligne :

Les packages pour Windows et macOS sont disponibles sur le site web de QoderWake. Si le shell ne trouve pas qoderwake, utilisez ~/.qoderwake/bin/qoderwake.

1. Une clé API 2Slides obtenue sur 2slides.com/api (sk-2slides-...). Les nouveaux comptes reçoivent 500 crédits gratuits, ce qui couvre 50 pages Fast PPT.
2. Node.js sur l'appareil, uniquement pour la méthode stdio.

Étape 1 : Trouver l'ID du Waker

Les ID de Waker commencent par ag_. Copiez celui du Waker qui doit générer les decks. Les exemples ci-dessous utilisent ag_xxx.

Méthode 1 : MCP hébergé via HTTP (recommandé)

À propos des guillemets. La syntaxe de la CLI est --header KEY=VALUE (répétable). La valeur ici, Bearer YOUR_2SLIDES_API_KEY, contient un espace ; il faut donc entourer toute la paire KEY=VALUE de doubles guillemets comme illustré. Sans guillemets, le shell divise l'expression en deux arguments et le header arrive tronqué à Bearer.

Vous voulez éviter totalement les problèmes d'analyse de = et d'espaces ? Utilisez la forme JSON de la même option, --headers <json> :

Sous Windows PowerShell, les guillemets simples fonctionnent également, mais l'échappement du JSON entre différents shells peut être complexe. Dans ce cas, l'importation par fichier de la Méthode 2 est le choix le plus sûr.

Alternative sans header. Si le header n'est toujours pas transmis (erreur 401 ou Authentication required lors de l'actualisation des outils), ignorez complètement les headers. 2Slides accepte également la clé comme paramètre de requête URL, et nous avons testé cette forme de bout en bout :

Traitez cette URL comme un mot de passe : ne la collez pas dans des tâches ou des captures d'écran, et renouvelez la clé sur 2slides.com/api en cas de fuite.

2Slides utilise une clé API simple, pas OAuth, laissez donc tous les options --oauth-* désactivés.

Méthode 2 : Importer un JSON MCP

qoderwake mcp add accepte également --json <json> ou --json-file <path> pour importer directement un fichier JSON MCP. Enregistrez ceci sous le nom 2slides-mcp.json :

La référence CLI ne précise pas explicitement les structures JSON acceptées par l'importateur. Le bloc ci-dessus correspond au format standard mcpServers. Si l'importation est rejetée, utilisez les drapeaux de la Méthode 1, qui sont entièrement documentés. Supprimez le fichier après coup, ou excluez-le de tout dépôt Git, car il contient votre clé.

Méthode 3 : Serveur stdio local

Pour exécuter le package open-source 2slides-mcp sur l'appareil du Waker :

--args prend une liste séparée par des virgules, sur le même modèle que l'exemple officiel de système de fichiers dans la référence CLI. --env prend du JSON. Cette méthode nécessite Node.js sur la machine où tourne le Waker, sachant que QoderWake réside par défaut sur l'appareil.

Vérifier la connexion

Récupérez le <mid> depuis mcp list. Envoyez ensuite au Waker un test en lecture seule. Les recommandations de QoderWake préconisent de valider un nouveau connecteur avec un appel en lecture seule en premier lieu :

themes_search est gratuit, ce test ne coûte donc rien. Si un connecteur se comporte mal, qoderwake mcp toggle --waker-id ag_xxx --mcp-id <mid> --enabled false permet de le désactiver sans le supprimer.

Méthode 4 : Télécharger le skill 2Slides

Les skills QoderWake sont des packs de capacités versionnés via git que vous pouvez comparer (diff) et restaurer. Vous téléchargez « un fichier Markdown ou une archive contenant SKILL.md ». Le skill officiel 2Slides est disponible sur github.com/2slides/slides-generation-2slides-skills. Compressez-le en veillant à ce que SKILL.md se trouve à la racine de l'archive :

Cela exclut l'ancien bundle .skill présent dans le dépôt. Les scripts Python du skill (Python 3 et requests) lisent la clé à partir de la variable d'environnement SLIDES_2SLIDES_API_KEY.

Règle sur les secrets. La documentation de QoderWake précise : « Ne placez jamais de secrets, de jetons ou de cookies dans les tâches, la mémoire, les bases de connaissances, les fichiers de rôle ou les captures d'écran. » Les identifiants doivent figurer dans des champs protégés ou des variables d'environnement. Ne collez donc jamais votre clé dans le prompt d'une tâche et ne demandez pas au Waker de s'en « souvenir ». QoderWake ne documente pas de méthode pour passer des variables d'environnement aux scripts de skill ; nous recommandons donc cette répartition :

• Utilisez le connecteur MCP (Méthode 1) pour les appels API réels. La clé réside dans son en-tête.
• Utilisez le skill uniquement si la variable SLIDES_2SLIDES_API_KEY est déjà définie dans l'environnement où le Waker s'exécute. Vérifiez-le avec une tâche de test exécutant scripts/search_themes.py --query minimal --limit 1.

Générer votre premier deck

Le Waker doit appeler themes_search, puis slides_generate, et retourner un downloadUrl. Lors de notre test en production, un deck Fast PPT de 3 pages a été généré en environ 22 secondes. Le lien expire après 1 heure. La documentation de QoderWake indique que la livraison des fichiers « dépend des capacités du canal. Utilisez le lien retourné ou l'artefact de la tâche ». Demandez donc au Waker de poster le lien immédiatement, ou de télécharger le .pptx dans son espace de travail. Vous pourrez ensuite le récupérer de la session avec qoderwake session artifacts --session-id sess_xxx.

Cas d'usage pour un employé IA

Déclenché depuis DingTalk ou Feishu. Une fois qu'un Waker est associé à un canal DingTalk ou Feishu, un collaborateur peut envoyer le message « @Reporting Assistant crée une mise à jour de 6 diapositives sur le plan de recrutement du T4 ». Le Waker rassemble le contexte, appelle 2Slides et répond avec le lien.

Un deck hebdomadaire programmé. La référence CLI documente les automatisations planifiées :

Exécutez-le une fois avec run-now et vérifiez le résultat avec qoderwake automation detail avant de le laisser fonctionner en autonomie.

Les outils MCP 2Slides

Ce qui est confirmé vs ce qui n'est pas encore documenté (au 30 septembre 2026)

Dépannage

• "daemon unreachable". Exécutez qoderwake status. Si le démon ne tourne pas, qoderwake start. Si le port est déjà pris, qoderwake start --port auto.
• Erreur 401 de QoderWake lui-même. Exécutez qoderwake whoami, et qoderwake login à nouveau si nécessaire.
• Erreur 401 de 2Slides. L'en-tête est probablement arrivé sans la clé. Ajoutez-la à nouveau avec le --header entre guillemets ou le format JSON --headers.
• Outils manquants. Exécutez qoderwake mcp refresh-tools et vérifiez que le connecteur est activé avec mcp toggle ... --enabled true.
• Échec de stdio. Vérifiez que Node.js est installé sur l'appareil du Waker et que --args est séparé par des virgules.
• Erreurs lors d'une exécution. qoderwake log --level error --limit 100 ou qoderwake trace list --status failed.
• Lien expiré. downloadUrl dure 1 heure. Demandez au Waker de sauvegarder le fichier en tant qu'artefact de tâche.

Foire aux questions

QoderWake prend-il en charge les serveurs MCP personnalisés ?

Oui. Chaque Waker peut monter plusieurs serveurs MCP via stdio, HTTP ou SSE, en utilisant qoderwake mcp add --waker-id <id> ou l'écran Connecteurs MCP personnalisés dans la console.

Quelle est la commande exacte pour ajouter 2Slides à un Waker ?

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". Mettez toute la paire d'en-tête entre guillemets, car la valeur contient un espace.

Où dois-je stocker la clé API 2Slides dans QoderWake ?

Dans l'en-tête du connecteur MCP (--header ou --headers) ou dans son --env pour stdio. Ne la placez jamais dans une tâche, la mémoire, une base de connaissances ou un fichier de rôle. La documentation de QoderWake l'interdit explicitement.

Un Waker peut-il envoyer le PowerPoint vers DingTalk ou Feishu ?

Le Waker peut toujours répondre avec le lien de téléchargement 2Slides. Le fait que le fichier lui-même soit joint dépend du canal. La documentation de QoderWake préconise d'utiliser le lien retourné ou l'artefact de la tâche. Le lien expire après 1 heure.

Un Waker peut-il créer un deck chaque semaine automatiquement ?

Oui. Créez une automatisation planifiée avec qoderwake automation create schedule et une expression cron. Testez-la avec automation run-now avant de la laisser s'exécuter sans surveillance.

Combien cela coûte-t-il ?

Les nouveaux comptes 2Slides reçoivent 500 crédits gratuits. Fast PPT coûte 10 crédits par page, donc un deck hebdomadaire de 8 diapositives revient à 80 crédits. La recherche de thèmes, l'interrogation des jobs et les exports sont gratuits.

L'essentiel

Une seule commande qoderwake mcp add transforme un Waker en un employé IA capable de livrer de véritables présentations. Conservez la clé dans l'en-tête MCP, déclenchez l'action depuis DingTalk, Feishu ou via une tâche cron, et enregistrez le .pptx dans l'heure qui suit.

Guides associés : agents IA personnels pour créer des diapositives, QwenWork avec 2Slides, WorkBuddy avec 2Slides, utiliser n'importe quel agent IA avec le serveur MCP 2Slides, et compétences d'agent vs serveurs MCP pour les présentations.

Obtenez votre clé et votre configuration sur 2slides.com/api?tab=mcp.

Sources :

• Référence CLI QoderWake
• Compétences et intégrations QoderWake
• Page produit QoderWake
• API 2Slides et serveur MCP
• Compétence 2Slides sur GitHub
• 2slides-mcp sur GitHub