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

Resposta rápida (≤60 palavras): O CLI Qwen Code da Alibaba pode gerar arquivos PowerPoint reais via servidor MCP do 2Slides. Pegue uma chave em 2slides.com/api e adicione uma entrada mcpServers ao ~/.qwen/settings.json — command: "npx", args: ["2slides-mcp"], env.API_KEY para stdio, ou httpUrl: "https://2slides.com/api/mcp?apikey=KEY" para Streamable HTTP. Ou execute qwen mcp add. Depois, peça ao Qwen que monte um deck.

O Qwen Code é o agente de programação de terminal de código aberto da Alibaba (um fork do Gemini CLI), ajustado para a família de modelos Qwen. É um cliente nativo do Model Context Protocol (MCP), então conectar o servidor MCP do 2Slides permite que o Qwen Code transforme um briefing — ou um arquivo no seu repositório — em um .pptx finalizado e editável.

Este guia traz os blocos exatos de ~/.qwen/settings.json para os dois transportes (stdio local e Streamable HTTP remoto), o atalho qwen mcp add e as ferramentas do 2Slides.

Por que conectar o Qwen Code ao 2Slides?

O Qwen Code raciocina sobre código e conteúdo, mas não gera arquivos binários de slides. O servidor MCP do 2Slides é o gerador que faz isso:

• O Qwen Code lê sua origem, planeja o deck e escreve o texto — forte tanto em conteúdo em inglês quanto em chinês.
• O servidor MCP do 2Slides renderiza o PowerPoint de verdade — Fast PPT baseado em tema, ou slides desenhados com imagem, com narração de IA opcional e um pacote exportável.

O 2Slides suporta 20 idiomas de saída, incluindo chinês simplificado e tradicional, então um deck planejado pelo Qwen em chinês é renderizado com quebra de linha CJK correta.

O que você precisa primeiro

1. Qwen Code instalado (qwen no seu PATH).
2. Uma chave de API do 2Slides em 2slides.com/api.
3. Node.js para o transporte stdio (npx -y 2slides-mcp@latest). O transporte HTTP não precisa de nada local.

Stdio vs Streamable HTTP: qual transporte?

Ambos expõem as mesmas ferramentas; a diferença é a chave de configuração.

O nome da chave importa: o Qwen Code (como o Gemini CLI) usa httpUrl para Streamable HTTP e url para SSE legado. Use httpUrl para o endpoint Streamable HTTP do 2Slides.

Método 1: stdio no settings.json

O Qwen Code lê ~/.qwen/settings.json (global) e .qwen/settings.json (projeto). Adicione um bloco mcpServers:

Os valores em env suportam expansão $VAR_NAME se você preferir manter a chave no ambiente do seu shell.

Método 2: Streamable HTTP no settings.json

Para o endpoint hospedado, use httpUrl:

Autenticação por cabeçalho opcional: "headers": { "Authorization": "Bearer YOUR_2SLIDES_API_KEY" }.

Ou use o comando qwen mcp add

Comandos relacionados: qwen mcp list, qwen mcp remove <name> e qwen mcp puro para uma visão interativa de gerenciamento.

Verifique a conexão

Dentro de uma sessão interativa do qwen:

Ele exibe o status da conexão, detalhes de configuração e as ferramentas descobertas por servidor. Use /mcp auth para servidores protegidos por OAuth.

Gere seu primeiro deck

É só pedir — em inglês ou chinês:

O Qwen Code executa themes_search → slides_generate (Fast PPT) com responseLanguage: "Simplified Chinese" → retorna a downloadUrl. Para slides personalizados desenhados com imagem, ele usa slides_create_pdf_slides e faz polling em jobs_get até ficar pronto.

As ferramentas do MCP do 2Slides

Erros comuns e solução de problemas

• Usou url para Streamable HTTP. O Qwen Code trata url como SSE. Use httpUrl para o endpoint Streamable HTTP do 2Slides.
• Servidor DISCONNECTED no /mcp. Verifique a chave de API; para stdio confirme que o Node.js está presente.
• Ferramentas ausentes após edição. Reinicie a sessão, ou rode novamente qwen mcp add.
• Esperar um .pptx só do Qwen. Ele planeja o deck; o 2Slides renderiza o arquivo.
• Idioma de saída errado. Defina o idioma do deck explicitamente para que o conteúdo CJK seja renderizado corretamente (o Qwen passa responseLanguage ao slides_generate).

Perguntas frequentes

O Qwen Code suporta servidores MCP?

Sim. O Qwen Code é um cliente MCP (forkado do Gemini CLI). Configure servidores sob mcpServers em ~/.qwen/settings.json, ou os adicione com qwen mcp add. Tanto stdio quanto Streamable HTTP são suportados.

Qual é a chave de configuração de um servidor Streamable HTTP?

httpUrl. Use url apenas para SSE legado. O endpoint Streamable HTTP do 2Slides vai em httpUrl.

O Qwen Code é bom para decks em chinês?

Sim — os modelos Qwen têm forte cobertura de chinês, e o 2Slides suporta saída em chinês simplificado e tradicional com renderização CJK adequada. A dupla é bem indicada para decks bilíngues e de negócios em chinês.

Isso gera um PowerPoint de verdade?

Sim — slides_generate retorna um .pptx editável. As ferramentas Nano Banana retornam decks desenhados com imagem, com narração de IA opcional.

Onde pego a chave e a configuração?

Em 2slides.com/api?tab=mcp: sua chave, uma configuração pronta para copiar e colar e o endpoint Streamable HTTP.

Conclusão

Uma única entrada mcpServers — command para local, httpUrl para remoto — transforma o Qwen Code em um gerador de slides, em inglês ou chinês. Verifique com /mcp e então é só pedir.

Para o panorama mais amplo, veja como o MCP está mudando os fluxos de trabalho de apresentações e o mapa do ecossistema de servidores MCP de PowerPoint. Usando outro agente? Veja Gemini CLI, Claude Code e OpenAI Codex com o mesmo servidor.

Pegue sua chave e configuração em 2slides.com/api?tab=mcp e gere hoje seu primeiro deck construído com o Qwen.

Fontes:

• Qwen Code — MCP servers (official docs)
• 2Slides API & MCP server