2slides

Servidor MCP de 2slides

Expone las herramientas de 2slides.com para clientes MCP (por ejemplo, Claude Desktop).

Obtén tu clave API

Antes de usar este servidor MCP, necesitas obtener una clave API desde 2slides.com/api.

Configurar en Claude Desktop

Edita ~/Library/Application Support/Claude/claude_desktop_config.json y añade:

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

Luego reinicia completamente Claude Desktop. En un chat, abre el panel de herramientas y deberías ver las herramientas a continuación.

Herramientas disponibles

---

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

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

• Args:
  • userInput (string, requerido) — contenido de la presentación
  • themeId (string, requerido) — ID del tema desde themes_search
  • responseLanguage (string, 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)

Busca temas predefinidos para usar con slides_generate.

• Args:
  • query (string, requerido) — palabra clave de búsqueda (ej. business, minimal, dark)
  • limit (number, opcional, predeterminado: 10, rango: 1–100)
• Devuelve: array de temas con id, name, description, previewUrl, tags
• Créditos: gratis
• Ejemplo:

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

---

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

Consulta el estado de un trabajo y recupera el resultado cuando esté listo.

• Args:
  • jobId (string, requerido)
• Devuelve: jobId, status (pending / processing / success / failed), message, downloadUrl (cuando es exitoso), slidePageCount, createdAt, updatedAt, duration (ms), jobUrl (solo trabajos Nano Banana)
• Créditos: gratis
• Nota: Consulta cada 20 segundos hasta que status sea success o failed.
• Ejemplo:

  { "jobId": "D8h9VYDGdTlZ6wWSEoctF" }
  

---

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

Genera diapositivas (Nano Banana) que coinciden con el estilo de una imagen de referencia.

• Args:
  • userInput (string, requerido) — contenido de la presentación
  • referenceImageUrl (string, requerido) — URL de la imagen de referencia de estilo
  • responseLanguage (string, opcional, predeterminado: Auto)
  • aspectRatio (string, 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 (string, opcional, predeterminado: 2K) — 1K, 2K, 4K
  • page (number, opcional, predeterminado: 0) — 0 = detección automática, 1–100 = número exacto de páginas
  • contentDetail (string, opcional, predeterminado: standard) — concise o standard
  • mode (string, 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)

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

• Args:
  • userInput (string, requerido) — contenido de la presentación
  • designStyle (string, opcional) — descripción en texto libre del estilo visual; déjalo vacío para el estilo predeterminado
  • responseLanguage (string, opcional, predeterminado: Auto)
  • aspectRatio (string, 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 (string, opcional, predeterminado: 2K) — 1K, 2K, 4K
  • page (number, opcional, predeterminado: 0) — 0 = detección automática, 1–100 = número exacto de páginas
  • contentDetail (string, opcional, predeterminado: standard) — concise o standard
  • mode (string, 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ñade narración de voz con IA a un trabajo Nano Banana completado (solo slides_create_like_this o slides_create_pdf_slides; Fast PPT no es compatible). Siempre asíncrono — consulta el resultado con jobs_get.

• Args (un solo locutor, mode: "single" predeterminado):

  • jobId (string, requerido) — UUID de un trabajo Nano Banana completado
  • mode (string, opcional, predeterminado: single) — single o multi
  • speakerName (string, opcional) — nombre del narrador
  • voice (string, opcional) — una de 30 voces (ver lista abajo)
  • contentMode (string, opcional, predeterminado: standard) — concise o standard
  • includeIntro (boolean, opcional, predeterminado: true)

• Args (dos locutores, mode: "multi"):

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

• Voces admitidas (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_pages_voices (POST /api/v1/slides/download-slides-pages-voices)

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

• Args:
  • jobId (string, requerido) — UUID de un trabajo con narración completada
• Devuelve: downloadUrl (expira 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 → obtén un themeId
2. slides_generate (síncrono) → obtén downloadUrl directamente

Nano Banana (diapositivas con diseño personalizado):

1. slides_create_like_this o slides_create_pdf_slides (asíncrono) → obtén jobId
2. jobs_get (consulta cada 20s) → obtén downloadUrl cuando status: "success"

Nano Banana con narración:

1. slides_create_like_this o slides_create_pdf_slides → obtén jobId
2. jobs_get → espera a que las diapositivas se completen
3. slides_generate_narration → obtén jobId de narración
4. jobs_get → espera a que la narración se complete
5. slides_download_pages_voices → obtén el enlace de descarga ZIP

---

Solución de problemas (Claude Desktop)

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

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

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

Referencias

• Construir 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