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

Respuesta rápida (≤60 palabras): Claude Code puede generar archivos de PowerPoint reales conectándose al servidor MCP de 2Slides. Consigue una API key en 2slides.com/api y ejecuta

claude mcp add --env API_KEY=xxx --transport stdio 2slides -- npx 2slides-mcp

para stdio local, o

claude mcp add --transport http 2slides https://2slides.com/api/mcp?apikey=KEY

para Streamable HTTP remoto. Luego pídele a Claude Code que cree una presentación.

Claude Code es el agente de programación basado en terminal de Anthropic, y habla el Model Context Protocol (MCP) de forma nativa. Esto significa que puedes darle una herramienta que convierte texto en un archivo

terminado sin salir nunca de tu shell. El servidor MCP de 2Slides es esa herramienta: un conector ligero que expone las APIs de generación de diapositivas, temas, narración y exportación de 2Slides como herramientas MCP que Claude Code puede invocar directamente.

Esta guía te muestra ambas formas de conectarse —stdio local y Streamable HTTP remoto—, cuál elegir, qué hace cada herramienta y los prompts exactos que convierten una petición de una línea en un PowerPoint descargable.

¿Por qué conectar Claude Code a 2Slides?

Claude Code es excelente razonando sobre tu repositorio, redactando contenido y estructurando un argumento. Lo que no puede hacer por sí solo es producir un

real y editable con formas, gráficos, temas y notas del orador. Eso es un problema de generación de archivos, y le corresponde a una herramienta dedicada.

La división es clara:

• Claude Code lee tu material de origen (un README, una especificación, un CSV, una nota de investigación), razona sobre él y decide qué va en cada diapositiva.
• El servidor MCP de 2Slides toma ese plan y renderiza un archivo de PowerPoint real, o diapositivas basadas en imágenes con narración de voz por IA y exportación a MP4.

Te quedas en la terminal todo el tiempo. Pides, esperas unos 30-60 segundos y obtienes una URL de descarga.

Qué necesitas primero

1. Claude Code instalado y autenticado (
   claude
   en tu PATH).
2. Una API key de 2Slides. Crea una en 2slides.com/api. La misma página tiene una configuración MCP lista para copiar y pegar y el endpoint de Streamable HTTP.
3. Node.js (para el transporte stdio, que ejecuta
   npx 2slides-mcp
   localmente). El transporte HTTP no necesita nada local.

Stdio vs Streamable HTTP: ¿qué transporte?

El servidor MCP de 2Slides admite dos transportes. Ambos exponen el mismo conjunto de herramientas; solo se diferencian en dónde se ejecuta el conector.

Regla práctica: usa stdio en tu propia máquina para el trabajo diario, y Streamable HTTP cuando Claude Code se ejecute en un lugar donde no puedas instalar Node (un servidor remoto, un job de CI, un contenedor restringido).

Método 1: Conectar vía stdio (local)

Ejecuta esto una vez. El separador

divide los flags propios de Claude Code del comando que lanza:

claude mcp add --env API_KEY=YOUR_2SLIDES_API_KEY --transport stdio 2slides -- npx 2slides-mcp

Algunas cosas que conviene saber:

• Mantén
  --transport stdio
  (u otro flag) entre
  --env
  y el nombre del servidor. Como
  --env
  acepta varios pares
  KEY=value
  , poner el nombre justo después puede hacer que la CLI lo lea como otra variable de entorno.
• Todo lo que va después de
  --
  se pasa al servidor sin alterar (
  npx 2slides-mcp
  ).
• Añade
  --scope user
  para que 2Slides esté disponible en todos los proyectos, o
  --scope project
  para guardarlo en un
  .mcp.json
  compartido con tu equipo.

El

resultante (ámbito de proyecto) tiene este aspecto —también puedes editarlo a mano—:

{
  "mcpServers": {
    "2slides": {
      "command": "npx",
      "args": ["2slides-mcp"],
      "env": { "API_KEY": "YOUR_2SLIDES_API_KEY" }
    }
  }
}

Método 2: Conectar vía Streamable HTTP (remoto)

Sin instalación local: solo apunta Claude Code al endpoint alojado:

claude mcp add --transport http 2slides https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY

¿Prefieres mantener la clave fuera de la URL? Envíala como cabecera en su lugar:

claude mcp add --transport http 2slides https://2slides.com/api/mcp \
  --header "Authorization: Bearer YOUR_2SLIDES_API_KEY"

Verifica la conexión

claude mcp list          # 2slides debería aparecer y conectarse
claude mcp get 2slides   # muestra su configuración y las herramientas descubiertas

O, dentro de una sesión interactiva, ejecuta el comando

para ver los servidores conectados, el número de herramientas y (para servidores remotos) el estado de autenticación.

Genera tu primera presentación

Una vez conectado, no invocas las herramientas a mano: simplemente preguntas. Claude Code encadena las herramientas de 2Slides automáticamente:

Search the 2slides themes for a clean "business" style, then
generate a 7-slide deck introducing our Q3 roadmap. Pull the
content from ./ROADMAP.md. Return the download link.

Entre bambalinas, Claude Code ejecuta

para encontrar un , luego (Fast PPT) y te entrega un . Tiempo total: aproximadamente 30-60 segundos para un PowerPoint con tema.

¿Quieres diapositivas personalizadas y diseñadas con imágenes en lugar de una plantilla? Pídelo y Claude Code usará la vía de Nano Banana (

), consultará hasta que esté listo y devolverá el enlace.

Las herramientas del servidor MCP de 2Slides

Claude Code ve estas herramientas una vez conectado:

Tres cadenas típicas:

• Fast PPT:
  themes_search
  →
  slides_generate
  (síncrono) → descarga.
• Nano Banana:
  slides_create_pdf_slides
  (asíncrono) →
  jobs_get
  → descarga.
• Recursos de vídeo narrado: crear diapositivas →
  jobs_get
  →
  slides_generate_narration
  →
  jobs_get
  →
  slides_download_pages_voices
  .

Errores comunes y solución de problemas

• El servidor no aparece en
  claude mcp list
  . Para stdio, comprueba que el orden de
  --env
  /nombre es correcto (mantén un flag entre
  --env
  y el nombre). Para HTTP, revisa la URL y que la API key sea válida.
• Falta
  API_KEY
  . El servidor stdio necesita la variable de entorno; el servidor HTTP necesita
  ?apikey=
  o una cabecera
  Authorization
  . No los confundas.
• Pedir un
  .pptx
  sin la herramienta. Sin 2Slides conectado, Claude Code puede escribir un esquema pero no puede producir un PowerPoint real. Conecta primero el servidor.
• Olvidar el tema. Si no ejecutas
  themes_search
  ni nombras un estilo, Fast PPT elige uno por ti. Especifícalo para controlar el aspecto.
• Consultar demasiado rápido. Los jobs asíncronos (Nano Banana, narración) deben consultarse con
  jobs_get
  cada unos 20 segundos, no en un bucle ajustado.

Preguntas frecuentes

¿Claude Code admite servidores MCP de forma nativa?

Sí. Claude Code es un cliente MCP de primera clase. Añades servidores con

(transportes stdio, SSE o HTTP), los listas con y los inspeccionas en sesión con . El servidor de 2Slides funciona con todos ellos.

Stdio o Streamable HTTP: ¿cuál debería usar?

Usa stdio en tu máquina local (ejecuta

por ti) y Streamable HTTP en cualquier sitio donde no puedas o no quieras instalar Node: CI, contenedores, servidores remotos. Ambos exponen las mismas herramientas y producen un resultado idéntico.

¿Esto produce un archivo de PowerPoint real?

Sí. La vía de Fast PPT (

) devuelve un editable con formas y temas reales. Las vías de Nano Banana devuelven presentaciones diseñadas con imágenes y pueden añadir narración de voz por IA y recursos exportables. Son archivos que puedes abrir, editar y presentar, no capturas de pantalla.

¿De dónde saco la API key y la configuración?

En 2slides.com/api?tab=mcp. Esa página muestra tu clave, una configuración stdio lista para pegar y la URL del endpoint de Streamable HTTP.

¿Puedo compartir el servidor de 2Slides con mi equipo?

Sí. Añádelo con

para escribir un compartido que confirmas en el repositorio. A tus compañeros se les pedirá que lo aprueben en el primer uso. Usa para una configuración privada en todos los proyectos.

Conclusión

Claude Code se encarga de pensar; el servidor MCP de 2Slides se encarga del archivo. Conéctalo una vez —stdio para local, Streamable HTTP para remoto— y «hazme una presentación» se convierte en una sola frase en tu terminal.

Si vives en Claude Code, este es el camino más rápido desde una idea (o un archivo de tu repositorio) hasta un PowerPoint terminado y editable. Para una visión más amplia de cómo conectar diapositivas a agentes, consulta cómo el MCP está cambiando los flujos de trabajo de presentaciones y el mapa completo del ecosistema de servidores MCP de PowerPoint. ¿Usas la app de escritorio en lugar de la CLI? Consulta cómo usar Claude MCP para generar presentaciones.

Consigue tu clave y configuración en 2slides.com/api?tab=mcp y genera tu primera presentación desde la terminal en menos de un minuto.

Fuentes:

• Claude Code — Connect to tools via MCP (official docs)
• 2Slides API & MCP server