2Slides Team
9 min read
Comment utiliser Claude Code avec le serveur MCP 2Slides (guide 2026)
Réponse rapide (≤ 60 mots) : Claude Code peut générer de vrais fichiers PowerPoint en se connectant au serveur MCP 2Slides. Obtenez une clé API sur 2slides.com/api, puis lancez
claude mcp add 2slides -e API_KEY=xxx -- npx -y 2slides-mcp@latestpour le stdio local, ouclaude mcp add --transport http 2slides https://2slides.com/api/mcp?apikey=KEYpour le Streamable HTTP distant. Ensuite, demandez simplement à Claude Code de construire un deck.
Claude Code est l'agent de codage d'Anthropic, basé sur le terminal, et il parle nativement le Model Context Protocol (MCP). Cela signifie que vous pouvez lui confier un outil qui transforme du texte en un fichier .pptx finalisé sans jamais quitter votre shell. Le serveur MCP 2Slides est cet outil : un connecteur léger qui expose les API de génération de slides, de thèmes, de narration et d'export de 2Slides sous forme d'outils MCP que Claude Code peut appeler directement.
Ce guide vous montre les deux façons de vous connecter — le stdio local et le Streamable HTTP distant —, laquelle choisir, ce que fait chaque outil, et les prompts exacts qui transforment une requête d'une ligne en un PowerPoint téléchargeable.
Pourquoi connecter Claude Code à 2Slides ?
Claude Code excelle pour raisonner sur votre dépôt, rédiger du contenu et structurer une argumentation. Ce qu'il ne peut pas faire seul, c'est produire un véritable .pptx éditable avec des formes, des graphiques, des thèmes et des notes de présentateur. C'est un problème de génération de fichier, et il revient à un outil dédié.
La répartition est nette :
- Claude Code lit votre source (un README, une spécification, un CSV, une note de recherche), raisonne dessus et décide de ce qui figure sur chaque slide.
- Le serveur MCP 2Slides prend ce plan et produit un véritable fichier PowerPoint — ou des slides à base d'images avec narration vocale IA et un export MP4.
Vous restez dans le terminal tout du long. Demandez, attendez ~30 à 60 secondes, récupérez une URL de téléchargement.
Ce dont vous avez besoin au préalable
- Claude Code installé et authentifié (
claudedans votre PATH). - Une clé API 2Slides. Créez-en une sur 2slides.com/api. La même page contient une config MCP à copier-coller et l'endpoint Streamable HTTP.
- Node.js (pour le transport stdio, qui exécute
npx -y 2slides-mcp@latesten local). Le transport HTTP ne nécessite rien en local.
Stdio ou Streamable HTTP : quel transport ?
Le serveur MCP 2Slides prend en charge deux transports. Les deux exposent le même ensemble d'outils ; ils diffèrent uniquement par l'endroit où s'exécute le connecteur.
| Protocole Stdio | Protocole Streamable HTTP | |
|---|---|---|
| Où il s'exécute | En local, via npx -y 2slides-mcp@latest | À distance, hébergé par 2Slides |
| Node.js requis en local | Oui | Non |
| Configuration | Ajouter un serveur stdio + variable d'env API_KEY | Ajouter une URL avec ?apikey= |
| Idéal pour | Dev local, hors-ligne, contrôle total | Conteneurs, CI, clients légers, zéro dépendance locale |
| Authentification | Variable d'env API_KEY | Clé API dans la requête de l'URL (ou en-tête Authorization) |
Règle générale : utilisez le stdio sur votre propre machine pour le travail quotidien, et le Streamable HTTP lorsque Claude Code s'exécute là où vous ne pouvez pas installer Node (une machine distante, un job CI, un conteneur verrouillé).
Méthode 1 : se connecter via stdio (local)
Lancez ceci une seule fois. Le séparateur -- distingue les flags propres à Claude Code de la commande qu'il lance :
claude mcp add 2slides -e API_KEY=YOUR_2SLIDES_API_KEY -- npx -y 2slides-mcp@latestQuelques points à connaître :
- Gardez
--transport stdio(ou un autre flag) entre--envet le nom du serveur. Comme--envaccepte plusieurs pairesKEY=value, placer le nom juste après peut amener la CLI à le lire comme une autre variable d'environnement. - Tout ce qui suit
--est transmis au serveur tel quel (npx -y 2slides-mcp@latest). - Ajoutez
--scope userpour rendre 2Slides disponible dans chaque projet, ou--scope projectpour le committer dans un.mcp.jsonpartagé avec votre équipe.
Le fichier .mcp.json résultant (scope projet) ressemble à ceci — vous pouvez aussi l'éditer à la main :
{
"mcpServers": {
"2slides": {
"command": "npx",
"args": ["-y", "2slides-mcp@latest"],
"env": { "API_KEY": "YOUR_2SLIDES_API_KEY" }
}
}
}Méthode 2 : se connecter via Streamable HTTP (distant)
Aucune installation locale — il suffit de pointer Claude Code vers l'endpoint hébergé :
claude mcp add --transport http 2slides https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEYVous préférez garder la clé hors de l'URL ? Envoyez-la dans un en-tête :
claude mcp add --transport http 2slides https://2slides.com/api/mcp \
--header "Authorization: Bearer YOUR_2SLIDES_API_KEY"Vérifier la connexion
claude mcp list # 2slides doit apparaître et se connecter
claude mcp get 2slides # affiche sa config et les outils détectésOu, dans une session interactive, exécutez la commande slash /mcp pour voir les serveurs connectés, le nombre d'outils et (pour les serveurs distants) le statut d'authentification.
Générez votre premier deck
Une fois connecté, vous n'appelez pas les outils à la main — vous demandez simplement. Claude Code enchaîne automatiquement les outils 2Slides :
Search the 2slides themes for a clean "business" style, then
generate a 7-slide deck introducing our Q3 roadmap. Pull the
content from ./ROADMAP.md. Return the download link.En coulisses, Claude Code lance themes_search pour trouver un themeId, puis slides_generate (Fast PPT) et vous remet une downloadUrl. Durée totale : environ 30 à 60 secondes pour un PowerPoint thématisé.
Vous voulez plutôt des slides personnalisées, conçues à base d'images, au lieu d'un template ? Demandez-le et Claude Code empruntera la voie Nano Banana (slides_create_pdf_slides), interrogera jobs_get jusqu'à ce que ce soit prêt et renverra le lien.
L'ensemble des outils MCP 2Slides
Une fois connecté, Claude Code voit ces outils :
| Outil | Ce qu'il fait | Crédits |
|---|---|---|
themes_search | Trouver un themeId pour Fast PPT | Gratuit |
slides_generate | PowerPoint à base de thème (Fast PPT), synchrone ou asynchrone | 10 / page |
slides_create_pdf_slides | Slides personnalisées conçues à base d'images depuis du texte (Nano Banana) | 100 / page (1K/2K), 200 (4K) |
slides_create_like_this | Slides reproduisant le style d'une image de référence | 100 / page (1K/2K), 200 (4K) |
slides_generate_narration | Ajouter une narration vocale IA à un job Nano Banana | 210 / page |
slides_download_slides_pages_voices | Exporter les pages + l'audio dans un ZIP | Gratuit |
jobs_get | Interroger un job asynchrone jusqu'au success | Gratuit |
Trois enchaînements typiques :
- Fast PPT :
themes_search→slides_generate(synchrone) → téléchargement. - Nano Banana :
slides_create_pdf_slides(asynchrone) →jobs_get→ téléchargement. - Assets vidéo narrés : créer les slides →
jobs_get→slides_generate_narration→jobs_get→slides_download_slides_pages_voices.
Erreurs courantes et dépannage
- Le serveur n'apparaît pas dans
claude mcp list. Pour le stdio, vérifiez que l'ordre--env/nom est correct (gardez un flag entre--envet le nom). Pour le HTTP, revérifiez l'URL et la validité de la clé API. API_KEYmanquante. Le serveur stdio a besoin de la variable d'env ; le serveur HTTP a besoin de?apikey=ou d'un en-têteAuthorization. Ne les confondez pas.- Demander un
.pptxsans l'outil. Sans 2Slides connecté, Claude Code peut rédiger un plan mais ne peut pas produire un véritable PowerPoint. Connectez d'abord le serveur. - Oublier le thème. Si vous n'exécutez pas
themes_searchou ne nommez pas de style, Fast PPT en choisit un pour vous. Spécifiez-le pour contrôler le rendu. - Interroger trop vite. Les jobs asynchrones (Nano Banana, narration) doivent être interrogés avec
jobs_getenviron toutes les 20 secondes, et non dans une boucle serrée.
Foire aux questions
Claude Code prend-il en charge nativement les serveurs MCP ?
Oui. Claude Code est un client MCP de premier ordre. Vous ajoutez des serveurs avec claude mcp add (transports stdio, SSE ou HTTP), les listez avec claude mcp list et les inspectez en session avec /mcp. Le serveur 2Slides fonctionne avec tout cela.
Stdio ou Streamable HTTP — lequel choisir ?
Utilisez le stdio sur votre machine locale (il exécute npx -y 2slides-mcp@latest pour vous) et le Streamable HTTP partout où vous ne pouvez pas ou ne voulez pas installer Node — CI, conteneurs, serveurs distants. Les deux exposent les mêmes outils et produisent un résultat identique.
Cela produit-il un véritable fichier PowerPoint ?
Oui. La voie Fast PPT (slides_generate) renvoie un .pptx éditable avec de vraies formes et de vrais thèmes. Les voies Nano Banana renvoient des decks conçus à base d'images et peuvent ajouter une narration vocale IA et des assets exportables. Ce sont des fichiers que vous pouvez ouvrir, éditer et présenter — pas des captures d'écran.
Où obtenir la clé API et la config ?
Sur 2slides.com/api?tab=mcp. Cette page affiche votre clé, une config stdio prête à coller et l'URL de l'endpoint Streamable HTTP.
Puis-je partager le serveur 2Slides avec mon équipe ?
Oui. Ajoutez-le avec --scope project pour écrire un .mcp.json partagé que vous committez dans le dépôt. Vos coéquipiers sont invités à l'approuver à la première utilisation. Utilisez --scope user pour une configuration privée, valable pour tous les projets.
À retenir
Claude Code fait la réflexion ; le serveur MCP 2Slides fait le fichier. Connectez-vous une seule fois — stdio en local, Streamable HTTP à distance — et « fais-moi un deck » devient une simple phrase dans votre terminal.
Si vous vivez dans Claude Code, c'est le chemin le plus rapide d'une idée (ou d'un fichier de votre dépôt) vers un PowerPoint finalisé et éditable. Pour une vue plus large sur l'intégration des slides aux agents, voyez comment le MCP transforme les workflows de présentation et la carte complète de l'écosystème des serveurs MCP PowerPoint. Vous utilisez l'application de bureau plutôt que la CLI ? Voyez comment utiliser Claude MCP pour générer des présentations.
Récupérez votre clé et votre config sur 2slides.com/api?tab=mcp et générez votre premier deck depuis le terminal en moins d'une minute.
Sources :
About 2Slides
Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.
Try For Free
