Como Usar o Claude Code com o Servidor MCP do 2Slides (Guia 2026)

Resposta rápida (≤60 palavras): O Claude Code pode gerar arquivos PowerPoint reais ao se conectar ao servidor MCP do 2Slides. Pegue uma chave de API em 2slides.com/api e execute

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

para stdio local, ou

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

para Streamable HTTP remoto. Depois, é só pedir ao Claude Code que monte um deck.

O Claude Code é o agente de programação baseado em terminal da Anthropic, e ele fala o Model Context Protocol (MCP) nativamente. Isso significa que você pode dar a ele uma ferramenta que transforma texto em um arquivo

finalizado sem nunca sair do seu shell. O servidor MCP do 2Slides é essa ferramenta: um conector leve que expõe as APIs de geração de slides, temas, narração e exportação do 2Slides como ferramentas MCP que o Claude Code pode chamar diretamente.

Este guia mostra as duas formas de conectar — stdio local e Streamable HTTP remoto — qual escolher, o que cada ferramenta faz e os prompts exatos que transformam um pedido de uma linha em um PowerPoint pronto para download.

Por que conectar o Claude Code ao 2Slides?

O Claude Code é excelente em raciocinar sobre o seu repositório, redigir conteúdo e estruturar um argumento. O que ele não consegue fazer sozinho é gerar um

real e editável, com formas, gráficos, temas e notas do orador. Isso é um problema de geração de arquivos, e cabe a uma ferramenta dedicada.

A divisão é clara:

• O Claude Code lê o seu material de origem (um README, uma especificação, um CSV, uma nota de pesquisa), raciocina sobre ele e decide o que entra em cada slide.
• O servidor MCP do 2Slides pega esse plano e renderiza um arquivo PowerPoint de verdade — ou slides baseados em imagem com narração de voz por IA e exportação em MP4.

Você fica no terminal o tempo todo. Pede, espera ~30–60 segundos e recebe uma URL de download.

O que você precisa primeiro

1. Claude Code instalado e autenticado (
   claude
   no seu PATH).
2. Uma chave de API do 2Slides. Crie uma em 2slides.com/api. A mesma página tem uma configuração MCP pronta para copiar e colar e o endpoint Streamable HTTP.
3. Node.js (para o transporte stdio, que executa
   npx 2slides-mcp
   localmente). O transporte HTTP não precisa de nada local.

Stdio vs Streamable HTTP: qual transporte?

O servidor MCP do 2Slides suporta dois transportes. Ambos expõem o mesmo conjunto de ferramentas; diferem apenas em onde o conector é executado.

Regra prática: use stdio na sua própria máquina para o trabalho do dia a dia, e Streamable HTTP quando o Claude Code roda em algum lugar onde você não pode instalar Node (uma máquina remota, um job de CI, um container restrito).

Método 1: Conectar via stdio (local)

Execute isto uma vez. O separador

divide as flags do próprio Claude Code do comando que ele inicia:

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

Alguns pontos que vale conhecer:

• Mantenha
  --transport stdio
  (ou outra flag) entre
  --env
  e o nome do servidor. Como
  --env
  aceita múltiplos pares
  KEY=value
  , colocar o nome logo depois pode fazer a CLI interpretar o nome como mais uma variável de ambiente.
• Tudo após
  --
  é passado ao servidor sem alterações (
  npx 2slides-mcp
  ).
• Adicione
  --scope user
  para tornar o 2Slides disponível em todos os projetos, ou
  --scope project
  para versioná-lo em um
  .mcp.json
  compartilhado com a sua equipe.

O

resultante (escopo de projeto) fica assim — você também pode editá-lo manualmente:

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

Método 2: Conectar via Streamable HTTP (remoto)

Sem instalação local — basta apontar o Claude Code para o endpoint hospedado:

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

Prefere manter a chave fora da URL? Envie-a como cabeçalho:

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

Verifique a conexão

claude mcp list          # 2slides deve aparecer e conectar
claude mcp get 2slides   # mostra sua configuração e as ferramentas descobertas

Ou, dentro de uma sessão interativa, execute o comando de barra

para ver os servidores conectados, a contagem de ferramentas e (para servidores remotos) o status de autenticação.

Gere seu primeiro deck

Uma vez conectado, você não chama as ferramentas manualmente — apenas pede. O Claude Code encadeia as ferramentas do 2Slides automaticamente:

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.

Nos bastidores, o Claude Code executa

para encontrar um , depois (Fast PPT) e te entrega uma . Tempo total: cerca de 30–60 segundos para um PowerPoint com tema.

Quer slides personalizados, desenhados com imagem, em vez de um modelo? Peça isso e o Claude Code usará o caminho Nano Banana (

), fará polling em até ficar pronto e retornará o link.

As ferramentas do MCP do 2Slides

O Claude Code enxerga estas ferramentas depois de conectado:

Três encadeamentos típicos:

• Fast PPT:
  themes_search
  →
  slides_generate
  (síncrono) → download.
• Nano Banana:
  slides_create_pdf_slides
  (assíncrono) →
  jobs_get
  → download.
• Recursos de vídeo narrado: criar slides →
  jobs_get
  →
  slides_generate_narration
  →
  jobs_get
  →
  slides_download_pages_voices
  .

Erros comuns e solução de problemas

• O servidor não aparece em
  claude mcp list
  . Para stdio, verifique se a ordem
  --env
  /nome está correta (mantenha uma flag entre
  --env
  e o nome). Para HTTP, confira novamente a URL e se a chave de API é válida.
• API_KEY
  ausente. O servidor stdio precisa da variável de ambiente; o servidor HTTP precisa de
  ?apikey=
  ou um cabeçalho
  Authorization
  . Não confunda os dois.
• Pedir um
  .pptx
  sem a ferramenta. Sem o 2Slides conectado, o Claude Code consegue escrever um roteiro, mas não gerar um PowerPoint real. Conecte o servidor primeiro.
• Esquecer o tema. Se você não executar
  themes_search
  nem nomear um estilo, o Fast PPT escolhe um por você. Especifique-o para controlar a aparência.
• Polling rápido demais. Jobs assíncronos (Nano Banana, narração) devem ser consultados com
  jobs_get
  a cada cerca de 20 segundos, e não em um loop apertado.

Perguntas frequentes

O Claude Code suporta servidores MCP nativamente?

Sim. O Claude Code é um cliente MCP de primeira classe. Você adiciona servidores com

(transportes stdio, SSE ou HTTP), lista-os com e os inspeciona na sessão com . O servidor do 2Slides funciona com todos eles.

Stdio ou Streamable HTTP — qual devo usar?

Use stdio na sua máquina local (ela executa

por você) e Streamable HTTP em qualquer lugar onde você não possa ou não queira instalar Node — CI, containers, servidores remotos. Ambos expõem as mesmas ferramentas e produzem saída idêntica.

Isso gera um arquivo PowerPoint de verdade?

Sim. O caminho Fast PPT (

) retorna um editável, com formas e temas reais. Os caminhos Nano Banana retornam decks desenhados com imagem e podem adicionar narração de voz por IA e recursos exportáveis. São arquivos que você pode abrir, editar e apresentar — não capturas de tela.

Onde pego a chave de API e a configuração?

Em 2slides.com/api?tab=mcp. Essa página mostra sua chave, uma configuração stdio pronta para colar e a URL do endpoint Streamable HTTP.

Posso compartilhar o servidor do 2Slides com minha equipe?

Sim. Adicione-o com

para gravar um compartilhado que você versiona no repositório. Os colegas de equipe são solicitados a aprová-lo no primeiro uso. Use para uma configuração privada, válida para todos os projetos.

Conclusão

O Claude Code faz o pensamento; o servidor MCP do 2Slides faz o arquivo. Conecte uma vez — stdio para local, Streamable HTTP para remoto — e "monte um deck para mim" vira uma única frase no seu terminal.

Se você vive dentro do Claude Code, esse é o caminho mais rápido de uma ideia (ou de um arquivo no seu repositório) até um PowerPoint pronto e editável. Para uma visão mais ampla de como conectar slides a agentes, veja como o MCP está mudando os fluxos de trabalho de apresentações e o mapa completo do ecossistema de servidores MCP de PowerPoint. Usando o app de desktop em vez da CLI? Veja como usar o Claude MCP para gerar apresentações.

Pegue sua chave e configuração em 2slides.com/api?tab=mcp e gere seu primeiro deck pelo terminal em menos de um minuto.

Fontes:

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