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 --env API_KEY=xxx --transport stdio 2slides -- npx 2slides-mcp

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

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

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 2slides-mcp
   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:

claude mcp add --env API_KEY=YOUR_2SLIDES_API_KEY --transport stdio 2slides -- npx 2slides-mcp

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 2slides-mcp
  ).
• 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

risultante (scope di progetto) appare così — puoi anche modificarlo a mano:

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

Metodo 2: collegamento via Streamable HTTP (remoto)

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

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

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

claude mcp add --transport http 2slides https://2slides.com/api/mcp \
  --header "Authorization: Bearer YOUR_2SLIDES_API_KEY"

Verifica la connessione

claude mcp list          # 2slides dovrebbe comparire e connettersi
claude mcp get 2slides   # mostra la sua configurazione e gli strumenti rilevati

Oppure, all'interno di una sessione interattiva, esegui il comando slash

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:

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.

Dietro le quinte Claude Code esegue

per trovare un , poi (Fast PPT) e ti consegna un . 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 (

), interrogherà 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_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

(trasporti stdio, SSE o HTTP), li elenchi con e li ispezioni durante la sessione con . Il server di 2Slides funziona con tutti questi.

Stdio o Streamable HTTP — quale dovrei usare?

Usa stdio sulla tua macchina locale (esegue

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 (

) restituisce un 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

per scrivere un condiviso da committare nel repository. Ai compagni di team verrà chiesto di approvarlo al primo utilizzo. Usa 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