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

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

. 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

finito e modificabile, tutto dal terminale.

Questa guida ti fornisce i blocchi

esatti per entrambi i trasporti (stdio locale e Streamable HTTP remoto), la scorciatoia in una riga , 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 2slides-mcp
   ). 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

e aggiungi:

[mcp_servers.2slides]
command = "npx"
args = ["2slides-mcp"]

[mcp_servers.2slides.env]
API_KEY = "YOUR_2SLIDES_API_KEY"

I campi opzionali che Codex supporta per i server stdio includono

, (predefinito 10s) e (predefinito 60s). Se preferisci passare una variabile d'ambiente esistente invece di inserire la chiave in linea, usa .

Oppure usa la scorciatoia

codex mcp add

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

codex mcp add 2slides --env API_KEY=YOUR_2SLIDES_API_KEY -- npx 2slides-mcp

Tutto ciò che segue

è il comando del server. Esegui per l'elenco completo dei sottocomandi sulla versione che hai installato.

Metodo 2: Streamable HTTP in config.toml

Punta Codex all'endpoint ospitato:

[mcp_servers.2slides_remote]
url = "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"

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:

[mcp_servers.2slides_remote]
url = "https://2slides.com/api/mcp"
bearer_token_env_var = "TWOSLIDES_TOKEN"

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

finché non abiliti il client sperimentale. Se ti succede, aggiungi:

[features]
experimental_use_rmcp_client = true

Controlla prima

— le versioni più recenti lo integrano e il flag verrà rinominato in . Mostra questo blocco solo come ripiego se la tua versione segnala problemi.

Verifica la connessione

codex mcp list      # elenca i server MCP configurati
codex mcp get 2slides

Oppure, all'interno della TUI di Codex, esegui

per vedere i server attivi e i loro strumenti. (I sottocomandi di gestione sono ancora in evoluzione; è la fonte autorevole per la tua build.)

Genera la tua prima presentazione

Non richiami gli strumenti manualmente — chiedi:

Read ./docs/launch-plan.md and generate a 10-slide launch deck.
Use a modern, dark business theme from 2slides. Return the
download link when it's done.

Codex esegue

per trovare un , poi (Fast PPT) e restituisce un — un vero PowerPoint in circa 30-60 secondi. Chiedi slide progettate con immagini e passa a , interrogando 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

sotto , oppure li aggiungi con . Sono supportati sia i server stdio che quelli HTTP remoti.

Dove memorizza Codex la configurazione MCP?

In

(globale). I progetti attendibili possono anche usare un locale al progetto. Ogni server MCP è una tabella .

Stdio o Streamable HTTP?

Stdio esegue

sulla tua macchina ed è l'opzione predefinita per il lavoro locale. Streamable HTTP punta all'endpoint ospitato e non richiede nulla di installato — ideale per CI e ambienti remoti. Stessi strumenti, stesso output.

Produce un vero PowerPoint?

Sì —

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