2slides

oficial

Este é o primeiro, mais fácil e mais barato servidor MCP de geração de PPT, slides e apresentações por IA do mundo.

GitHub
31

O que você pode fazer com 2slides MCP?

  • Pesquisar temas de apresentação — Use themes_search para encontrar um tema por palavra-chave (ex.: "business", "minimal") e obter seu themeId para geração de slides.
  • Gerar slides PowerPoint com tema — Forneça conteúdo e um themeId para slides_generate e receba um arquivo .pptx pronto para download.
  • Criar slides que correspondam a uma imagem de referência — Forneça uma URL de imagem de referência e conteúdo para slides_create_like_this para produzir slides que espelhem o estilo visual da imagem.
  • Criar slides com design personalizado a partir de texto — Use slides_create_pdf_slides com um designStyle em texto livre para gerar slides sem uma imagem de referência.
  • Adicionar narração por voz de IA aos slides — Use slides_generate_narration para anexar narração de um ou dois locutores a um trabalho de slides Nano Banana concluído.
  • Exportar slides e áudio como ZIP — Use slides_download_pages_voices para baixar imagens individuais dos slides, arquivos de áudio por página e uma transcrição para um trabalho narrado.

Documentação

Servidor MCP 2slides

2slides

Exponha as ferramentas do 2slides.com para clientes MCP (ex.: Claude Desktop).

Obtenha sua Chave de API

Antes de usar este servidor MCP, você precisa obter uma chave de API em 2slides.com/api.

Configurar no Claude Desktop

Edite ~/Library/Application Support/Claude/claude_desktop_config.json e adicione:

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

Em seguida, reinicie completamente o Claude Desktop. Em um chat, abra o painel de ferramentas e você deverá ver as ferramentas abaixo.

Ferramentas Disponíveis

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

Gere uma apresentação PowerPoint usando um tema pré-construído (Fast PPT). Use themes_search primeiro para encontrar um themeId.

  • Argumentos:
    • userInput (string, obrigatório) — conteúdo da apresentação
    • themeId (string, obrigatório) — ID do tema de themes_search
    • responseLanguage (string, opcional, padrão: Auto) — idioma de saída; valores suportados: Auto, English, Spanish, Arabic, Portuguese, Indonesian, Japanese, Russian, Hindi, French, German, Greek, Vietnamese, Turkish, Thai, Polish, Italian, Korean, Simplified Chinese, Traditional Chinese
    • mode (opcional, padrão: sync) — sync retorna downloadUrl imediatamente; async retorna um jobId para consultar com jobs_get
  • Créditos: 1 por página
  • Exemplo: 
    {
  "themeId": "st-1756528793701-fcg5fblt2",
  "userInput": "Generate a 5-slide intro to machine learning",
  "responseLanguage": "English",
  "mode": "sync"
}

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

Pesquise temas pré-construídos para usar com slides_generate.

  • Argumentos:
    • query (string, obrigatório) — palavra-chave de pesquisa (ex.: business, minimal, dark)
    • limit (número, opcional, padrão: 10, intervalo: 1–100)
  • Retorna: array de temas com id, name, description, previewUrl, tags
  • Créditos: gratuito
  • Exemplo: 
    { "query": "business", "limit": 5 }

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

Consulte o status de um job e recupere o resultado quando estiver pronto.

  • Argumentos:
    • jobId (string, obrigatório)
  • Retorna: jobId, status (pending / processing / success / failed), message, downloadUrl (em caso de sucesso), slidePageCount, createdAt, updatedAt, duration (ms), jobUrl (somente jobs Nano Banana)
  • Créditos: gratuito
  • Nota: Consulte a cada 20 segundos até que status seja success ou failed.
  • Exemplo: 
    { "jobId": "D8h9VYDGdTlZ6wWSEoctF" }

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

Gere slides (Nano Banana) que correspondam ao estilo de uma imagem de referência.

  • Argumentos:
    • userInput (string, obrigatório) — conteúdo da apresentação
    • referenceImageUrl (string, obrigatório) — URL da imagem de referência de estilo
    • responseLanguage (string, opcional, padrão: Auto)
    • aspectRatio (string, opcional, padrão: 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, padrão: 2K) — 1K, 2K, 4K
    • page (número, opcional, padrão: 0) — 0 = detecção automática, 1–100 = contagem exata de páginas
    • contentDetail (string, opcional, padrão: standard) — concise ou standard
    • mode (string, opcional, padrão: async) — async retorna jobId; sync retorna downloadUrl imediatamente
  • Créditos: 100 por página (1K/2K) ou 200 por página (4K)
  • Exemplo: 
    {
  "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)

Gere slides com design personalizado (Nano Banana) a partir de conteúdo de texto sem uma imagem de referência.

  • Argumentos:
    • userInput (string, obrigatório) — conteúdo da apresentação
    • designStyle (string, opcional) — descrição em texto livre do estilo visual; deixe vazio para estilo padrão
    • responseLanguage (string, opcional, padrão: Auto)
    • aspectRatio (string, opcional, padrão: 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, padrão: 2K) — 1K, 2K, 4K
    • page (número, opcional, padrão: 0) — 0 = detecção automática, 1–100 = contagem exata de páginas
    • contentDetail (string, opcional, padrão: standard) — concise ou standard
    • mode (string, opcional, padrão: async) — async retorna jobId; sync retorna downloadUrl imediatamente
  • Créditos: 100 por página (1K/2K) ou 200 por página (4K)
  • Exemplo: 
    {
  "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)

Adicione narração por voz com IA a um job Nano Banana concluído (somente slides_create_like_this ou slides_create_pdf_slides; Fast PPT não suportado). Sempre assíncrono — consulte o resultado com jobs_get.

  • Argumentos (um locutor, mode: "single" padrão):

    • jobId (string, obrigatório) — UUID de um job Nano Banana concluído
    • mode (string, opcional, padrão: single) — single ou multi
    • speakerName (string, opcional) — nome do narrador
    • voice (string, opcional) — uma das 30 vozes (veja a lista abaixo)
    • contentMode (string, opcional, padrão: standard) — concise ou standard
    • includeIntro (booleano, opcional, padrão: true)

  • Argumentos (dois locutores, mode: "multi"):

    • jobId (string, obrigatório)
    • mode (string, obrigatório) — multi
    • speaker1Name (string, obrigatório)
    • speaker2Name (string, obrigatório)
    • speaker1Voice (string, opcional) — voz para o locutor 1
    • speaker2Voice (string, opcional) — voz para o locutor 2
    • contentMode (string, opcional, padrão: standard) — concise ou standard

  • Vozes suportadas (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 áudio)

  • Exemplo:

    {
  "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)

Exporte páginas de slides e narração em áudio como um arquivo ZIP. O job deve estar concluído e ter narração gerada.

  • Argumentos:
    • jobId (string, obrigatório) — UUID de um job com narração concluída
  • Retorna: downloadUrl (expira em 1 hora), fileName, expiresIn (3600 segundos)
  • Conteúdo do ZIP: 
    pages/
  page_01.png, page_02.png, …
voices/
  page_01.wav, page_02.wav, …
transcript.txt
  • Créditos: gratuito
  • Exemplo: 
    { "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890" }

Fluxos de Trabalho Típicos

Fast PPT (PowerPoint baseado em tema):

  1. themes_search → obtenha um themeId
  2. slides_generate (síncrono) → obtenha downloadUrl diretamente

Nano Banana (slides com design personalizado):

  1. slides_create_like_this ou slides_create_pdf_slides (assíncrono) → obtenha jobId
  2. jobs_get (consulte a cada 20s) → obtenha downloadUrl quando status: "success"

Nano Banana com narração:

  1. slides_create_like_this ou slides_create_pdf_slides → obtenha jobId
  2. jobs_get → aguarde os slides serem concluídos
  3. slides_generate_narration → obtenha jobId da narração
  4. jobs_get → aguarde a narração ser concluída
  5. slides_download_pages_voices → obtenha o link de download ZIP

Solução de Problemas (Claude Desktop)

  • Se as ferramentas não aparecerem no Claude, verifique se o caminho de configuração é absoluto e reinicie o aplicativo.
  • Verifique os logs MCP do Claude:
tail -n 50 -f ~/Library/Logs/Claude/mcp*.log
  • Para servidores MCP stdio, evite registrar logs no stdout; este servidor registra apenas erros no stderr.

Referências