Come usare OpenAI Codex con il server MCP di 2Slides (Guida 2026)

Risposta rapida (≤60 parole): OpenAI Codex può produrre veri file PowerPoint aggiungendo il server MCP di 2Slides a ~/.codex/config.toml. Ottieni una chiave su 2slides.com/api, poi aggiungi un blocco [mcp_servers.2slides] che esegue npx -y 2slides-mcp@latest (stdio) o un blocco url = "https://2slides.com/api/mcp?apikey=KEY" (Streamable HTTP). Oppure esegui codex mcp add 2slides --env API_KEY=xxx -- npx -y 2slides-mcp@latest. Poi chiedi a Codex di creare una presentazione.

OpenAI Codex è l'agente di coding open-source da CLI di OpenAI ed è un client del Model Context Protocol (MCP). Collegalo al server MCP di 2Slides e Codex può trasformare un brief — o un file nel tuo repository — in un .pptx finito e modificabile, tutto dal terminale.

Questa guida ti fornisce i blocchi config.toml esatti per entrambi i trasporti (stdio locale e Streamable HTTP remoto), la scorciatoia in una riga codex mcp add, cosa fa ciascuno strumento di 2Slides e l'insidia specifica delle versioni a cui prestare attenzione con i server HTTP.

Perché abbinare Codex a 2Slides?

Codex ragiona su codice e contenuti; non produce file di slide binari da solo. Il server MCP di 2Slides colma questa lacuna. La divisione del lavoro:

• Codex legge la tua origine (specifica, README, file di dati), pianifica le slide e decide la narrazione.
• 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 di asset esportabili.

Chiedi in linguaggio naturale; Codex richiama gli strumenti; torna un link di download.

Cosa ti serve prima

1. Codex CLI installata (codex nel tuo PATH).
2. Una chiave API di 2Slides da 2slides.com/api — quella pagina contiene anche la configurazione MCP e l'endpoint Streamable HTTP.
3. Node.js per il trasporto stdio (esegue npx -y 2slides-mcp@latest). Il trasporto HTTP non richiede nulla in locale.

Stdio o Streamable HTTP: quale trasporto?

Il server MCP di 2Slides offre entrambi. Stessi strumenti in ogni caso — la differenza è dove viene eseguito il connettore.

Usa stdio sulla tua workstation; usa Streamable HTTP quando Codex viene eseguito dove non puoi installare Node.

Metodo 1: stdio in config.toml

Modifica ~/.codex/config.toml e aggiungi:

I campi opzionali che Codex supporta per i server stdio includono cwd, startup_timeout_sec (predefinito 10s) e tool_timeout_sec (predefinito 60s). Se preferisci passare una variabile d'ambiente esistente invece di inserire la chiave in linea, usa env_vars = ["API_KEY"].

Oppure usa la scorciatoia codex mcp add

Nessuna modifica al file richiesta — questo scrive il blocco per te:

Tutto ciò che segue -- è il comando del server. Esegui codex mcp --help per l'elenco completo dei sottocomandi sulla versione che hai installato.

Metodo 2: Streamable HTTP in config.toml

Punta Codex all'endpoint ospitato:

Se preferisci l'autenticazione tramite header anziché una chiave nella query string, Codex supporta una variabile d'ambiente per il bearer token e header statici:

Insidia legata alla versione (importante): Codex instrada i server MCP HTTP attraverso il suo client MCP in Rust. Le versioni recenti lo configurano automaticamente, ma alcune build più vecchie danno errore con missing field command in mcp_servers finché non abiliti il client sperimentale. Se ti succede, aggiungi:

Controlla prima codex --version — le versioni più recenti lo integrano e il flag verrà rinominato in [features].rmcp_client. Mostra questo blocco solo come ripiego se la tua versione segnala problemi.

Verifica la connessione

Oppure, all'interno della TUI di Codex, esegui /mcp per vedere i server attivi e i loro strumenti. (I sottocomandi di gestione codex mcp sono ancora in evoluzione; codex mcp --help è la fonte autorevole per la tua build.)

Genera la tua prima presentazione

Non richiami gli strumenti manualmente — chiedi:

Codex esegue themes_search per trovare un themeId, poi slides_generate (Fast PPT) e restituisce un downloadUrl — un vero PowerPoint in circa 30-60 secondi. Chiedi slide progettate con immagini e passa a slides_create_pdf_slides, interrogando jobs_get finché il file non è pronto.

L'elenco degli strumenti MCP di 2Slides

Errori comuni e risoluzione dei problemi

• missing field command in mcp_servers su un server HTTP. La tua versione di Codex ha bisogno di experimental_use_rmcp_client = true sotto [features]. Aggiorna Codex, oppure aggiungi il flag.
• Intestazioni di tabella TOML vs tabelle inline. [mcp_servers.2slides.env] è una sottotabella; se la metti in linea, scrivi env = { API_KEY = "..." } sulla riga del server — non mischiare i due stili.
• Il nome del server deve essere univoco. Ogni server è identificato dal segmento [mcp_servers.NOME]; riutilizzare un nome sovrascrive il blocco precedente.
• Niente .pptx senza lo strumento. Codex da solo può redigere uno schema ma non può produrre un PowerPoint. Aggiungi prima 2Slides.
• Timeout degli strumenti su presentazioni grandi. I job grandi o narrati possono superare il valore predefinito di 60s di tool_timeout_sec; aumentalo, oppure lascia che Codex interroghi jobs_get per i job asincroni.

Domande frequenti

OpenAI Codex supporta i server MCP?

Sì. Codex è un client MCP. Configuri i server in ~/.codex/config.toml sotto [mcp_servers.NOME], oppure li aggiungi con codex mcp add. Sono supportati sia i server stdio che quelli HTTP remoti.

Dove memorizza Codex la configurazione MCP?

In ~/.codex/config.toml (globale). I progetti attendibili possono anche usare un .codex/config.toml locale al progetto. Ogni server MCP è una tabella [mcp_servers.NOME].

Stdio o Streamable HTTP?

Stdio esegue npx -y 2slides-mcp@latest sulla tua macchina ed è l'opzione predefinita per il lavoro locale. Streamable HTTP punta all'endpoint ospitato https://2slides.com/api/mcp e non richiede nulla di installato — ideale per CI e ambienti remoti. Stessi strumenti, stesso output.

Produce un vero PowerPoint?

Sì — slides_generate restituisce un .pptx modificabile. Gli strumenti Nano Banana restituiscono presentazioni progettate con immagini e possono aggiungere narrazione AI più un pacchetto di asset esportabili.

Dove ottengo la chiave e la configurazione?

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

In sintesi

Aggiungi un solo blocco [mcp_servers.2slides] a config.toml (o esegui codex mcp add) e Codex acquisisce uno strumento che trasforma qualsiasi brief in un PowerPoint finito — senza lasciare il terminale.

Codex è un solido agente di ragionamento; 2Slides è il generatore di file che gli mancava. Per il quadro generale, vedi come l'MCP sta cambiando i flussi di lavoro delle presentazioni e la mappa dell'ecosistema dei server MCP per PowerPoint. Preferisci l'agente di Anthropic? Vedi come usare Claude Code con il server MCP di 2Slides.

Ottieni la tua chiave e la configurazione esatta su 2slides.com/api?tab=mcp e pubblica oggi stesso la tua prima presentazione generata con Codex.

Fonti:

• OpenAI Codex — Model Context Protocol (official docs)
• OpenAI Codex — Configuration Reference
• 2Slides API & MCP server