2slides

Servidor MCP 2slides

Exponha as ferramentas do 2slides.com para clientes MCP: gere apresentações PowerPoint e slides com design personalizado, adicione narração por voz com IA e receba os arquivos finalizados como links de download.

Obtenha Sua Chave de API

Antes de conectar, obtenha uma chave de API em 2slides.com/api.

Conectar

O 2slides executa um endpoint MCP Streamable HTTP hospedado e também oferece este pacote stdio. Ambos expõem as mesmas 7 ferramentas para a mesma conta e os mesmos créditos.

	Streamable HTTP	stdio (este pacote)
Configuração	um comando, nada para instalar	requer Node.js 18+, npx baixa o pacote
Atualizações	no servidor, sempre atualizado	rebaixado na sua máquina
Executa em	qualquer cliente MCP com suporte remoto	qualquer cliente que possa iniciar um processo local

Opção 1 — Streamable HTTP (recomendado)

A documentação MCP da Anthropic chama o HTTP de "a opção recomendada para conectar servidores MCP remotos", e o 2slides é um serviço hospedado sem arquivos ou processos locais para acessar, então comece por aqui.

Claude Code

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

Verifique com claude mcp list — o servidor deve reportar ✔ Connected.

Configuração do projeto (.mcp.json, compartilhada com sua equipe)

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

Claude Desktop / claude.ai: adicione como um conector personalizado em claude.ai/customize/connectors com a mesma URL.

Opção 2 — stdio (processo local)

Use esta opção quando o cliente só puder iniciar processos locais, quando a máquina não tiver rota direta para 2slides.com, ou quando você quiser fixar e corrigir o servidor você mesmo.

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 no Windows):

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

A flag -y permite que o npx instale o pacote sem solicitar confirmação. Reinicie completamente o Claude Desktop depois; em um chat, abra o painel de ferramentas e você deve 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: grátis
• Exemplo:

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

---

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

Consulte o status de um trabalho 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 (apenas trabalhos Nano Banana)
• Créditos: grátis
• 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 o 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 trabalho Nano Banana concluído (apenas 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, padrão mode: "single"):

  • jobId (string, obrigatório) — UUID de um trabalho Nano Banana concluído
  • mode (string, opcional, padrão: single) — single ou multi
  • speakerName (string, opcional) — nome do locutor
  • 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_slides_pages_voices (POST /api/v1/slides/download-slides-pages-voices)

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

• Argumentos:
  • jobId (string, obrigatório) — UUID de um trabalho 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: grátis
• 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 a conclusão dos slides
3. slides_generate_narration → obtenha a narração jobId
4. jobs_get → aguarde a conclusão da narração
5. slides_download_slides_pages_voices → obtenha o link de download do ZIP

---

Solução de Problemas (Claude Desktop)

• Se as ferramentas não aparecerem no Claude, verifique se o caminho da 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 só registra erros no stderr.

Referências

• Construa um servidor MCP (documentação oficial): https://modelcontextprotocol.io/docs/develop/build-server
• Documentação da API 2slides: https://2slides.com/api
• 2slides: https://2slides.com
• Modelos 2slides: https://2slides.com/templates