Come usare Gemini CLI con il server MCP di 2Slides (Guida 2026)

Risposta rapida (≤60 parole): La Gemini CLI di Google può generare veri file PowerPoint tramite il server MCP di 2Slides. Ottieni una chiave su 2slides.com/api, poi aggiungi una voce mcpServers a ~/.gemini/settings.json — command: "npx", args: ["2slides-mcp"], env.API_KEY per stdio, oppure httpUrl: "https://2slides.com/api/mcp?apikey=KEY" per Streamable HTTP. Oppure esegui gemini mcp add. Poi chiedi a Gemini di creare una presentazione.

Gemini CLI è l'agente AI da terminale open-source di Google e parla il Model Context Protocol (MCP). Collegalo al server MCP di 2Slides e Gemini può trasformare un prompt — o un file nella tua directory di lavoro — in un .pptx finito e modificabile.

Questa guida fornisce i blocchi settings.json esatti per entrambi i trasporti (stdio locale e Streamable HTTP remoto), la scorciatoia gemini mcp add e cosa fa ciascuno strumento di 2Slides.

Perché collegare Gemini CLI a 2Slides?

Gemini è un solido ragionatore multimodale, ma non produce file .pptx binari da solo. Il server MCP di 2Slides è il generatore dedicato:

• Gemini CLI legge la tua origine, pianifica le slide e scrive i testi.
• Il server MCP di 2Slides produce il vero PowerPoint — Fast PPT basato su tema, oppure slide progettate con immagini con narrazione AI opzionale e un pacchetto esportabile.

Cosa ti serve prima

1. Gemini CLI installata (gemini nel tuo PATH).
2. Una chiave API di 2Slides da 2slides.com/api.
3. Node.js per il trasporto stdio (npx -y 2slides-mcp@latest). Il trasporto HTTP non richiede nulla in locale.

Stdio o Streamable HTTP: quale trasporto?

Entrambi espongono gli stessi strumenti; la differenza è la chiave di configurazione e dove viene eseguito il connettore.

Il nome della chiave conta: Gemini CLI usa httpUrl per Streamable HTTP e url per il legacy SSE. Per l'endpoint Streamable HTTP di 2Slides, usa httpUrl.

Metodo 1: stdio in settings.json

Gemini CLI legge ~/.gemini/settings.json (globale) e .gemini/settings.json (di progetto). Aggiungi un blocco mcpServers:

I valori di env possono anche fare riferimento a variabili di shell (es. "API_KEY": "$TWOSLIDES_API_KEY") se preferisci non inserire la chiave in linea.

Metodo 2: Streamable HTTP in settings.json

Per l'endpoint ospitato, usa httpUrl:

Preferisci l'autenticazione tramite header? Aggiungi un oggetto headers: "headers": { "Authorization": "Bearer YOUR_2SLIDES_API_KEY" }.

Oppure usa il comando gemini mcp add

Questi scrivono le stesse voci mcpServers in settings.json. I flag includono -t, --transport (stdio | sse | http), -e, --env, -H, --header e --timeout.

Verifica la connessione

All'interno di una sessione interattiva gemini, esegui:

Mostra lo stato di ciascun server (CONNECTED / CONNECTING / DISCONNECTED) e gli strumenti rilevati. Usa /mcp auth se un server remoto richiede OAuth.

Genera la tua prima presentazione

Basta chiedere:

Gemini CLI esegue themes_search → slides_generate (Fast PPT) → restituisce il downloadUrl. Per slide personalizzate progettate con immagini usa slides_create_pdf_slides e interroga jobs_get finché la presentazione non è pronta.

L'elenco degli strumenti MCP di 2Slides

Errori comuni e risoluzione dei problemi

• Usato url per l'endpoint Streamable HTTP. Gemini CLI tratta url come SSE. Usa httpUrl per lo Streamable HTTP di 2Slides.
• Il server risulta DISCONNECTED in /mcp. Controlla la chiave API e, per stdio, verifica che Node.js sia installato.
• Nessuno strumento elencato. Riavvia la sessione dopo aver modificato settings.json, oppure riesegui gemini mcp add.
• Niente .pptx senza lo strumento. Gemini da solo redige uno schema; 2Slides produce il file.
• Polling troppo frequente. Lascia che Gemini interroghi jobs_get circa ogni 20 secondi per i job asincroni Nano Banana / narrazione.

Domande frequenti

Gemini CLI supporta i server MCP?

Sì. Gemini CLI è un client MCP. Configura i server sotto mcpServers in ~/.gemini/settings.json, oppure aggiungili con gemini mcp add. Sono supportati i trasporti stdio, SSE e Streamable HTTP.

Qual è la chiave di configurazione per un server Streamable HTTP?

httpUrl. Usa url solo per i server SSE legacy. L'endpoint Streamable HTTP di 2Slides va in httpUrl.

Dove memorizza Gemini CLI la configurazione MCP?

~/.gemini/settings.json (globale) o .gemini/settings.json (di progetto). Il blocco MCP è la chiave di primo livello mcpServers.

Produce un vero PowerPoint?

Sì — slides_generate restituisce un .pptx modificabile. Gli strumenti Nano Banana restituiscono presentazioni progettate con immagini con narrazione AI opzionale.

Dove ottengo la chiave e la configurazione?

Su 2slides.com/api?tab=mcp: la tua chiave, una configurazione pronta da copiare e l'URL dell'endpoint Streamable HTTP.

In sintesi

Una sola voce mcpServers — command per il locale, httpUrl per il remoto — trasforma Gemini CLI in un generatore di slide. Verifica con /mcp, poi chiedi semplicemente una presentazione.

Per il quadro più ampio, vedi come l'MCP sta cambiando i flussi di lavoro delle presentazioni e la mappa dell'ecosistema dei server MCP per PowerPoint. Lavori in un altro agente da terminale? Vedi Claude Code, OpenAI Codex e Qwen Code con lo stesso server.

Ottieni la tua chiave e la configurazione su 2slides.com/api?tab=mcp e genera la tua prima presentazione dalla Gemini CLI in meno di un minuto.

Fonti:

• Gemini CLI — MCP servers (official docs)
• 2Slides API & MCP server