2Slides Logo
Cómo usar OpenAI Codex con el servidor MCP de 2Slides (guía 2026)
2Slides Team
7 min read

Cómo usar OpenAI Codex con el servidor MCP de 2Slides (guía 2026)

Respuesta rápida (≤60 palabras): OpenAI Codex puede producir archivos de PowerPoint reales añadiendo el servidor MCP de 2Slides a

~/.codex/config.toml
. Consigue una clave en 2slides.com/api y añade un bloque
[mcp_servers.2slides]
que ejecute
npx 2slides-mcp
(stdio) o un bloque con
url = "https://2slides.com/api/mcp?apikey=KEY"
(Streamable HTTP). O ejecuta
codex mcp add 2slides --env API_KEY=xxx -- npx 2slides-mcp
. Luego pídele a Codex que cree una presentación.

OpenAI Codex es el agente de programación de código abierto basado en CLI de OpenAI, y es un cliente del Model Context Protocol (MCP). Conéctalo al servidor MCP de 2Slides y Codex podrá convertir un brief —o un archivo de tu repositorio— en un

.pptx
terminado y editable, todo desde la terminal.

Esta guía te da los bloques exactos de

config.toml
para ambos transportes (stdio local y Streamable HTTP remoto), el atajo de una línea
codex mcp add
, qué hace cada herramienta de 2Slides y el detalle específico de cada versión que debes vigilar con los servidores HTTP.

¿Por qué combinar Codex con 2Slides?

Codex razona sobre código y contenido; no produce archivos binarios de diapositivas por sí solo. El servidor MCP de 2Slides cubre ese vacío. La división del trabajo:

  • Codex lee tu fuente (especificación, README, archivo de datos), planifica las diapositivas y decide la narrativa.
  • El servidor MCP de 2Slides renderiza el PowerPoint real: Fast PPT basado en tema, o diapositivas diseñadas con imágenes con narración por IA opcional y un paquete de recursos exportable.

Pides en lenguaje natural; Codex llama a las herramientas; vuelve un enlace de descarga.

Qué necesitas primero

  1. Codex CLI instalado (
    codex
    en tu PATH).
  2. Una API key de 2Slides desde 2slides.com/api: esa página también tiene la configuración MCP y el endpoint de Streamable HTTP.
  3. Node.js para el transporte stdio (ejecuta
    npx 2slides-mcp
    ). El transporte HTTP no necesita nada local.

Stdio vs Streamable HTTP: ¿qué transporte?

El servidor MCP de 2Slides ofrece ambos. Las mismas herramientas en cualquier caso: la diferencia es dónde se ejecuta el conector.

Protocolo StdioProtocolo Streamable HTTP
Dónde se ejecutaLocalmente vía
npx 2slides-mcp
De forma remota, alojado por 2Slides
Node.js localNecesarioNo necesario
Estilo de configuración
command
+
args
+
env
url
(opcionalmente
bearer_token_env_var
)
Ideal paraDesarrollo local, control totalServidores remotos/CI, configuraciones ligeras

Usa stdio en tu equipo de trabajo; usa Streamable HTTP cuando Codex se ejecute donde no puedas instalar Node.

Método 1: stdio en config.toml

Edita

~/.codex/config.toml
y añade:

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

Los campos opcionales que Codex admite para servidores stdio incluyen

cwd
,
startup_timeout_sec
(por defecto 10s) y
tool_timeout_sec
(por defecto 60s). Si prefieres pasar una variable de entorno existente en lugar de incrustar la clave, usa
env_vars = ["API_KEY"]
.

O usa el atajo
codex mcp add

Sin necesidad de editar archivos: esto escribe el bloque por ti:

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

Todo lo que va después de

--
es el comando del servidor. Ejecuta
codex mcp --help
para ver la lista completa de subcomandos en tu versión instalada.

Método 2: Streamable HTTP en config.toml

Apunta Codex al endpoint alojado:

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

Si prefieres autenticación por cabecera en lugar de una clave en la query, Codex admite una variable de entorno con bearer token y cabeceras estáticas:

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

Detalle según la versión (importante): Codex enruta los servidores MCP por HTTP a través de su cliente MCP en Rust. Las versiones recientes lo configuran automáticamente, pero algunas compilaciones antiguas dan error con

missing field command in mcp_servers
hasta que habilitas el cliente experimental. Si te ocurre, añade:

[features] experimental_use_rmcp_client = true

Comprueba primero

codex --version
: las versiones más nuevas lo incorporan, y el flag se está renombrando a
[features].rmcp_client
. Muestra este bloque solo como alternativa si tu versión protesta.

Verifica la conexión

codex mcp list # lista los servidores MCP configurados codex mcp get 2slides

O, dentro de la TUI de Codex, ejecuta

/mcp
para ver los servidores activos y sus herramientas. (Los subcomandos de gestión
codex mcp
todavía están evolucionando;
codex mcp --help
es la referencia autoritativa para tu compilación.)

Genera tu primera presentación

No invocas las herramientas manualmente: preguntas:

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 ejecuta

themes_search
para encontrar un
themeId
, luego
slides_generate
(Fast PPT), y devuelve un
downloadUrl
: un PowerPoint real en aproximadamente 30-60 segundos. Pide diapositivas diseñadas con imágenes y cambia a
slides_create_pdf_slides
, consultando
jobs_get
hasta que el archivo esté listo.

Las herramientas del servidor MCP de 2Slides

HerramientaQué haceCréditos
themes_search
Encuentra un
themeId
para Fast PPT
Gratis
slides_generate
PowerPoint basado en tema (Fast PPT), síncrono/asíncrono10 / página
slides_create_pdf_slides
Diapositivas personalizadas diseñadas con imágenes a partir de texto (Nano Banana)100 / página (1K/2K), 200 (4K)
slides_create_like_this
Diapositivas que imitan el estilo de una imagen de referencia100 / página (1K/2K), 200 (4K)
slides_generate_narration
Añade narración de voz por IA a un job de Nano Banana210 / página
slides_download_pages_voices
Exporta páginas + audio como un ZIPGratis
jobs_get
Consulta un job asíncrono hasta completarseGratis

Errores comunes y solución de problemas

  • missing field command in mcp_servers
    en un servidor HTTP.
    Tu versión de Codex necesita
    experimental_use_rmcp_client = true
    bajo
    [features]
    . Actualiza Codex o añade el flag.
  • Cabeceras de tabla TOML vs tablas en línea.
    [mcp_servers.2slides.env]
    es una subtabla; si la pones en línea, escribe
    env = { API_KEY = "..." }
    en la línea del servidor, no mezcles ambos estilos.
  • El nombre del servidor debe ser único. Cada servidor se identifica por el segmento
    [mcp_servers.NAME]
    ; reutilizar un nombre sobrescribe el bloque anterior.
  • No hay
    .pptx
    sin la herramienta.
    Codex por sí solo puede redactar un esquema pero no puede producir un PowerPoint. Añade 2Slides primero.
  • Timeouts de herramienta en presentaciones grandes. Los jobs grandes o narrados pueden superar el
    tool_timeout_sec
    por defecto de 60s; auméntalo, o deja que Codex consulte
    jobs_get
    para los jobs asíncronos.

Preguntas frecuentes

¿OpenAI Codex admite servidores MCP?

Sí. Codex es un cliente MCP. Configuras servidores en

~/.codex/config.toml
bajo
[mcp_servers.NAME]
, o los añades con
codex mcp add
. Se admiten tanto los servidores stdio como los HTTP remotos.

¿Dónde guarda Codex la configuración MCP?

En

~/.codex/config.toml
(global). Los proyectos de confianza también pueden usar un
.codex/config.toml
local del proyecto. Cada servidor MCP es una tabla
[mcp_servers.NAME]
.

¿Stdio o Streamable HTTP?

Stdio ejecuta

npx 2slides-mcp
en tu máquina y es el predeterminado para el trabajo local. Streamable HTTP apunta al endpoint alojado
https://2slides.com/api/mcp
y no necesita nada instalado: ideal para CI y entornos remotos. Las mismas herramientas, el mismo resultado.

¿Produce un PowerPoint real?

Sí:

slides_generate
devuelve un
.pptx
editable. Las herramientas de Nano Banana devuelven presentaciones diseñadas con imágenes y pueden añadir narración por IA y un paquete de recursos exportable.

¿De dónde saco la clave y la configuración?

En 2slides.com/api?tab=mcp: tu API key, una configuración lista para copiar y pegar y la URL del endpoint de Streamable HTTP.

Conclusión

Añade un bloque

[mcp_servers.2slides]
a
config.toml
(o ejecuta
codex mcp add
), y Codex gana una herramienta que convierte cualquier brief en un PowerPoint terminado, sin salir de tu terminal.

Codex es un potente agente de razonamiento; 2Slides es el generador de archivos que le faltaba. Para una visión más amplia, consulta cómo el MCP está cambiando los flujos de trabajo de presentaciones y el mapa del ecosistema de servidores MCP de PowerPoint. ¿Prefieres el agente de Anthropic? Consulta cómo usar Claude Code con el servidor MCP de 2Slides.

Consigue tu clave y la configuración exacta en 2slides.com/api?tab=mcp y lanza hoy tu primera presentación generada con Codex.

Fuentes:

About 2Slides

Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.

Try For Free