2slides

Servidor MCP de 2slides

Exponga las herramientas de 2slides.com a los clientes MCP: genere presentaciones de PowerPoint y diapositivas de diseño personalizado, añada narración por voz con IA y obtenga los archivos finales como enlaces de descarga.

Obtenga su clave API

Antes de conectarse, obtenga una clave API en 2slides.com/api.

Conectar

2slides ejecuta un endpoint MCP Streamable HTTP alojado y también incluye este paquete stdio. Ambos exponen las mismas 7 herramientas con la misma cuenta y los mismos créditos.

	Streamable HTTP	stdio (este paquete)
Configuración	un comando, nada que instalar	requiere Node.js 18+, npx descarga el paquete
Actualizaciones	del lado del servidor, siempre actual	se vuelve a descargar en su máquina
Se ejecuta en	cualquier cliente MCP con capacidad remota	cualquier cliente que pueda iniciar un proceso local

Opción 1 — Streamable HTTP (recomendado)

La documentación de MCP de Anthropic llama a HTTP "la opción recomendada para conectarse a servidores MCP remotos", y 2slides es un servicio alojado sin archivos ni procesos locales a los que acceder, así que comience aquí.

Claude Code

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

Verifique con claude mcp list — el servidor debería informar ✔ Connected.

Configuración del proyecto (.mcp.json, compartida con su equipo)

{
  "mcpServers": {
    "2slides": {
      "type": "http",
      "url": "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"
    }
  }
}

Claude Desktop / claude.ai: agréguelo como conector personalizado en claude.ai/customize/connectors con la misma URL.

Opción 2 — stdio (proceso local)

Use esta opción cuando el cliente solo pueda iniciar procesos locales, cuando la máquina no tenga ruta directa a 2slides.com, o cuando quiera fijar y parchear el servidor usted mismo.

Claude Code

claude mcp add 2slides -e API_KEY=YOUR_2SLIDES_API_KEY -- npx -y 2slides-mcp@latest

Claude Desktop — edite ~/Library/Application Support/Claude/claude_desktop_config.json (%APPDATA%\Claude\claude_desktop_config.json en Windows):

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

La marca -y permite que npx instale el paquete sin preguntar. Reinicie completamente Claude Desktop después; en un chat, abra el panel de herramientas y debería ver las herramientas a continuación.

Herramientas disponibles

---

slides_generate (POST /api/v1/slides/generate)

Genere una presentación de PowerPoint usando un tema predefinido (Fast PPT). Use themes_search primero para encontrar un themeId.

• Argumentos:
  • userInput (cadena, obligatorio) — contenido de la presentación
  • themeId (cadena, obligatorio) — ID del tema de themes_search
  • responseLanguage (cadena, opcional, predeterminado: Auto) — idioma de salida; valores admitidos: Auto, English, Spanish, Arabic, Portuguese, Indonesian, Japanese, Russian, Hindi, French, German, Greek, Vietnamese, Turkish, Thai, Polish, Italian, Korean, Simplified Chinese, Traditional Chinese
  • mode (opcional, predeterminado: sync) — sync devuelve downloadUrl inmediatamente; async devuelve un jobId para consultar con jobs_get
• Créditos: 1 por página
• Ejemplo:

  {
    "themeId": "st-1756528793701-fcg5fblt2",
    "userInput": "Generate a 5-slide intro to machine learning",
    "responseLanguage": "English",
    "mode": "sync"
  }
  

---

themes_search (GET /api/v1/themes/search)

Busque temas predefinidos para usar con slides_generate.

• Argumentos:
  • query (cadena, obligatorio) — palabra clave de búsqueda (p. ej. business, minimal, dark)
  • limit (número, opcional, predeterminado: 10, rango: 1–100)
• Devuelve: matriz de temas con id, name, description, previewUrl, tags
• Créditos: gratis
• Ejemplo:

  { "query": "business", "limit": 5 }
  

---

jobs_get (GET /api/v1/jobs/{jobId})

Consulte el estado de un trabajo y recupere el resultado cuando esté listo.

• Argumentos:
  • jobId (cadena, obligatorio)
• Devuelve: jobId, status (pending / processing / success / failed), message, downloadUrl (en caso de éxito), slidePageCount, createdAt, updatedAt, duration (ms), jobUrl (solo trabajos Nano Banana)
• Créditos: gratis
• Nota: Consulte cada 20 segundos hasta que status sea success o failed.
• Ejemplo:

  { "jobId": "D8h9VYDGdTlZ6wWSEoctF" }
  

---

slides_create_like_this (POST /api/v1/slides/create-like-this)

Genere diapositivas (Nano Banana) que coincidan con el estilo de una imagen de referencia.

• Argumentos:
  • userInput (cadena, obligatorio) — contenido de la presentación
  • referenceImageUrl (cadena, obligatorio) — URL de la imagen de referencia de estilo
  • responseLanguage (cadena, opcional, predeterminado: Auto)
  • aspectRatio (cadena, opcional, predeterminado: 16:9) — valores válidos: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
  • resolution (cadena, opcional, predeterminado: 2K) — 1K, 2K, 4K
  • page (número, opcional, predeterminado: 0) — 0 = detección automática, 1–100 = número exacto de páginas
  • contentDetail (cadena, opcional, predeterminado: standard) — concise o standard
  • mode (cadena, opcional, predeterminado: async) — async devuelve jobId; sync devuelve downloadUrl inmediatamente
• Créditos: 100 por página (1K/2K) o 200 por página (4K)
• Ejemplo:

  {
    "userInput": "Create a presentation about AI trends",
    "referenceImageUrl": "https://example.com/style-reference.jpg",
    "aspectRatio": "16:9",
    "resolution": "2K",
    "page": 5,
    "contentDetail": "standard",
    "mode": "async"
  }
  

---

slides_create_pdf_slides (POST /api/v1/slides/create-pdf-slides)

Genere diapositivas de diseño personalizado (Nano Banana) a partir de contenido de texto sin imagen de referencia.

• Argumentos:
  • userInput (cadena, obligatorio) — contenido de la presentación
  • designStyle (cadena, opcional) — descripción en texto libre del estilo visual; déjelo vacío para el estilo predeterminado
  • responseLanguage (cadena, opcional, predeterminado: Auto)
  • aspectRatio (cadena, opcional, predeterminado: 16:9) — valores válidos: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
  • resolution (cadena, opcional, predeterminado: 2K) — 1K, 2K, 4K
  • page (número, opcional, predeterminado: 0) — 0 = detección automática, 1–100 = número exacto de páginas
  • contentDetail (cadena, opcional, predeterminado: standard) — concise o standard
  • mode (cadena, opcional, predeterminado: async) — async devuelve jobId; sync devuelve downloadUrl inmediatamente
• Créditos: 100 por página (1K/2K) o 200 por página (4K)
• Ejemplo:

  {
    "userInput": "Quarterly business review for Q3 2025",
    "designStyle": "modern, dark background, bold typography",
    "aspectRatio": "16:9",
    "resolution": "2K",
    "page": 8,
    "mode": "async"
  }
  

---

slides_generate_narration (POST /api/v1/slides/generate-narration)

Añada narración por voz con IA a un trabajo Nano Banana completado (solo slides_create_like_this o slides_create_pdf_slides; Fast PPT no compatible). Siempre asíncrono: consulte el resultado con jobs_get.

• Argumentos (un solo orador, mode: "single" predeterminado):

  • jobId (cadena, obligatorio) — UUID de un trabajo Nano Banana completado
  • mode (cadena, opcional, predeterminado: single) — single o multi
  • speakerName (cadena, opcional) — nombre del narrador
  • voice (cadena, opcional) — una de 30 voces (consulte la lista a continuación)
  • contentMode (cadena, opcional, predeterminado: standard) — concise o standard
  • includeIntro (booleano, opcional, predeterminado: true)

• Argumentos (dos oradores, mode: "multi"):

  • jobId (cadena, obligatorio)
  • mode (cadena, obligatorio) — multi
  • speaker1Name (cadena, obligatorio)
  • speaker2Name (cadena, obligatorio)
  • speaker1Voice (cadena, opcional) — voz para el orador 1
  • speaker2Voice (cadena, opcional) — voz para el orador 2
  • contentMode (cadena, opcional, predeterminado: standard) — concise o standard

• Voces compatibles (30): Puck, Aoede, Charon, Kore, Fenrir, Zephyr, Leda, Orus, Callirrhoe, Autonoe, Enceladus, Iapetus, Umbriel, Algieba, Despina, Erinome, Algenib, Rasalgethi, Laomedeia, Achernar, Alnilam, Schedar, Gacrux, Pulcherrima, Achird, Zubenelgenubi, Vindemiatrix, Sadachbia, Sadaltager, Sulafat

• Créditos: 210 por página (10 texto + 200 audio)

• Ejemplo:

  {
    "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "mode": "multi",
    "speaker1Name": "Alice",
    "speaker2Name": "Bob",
    "speaker1Voice": "Aoede",
    "speaker2Voice": "Puck",
    "contentMode": "standard"
  }
  

---

slides_download_slides_pages_voices (POST /api/v1/slides/download-slides-pages-voices)

Exporte las páginas de diapositivas y la narración de audio como un archivo ZIP. El trabajo debe estar completado y tener narración generada.

• Argumentos:
  • jobId (cadena, obligatorio) — UUID de un trabajo con narración completada
• Devuelve: downloadUrl (caduca en 1 hora), fileName, expiresIn (3600 segundos)
• Contenido del ZIP:

  pages/
    page_01.png, page_02.png, …
  voices/
    page_01.wav, page_02.wav, …
  transcript.txt
  

• Créditos: gratis
• Ejemplo:

  { "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890" }
  

---

Flujos de trabajo típicos

Fast PPT (PowerPoint basado en temas):

1. themes_search → obtenga un themeId
2. slides_generate (síncrono) → obtenga downloadUrl directamente

Nano Banana (diapositivas de diseño personalizado):

1. slides_create_like_this o slides_create_pdf_slides (asíncrono) → obtenga jobId
2. jobs_get (consulte cada 20 s) → obtenga downloadUrl cuando status: "success"

Nano Banana con narración:

1. slides_create_like_this o slides_create_pdf_slides → obtenga jobId
2. jobs_get → espere a que las diapositivas se completen
3. slides_generate_narration → obtenga la narración jobId
4. jobs_get → espere a que la narración se complete
5. slides_download_slides_pages_voices → obtenga el enlace de descarga del ZIP

---

Solución de problemas (Claude Desktop)

• Si las herramientas no aparecen en Claude, verifique que la ruta de configuración sea absoluta y reinicie la aplicación.
• Revise los registros MCP de Claude:

tail -n 50 -f ~/Library/Logs/Claude/mcp*.log

• Para servidores MCP stdio, evite registrar en stdout; este servidor solo registra errores en stderr.

Referencias

• Cree un servidor MCP (documentación oficial): https://modelcontextprotocol.io/docs/develop/build-server
• Documentación de la API de 2slides: https://2slides.com/api
• 2slides: https://2slides.com
• Plantillas de 2slides: https://2slides.com/templates