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 -y 2slides-mcp@latest (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 -y 2slides-mcp@latest. 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 -y 2slides-mcp@latest). 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.

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:

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:

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:

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:

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:

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

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:

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

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

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