2Slides Team
6 min read
Cómo usar Gemini CLI con el servidor MCP de 2Slides (guía 2026)
Respuesta rápida (≤60 palabras): La Gemini CLI de Google puede generar archivos de PowerPoint reales vía el servidor MCP de 2Slides. Consigue una clave en 2slides.com/api, y añade una entrada
mcpServersa~/.gemini/settings.json:command: "npx",args: ["2slides-mcp"],env.API_KEYpara stdio, ohttpUrl: "https://2slides.com/api/mcp?apikey=KEY"para Streamable HTTP. O ejecutagemini mcp add. Luego pídele a Gemini que cree una presentación.
Gemini CLI es el agente de IA de terminal de código abierto de Google, y habla el Model Context Protocol (MCP). Conéctala al servidor MCP de 2Slides y Gemini podrá convertir un prompt —o un archivo de tu directorio de trabajo— en un .pptx terminado y editable.
Esta guía te da los bloques exactos de settings.json para ambos transportes (stdio local y Streamable HTTP remoto), el atajo gemini mcp add y qué hace cada herramienta de 2Slides.
¿Por qué conectar Gemini CLI a 2Slides?
Gemini es un potente razonador multimodal, pero no produce archivos .pptx binarios por sí solo. El servidor MCP de 2Slides es el generador dedicado:
- Gemini CLI lee tu fuente, planifica las diapositivas y escribe el texto.
- 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 exportable.
Qué necesitas primero
- Gemini CLI instalada (
geminien tu PATH). - Una API key de 2Slides desde 2slides.com/api.
- Node.js para el transporte stdio (
npx -y 2slides-mcp@latest). El transporte HTTP no necesita nada local.
Stdio vs Streamable HTTP: ¿qué transporte?
Ambos exponen las mismas herramientas; la diferencia es la clave de configuración y dónde se ejecuta el conector.
| Stdio (local) | Streamable HTTP (remoto) | |
|---|---|---|
| Clave de configuración | command / args / env | httpUrl |
| Node.js local | Necesario | No necesario |
| Ideal para | Desarrollo local | Remoto/CI, configuraciones ligeras |
El nombre de la clave importa: Gemini CLI usa
httpUrlpara Streamable HTTP yurlpara el SSE heredado. Para el endpoint de Streamable HTTP de 2Slides, usahttpUrl.
Método 1: stdio en settings.json
Gemini CLI lee ~/.gemini/settings.json (global) y .gemini/settings.json (proyecto). Añade un bloque mcpServers:
{
"mcpServers": {
"2slides": {
"command": "npx",
"args": ["-y", "2slides-mcp@latest"],
"env": { "API_KEY": "YOUR_2SLIDES_API_KEY" }
}
}
}Los valores de env también pueden referenciar variables del shell (p. ej. "API_KEY": "$TWOSLIDES_API_KEY") si prefieres no incrustar la clave.
Método 2: Streamable HTTP en settings.json
Para el endpoint alojado, usa httpUrl:
{
"mcpServers": {
"2slides-remote": {
"httpUrl": "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"
}
}
}¿Prefieres autenticación por cabecera? Añade un objeto headers: "headers": { "Authorization": "Bearer YOUR_2SLIDES_API_KEY" }.
O usa el comando gemini mcp add
# stdio (-e sets env vars)
gemini mcp add -e API_KEY=YOUR_2SLIDES_API_KEY 2slides npx -y 2slides-mcp@latest
# Streamable HTTP
gemini mcp add --transport http 2slides-remote "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"Estos escriben las mismas entradas mcpServers en settings.json. Los flags incluyen -t, --transport (stdio | sse | http), -e, --env, -H, --header y --timeout.
Verifica la conexión
Dentro de una sesión interactiva de gemini, ejecuta:
/mcpMuestra el estado de cada servidor (CONNECTED / CONNECTING / DISCONNECTED) y las herramientas descubiertas. Usa /mcp auth si un servidor remoto requiere OAuth.
Genera tu primera presentación
Simplemente pídelo:
Read ./notes/market-update.md and generate a 9-slide briefing.
Find a professional theme from 2slides, build the PowerPoint,
and give me the download link.Gemini CLI ejecuta themes_search → slides_generate (Fast PPT) → devuelve el downloadUrl. Para diapositivas personalizadas diseñadas con imágenes usa slides_create_pdf_slides y consulta jobs_get hasta que la presentación esté lista.
Las herramientas del servidor MCP de 2Slides
| Herramienta | Qué hace | Créditos |
|---|---|---|
themes_search | Encuentra un themeId para Fast PPT | Gratis |
slides_generate | PowerPoint basado en tema (Fast PPT), síncrono/asíncrono | 10 / 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 referencia | 100 / página (1K/2K), 200 (4K) |
slides_generate_narration | Añade narración de voz por IA a un job de Nano Banana | 210 / página |
slides_download_slides_pages_voices | Exporta páginas + audio como un ZIP | Gratis |
jobs_get | Consulta un job asíncrono hasta completarse | Gratis |
Errores comunes y solución de problemas
- Usar
urlpara el endpoint de Streamable HTTP. Gemini CLI trataurlcomo SSE. UsahttpUrlpara el Streamable HTTP de 2Slides. - El servidor aparece como DISCONNECTED en
/mcp. Comprueba la API key y, para stdio, confirma que Node.js está instalado. - No se listan herramientas. Reinicia la sesión tras editar
settings.json, o vuelve a ejecutargemini mcp add. - No hay
.pptxsin la herramienta. Gemini por sí solo redacta un esquema; 2Slides produce el archivo. - Consultar demasiado rápido. Deja que Gemini consulte
jobs_getcada unos 20 segundos para los jobs asíncronos de Nano Banana / narración.
Preguntas frecuentes
¿Gemini CLI admite servidores MCP?
Sí. Gemini CLI es un cliente MCP. Configura servidores bajo mcpServers en ~/.gemini/settings.json, o añádelos con gemini mcp add. Se admiten los transportes stdio, SSE y Streamable HTTP.
¿Cuál es la clave de configuración para un servidor Streamable HTTP?
httpUrl. Usa url solo para servidores SSE heredados. El endpoint de Streamable HTTP de 2Slides va en httpUrl.
¿Dónde guarda Gemini CLI la configuración MCP?
~/.gemini/settings.json (global) o .gemini/settings.json (proyecto). El bloque MCP es la clave de nivel superior mcpServers.
¿Produce un PowerPoint real?
Sí: slides_generate devuelve un .pptx editable. Las herramientas de Nano Banana devuelven presentaciones diseñadas con imágenes con narración por IA opcional.
¿De dónde saco la clave y la configuración?
En 2slides.com/api?tab=mcp: tu clave, una configuración lista para copiar y pegar y la URL del endpoint de Streamable HTTP.
Conclusión
Una sola entrada
mcpServers—commandpara local,httpUrlpara remoto— convierte Gemini CLI en un generador de diapositivas. Verifica con/mcpy luego simplemente pide una presentación.
Para el panorama completo, consulta cómo el MCP está cambiando los flujos de trabajo de presentaciones y el mapa del ecosistema de servidores MCP de PowerPoint. ¿Trabajas en otro agente de terminal? Consulta Claude Code, OpenAI Codex y Qwen Code con el mismo servidor.
Consigue tu clave y configuración en 2slides.com/api?tab=mcp y genera tu primera presentación desde la Gemini CLI en menos de un minuto.
Fuentes:
About 2Slides
Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.
Try For Free
