Come usare Claude Code con il server MCP di 2Slides (Guida 2026)

Risposta rapida (≤60 parole): Claude Code può generare veri file PowerPoint collegandosi al server MCP di 2Slides. Ottieni una chiave API su 2slides.com/api, poi esegui claude mcp add 2slides -e API_KEY=xxx -- npx -y 2slides-mcp@latest per lo stdio locale, oppure claude mcp add --transport http 2slides https://2slides.com/api/mcp?apikey=KEY per lo Streamable HTTP remoto. Poi basta chiedere a Claude Code di creare una presentazione.

Claude Code è l'agente di coding da terminale di Anthropic e parla nativamente il Model Context Protocol (MCP). Questo significa che puoi dargli uno strumento che trasforma il testo in un file .pptx finito senza mai lasciare la shell. Il server MCP di 2Slides è proprio quello strumento: un connettore leggero che espone le API di 2Slides per la generazione di slide, i temi, la narrazione e l'esportazione come strumenti MCP che Claude Code può richiamare direttamente.

Questa guida ti mostra entrambi i modi per collegarti — stdio locale e Streamable HTTP remoto — quale scegliere, cosa fa ciascuno strumento e i prompt esatti che trasformano una richiesta di una riga in un PowerPoint scaricabile.

Perché collegare Claude Code a 2Slides?

Claude Code è eccellente nel ragionare sul tuo repository, redigere contenuti e strutturare un'argomentazione. Ciò che non può fare da solo è produrre un vero file .pptx modificabile con forme, grafici, temi e note del relatore. Questo è un problema di generazione di file e spetta a uno strumento dedicato.

La divisione è netta:

• Claude Code legge il tuo materiale di origine (un README, una specifica, un CSV, una nota di ricerca), ci ragiona e decide cosa va su ogni slide.
• Il server MCP di 2Slides prende quel piano e produce un vero file PowerPoint — oppure slide basate su immagini con narrazione vocale AI ed esportazione in MP4.

Rimani nel terminale per tutto il tempo. Chiedi, aspetti ~30-60 secondi, ottieni un URL di download.

Cosa ti serve prima

1. Claude Code installato e autenticato (claude nel tuo PATH).
2. Una chiave API di 2Slides. Creane una su 2slides.com/api. La stessa pagina contiene una configurazione MCP pronta da copiare e l'endpoint Streamable HTTP.
3. Node.js (per il trasporto stdio, che esegue npx -y 2slides-mcp@latest localmente). Il trasporto HTTP non richiede nulla in locale.

Stdio o Streamable HTTP: quale trasporto?

Il server MCP di 2Slides supporta due trasporti. Entrambi espongono lo stesso identico set di strumenti; differiscono solo per dove viene eseguito il connettore.

Regola pratica: usa stdio sulla tua macchina per il lavoro quotidiano e Streamable HTTP quando Claude Code viene eseguito in un ambiente dove non puoi installare Node (una macchina remota, un job CI, un container blindato).

Metodo 1: collegamento via stdio (locale)

Esegui questo comando una volta. Il separatore -- divide i flag propri di Claude Code dal comando che lancia:

Alcune cose utili da sapere:

• Tieni --transport stdio (o un altro flag) tra --env e il nome del server. Poiché --env accetta più coppie KEY=value, mettere il nome subito dopo può far sì che la CLI lo interpreti come un'altra variabile d'ambiente.
• Tutto ciò che segue -- viene passato al server senza modifiche (npx -y 2slides-mcp@latest).
• Aggiungi --scope user per rendere 2Slides disponibile in ogni progetto, oppure --scope project per inserirlo in un .mcp.json condiviso con il tuo team.

Il file .mcp.json risultante (scope di progetto) appare così — puoi anche modificarlo a mano:

Metodo 2: collegamento via Streamable HTTP (remoto)

Nessuna installazione locale — basta puntare Claude Code all'endpoint ospitato:

Preferisci tenere la chiave fuori dall'URL? Inviala invece come header:

Verifica la connessione

Oppure, all'interno di una sessione interattiva, esegui il comando slash /mcp per vedere i server connessi, il numero di strumenti e (per i server remoti) lo stato dell'autenticazione.

Genera la tua prima presentazione

Una volta connesso, non richiami gli strumenti manualmente — chiedi e basta. Claude Code concatena automaticamente gli strumenti di 2Slides:

Dietro le quinte Claude Code esegue themes_search per trovare un themeId, poi slides_generate (Fast PPT) e ti consegna un downloadUrl. Tempo totale: circa 30-60 secondi per un PowerPoint a tema.

Vuoi slide personalizzate progettate con immagini invece di un template? Chiedilo e Claude Code userà il percorso Nano Banana (slides_create_pdf_slides), interrogherà jobs_get finché non è pronto e restituirà il link.

L'elenco degli strumenti MCP di 2Slides

Una volta connesso, Claude Code vede questi strumenti:

Tre catene tipiche:

• Fast PPT: themes_search → slides_generate (sincrono) → download.
• Nano Banana: slides_create_pdf_slides (asincrono) → jobs_get → download.
• Asset video narrati: crea le slide → jobs_get → slides_generate_narration → jobs_get → slides_download_slides_pages_voices.

Errori comuni e risoluzione dei problemi

• Il server non compare in claude mcp list. Per stdio, verifica che l'ordine --env/nome sia corretto (tieni un flag tra --env e il nome). Per HTTP, ricontrolla l'URL e che la chiave API sia valida.
• API_KEY mancante. Il server stdio ha bisogno della variabile d'ambiente; il server HTTP ha bisogno di ?apikey= o di un header Authorization. Non confonderli.
• Chiedere un .pptx senza lo strumento. Senza 2Slides connesso, Claude Code può scrivere uno schema ma non può produrre un vero PowerPoint. Collega prima il server.
• Dimenticare il tema. Se non esegui themes_search o non indichi uno stile, Fast PPT ne sceglie uno per te. Specificalo per controllare l'aspetto.
• Polling troppo frequente. I job asincroni (Nano Banana, narrazione) vanno interrogati con jobs_get circa ogni 20 secondi, non in un ciclo serrato.

Domande frequenti

Claude Code supporta nativamente i server MCP?

Sì. Claude Code è un client MCP di prima classe. Aggiungi i server con claude mcp add (trasporti stdio, SSE o HTTP), li elenchi con claude mcp list e li ispezioni durante la sessione con /mcp. Il server di 2Slides funziona con tutti questi.

Stdio o Streamable HTTP — quale dovrei usare?

Usa stdio sulla tua macchina locale (esegue npx -y 2slides-mcp@latest per te) e Streamable HTTP ovunque tu non possa o non voglia installare Node — CI, container, server remoti. Entrambi espongono gli stessi strumenti e producono un output identico.

Produce un vero file PowerPoint?

Sì. Il percorso Fast PPT (slides_generate) restituisce un .pptx modificabile con forme e temi reali. I percorsi Nano Banana restituiscono presentazioni progettate con immagini e possono aggiungere narrazione vocale AI e asset esportabili. Sono file che puoi aprire, modificare e presentare — non screenshot.

Dove ottengo la chiave API e la configurazione?

Su 2slides.com/api?tab=mcp. Quella pagina mostra la tua chiave, una configurazione stdio pronta da incollare e l'URL dell'endpoint Streamable HTTP.

Posso condividere il server di 2Slides con il mio team?

Sì. Aggiungilo con --scope project per scrivere un .mcp.json condiviso da committare nel repository. Ai compagni di team verrà chiesto di approvarlo al primo utilizzo. Usa --scope user per una configurazione privata, valida per tutti i progetti.

In sintesi

Claude Code fa il ragionamento; il server MCP di 2Slides fa il file. Collegati una volta — stdio per il locale, Streamable HTTP per il remoto — e "creami una presentazione" diventa una singola frase nel tuo terminale.

Se vivi dentro Claude Code, questo è il percorso più veloce da un'idea (o da un file nel tuo repository) a un PowerPoint finito e modificabile. Per una panoramica più ampia su come collegare le slide agli agenti, vedi come l'MCP sta cambiando i flussi di lavoro delle presentazioni e la mappa completa dell'ecosistema dei server MCP per PowerPoint. Usi l'app desktop invece della CLI? Vedi come usare Claude MCP per generare presentazioni.

Prendi la tua chiave e la configurazione su 2slides.com/api?tab=mcp e genera la tua prima presentazione dal terminale in meno di un minuto.

Fonti:

• Claude Code — Connect to tools via MCP (official docs)
• 2Slides API & MCP server