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 2slides -e API_KEY=xxx -- npx -y 2slides-mcp@latest 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 .pptx 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 .pptx 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 -y 2slides-mcp@latest 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:

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 -y 2slides-mcp@latest).
• 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 .mcp.json resultante (escopo de projeto) fica assim — você também pode editá-lo manualmente:

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

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

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

Verifique a conexão

Ou, dentro de uma sessão interativa, execute o comando de barra /mcp 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:

Nos bastidores, o Claude Code executa themes_search para encontrar um themeId, depois slides_generate (Fast PPT) e te entrega uma downloadUrl. 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 (slides_create_pdf_slides), fará polling em jobs_get 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_slides_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 claude mcp add (transportes stdio, SSE ou HTTP), lista-os com claude mcp list e os inspeciona na sessão com /mcp. O servidor do 2Slides funciona com todos eles.

Stdio ou Streamable HTTP — qual devo usar?

Use stdio na sua máquina local (ela executa npx -y 2slides-mcp@latest 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 (slides_generate) retorna um .pptx 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 --scope project para gravar um .mcp.json compartilhado que você versiona no repositório. Os colegas de equipe são solicitados a aprová-lo no primeiro uso. Use --scope user 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