2Slides Logo
Como Usar o Qwen Code com o Servidor MCP do 2Slides (Guia 2026)
2Slides Team
6 min read

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 2slides-mcp
    ). 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.

Stdio (local)Streamable HTTP (remoto)
Chave de config
command
/
args
/
env
httpUrl
Node.js localObrigatórioNão obrigatório
Melhor paraDev localRemoto/CI, configurações enxutas

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
:

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

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
:

{ "mcpServers": { "2slides-remote": { "httpUrl": "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY" } } }

Autenticação por cabeçalho opcional:

"headers": { "Authorization": "Bearer YOUR_2SLIDES_API_KEY" }
.

Ou use o comando
qwen mcp add

# stdio qwen mcp add -e API_KEY=YOUR_2SLIDES_API_KEY 2slides npx 2slides-mcp # Streamable HTTP qwen mcp add --transport http 2slides-remote "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"

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
:

/mcp

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:

读取 ./季度总结.md,生成一个 10 页的季度业务回顾。 先从 2slides 搜索一个简洁的商务主题,再生成 PowerPoint, 最后把下载链接给我。

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

FerramentaO que fazCréditos
themes_search
Encontra um
themeId
para o Fast PPT
Grátis
slides_generate
PowerPoint baseado em tema (Fast PPT), síncrono/assíncrono10 / página
slides_create_pdf_slides
Slides personalizados desenhados com imagem a partir de texto (Nano Banana)100 / página (1K/2K), 200 (4K)
slides_create_like_this
Slides que reproduzem o estilo de uma imagem de referência100 / página (1K/2K), 200 (4K)
slides_generate_narration
Adiciona narração de voz por IA a um job Nano Banana210 / página
slides_download_pages_voices
Exporta páginas + áudio como um ZIPGrátis
jobs_get
Faz polling de um job assíncrono até a conclusãoGrátis

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:

About 2Slides

Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.

Try For Free