Como Usar o QoderWake com o 2Slides: MCP para Funcionários de IA (2026)

Resposta rápida (≤60 palavras): Encontre o ID do seu Waker com qoderwake waker list --json e execute qoderwake mcp add --waker-id ag_xxx --name 2slides --transport http --http-url https://2slides.com/api/mcp --header "Authorization=Bearer YOUR_2SLIDES_API_KEY". Esse Waker poderá então pesquisar temas no 2Slides e retornar um .pptx editável, sob demanda, via DingTalk ou Feishu, ou conforme um cronograma.

O QoderWake, da equipe Qoder do Alibaba, define seu produto como "Funcionários de IA Autônomos, no Trabalho". Cada funcionário digital é chamado de Waker. Um Waker é acionado por mensagens de IM, agendamentos, eventos de hook ou chamadas de API, e realiza o trabalho por conta própria. O QoderWake roda em macOS 13+, Linux e Windows 10+. Ele possui um console web local em 127.0.0.1:19820 e uma CLI completa, conectando-se ao DingTalk e Feishu.

Servidores e habilidades MCP são vinculados por Waker. Este guia mostra como equipar um Waker (por exemplo, seu "Assistente de Relatórios") com o mecanismo de apresentação do 2Slides. Ele utiliza a referência oficial da CLI do QoderWake e os endpoints do 2Slides que testamos ao vivo em produção em 30 de setembro de 2026.

Por que dar o 2Slides a um Waker?

• Wakers são feitos para trabalho recorrente, e "transformar os números desta semana em um deck" é exatamente esse tipo de tarefa.
• O 2Slides gera o arquivo: um PowerPoint editável baseado em temas (Fast PPT, 10 créditos por página) ou slides com design de imagem (Nano Banana, 100 créditos por página em 1K/2K) com narração por IA opcional.
• O escopo por Waker significa que apenas o Waker que precisa de slides recebe a ferramenta e a chave.

O que você precisa primeiro

1. QoderWake instalado e logado. No macOS ou Linux, a referência da CLI fornece um instalador de linha única:

O pacote para Windows e macOS está disponível no site do QoderWake. Se o shell não encontrar o qoderwake, use ~/.qoderwake/bin/qoderwake.

1. Uma chave de API do 2Slides em 2slides.com/api (sk-2slides-...). Novas contas ganham 500 créditos gratuitos, o que cobre 50 páginas de Fast PPT.
2. Node.js no dispositivo, apenas para o método stdio.

Passo 1: Encontre o ID do Waker

Os IDs de Waker começam com ag_. Copie o ID do Waker que deve criar os decks. Os exemplos abaixo usam ag_xxx.

Método 1: MCP Hospedado via HTTP (recomendado)

Sobre as aspas. A sintaxe da CLI é --header KEY=VALUE (repetível). O valor aqui, Bearer YOUR_2SLIDES_API_KEY, contém um espaço, portanto, envolva todo o par KEY=VALUE em aspas duplas, como mostrado. Sem as aspas, o shell o divide em dois argumentos e o cabeçalho chega apenas como Bearer.

Quer evitar totalmente o processamento de = e espaços? Use a forma JSON da mesma opção, --headers <json>:

No Windows PowerShell, aspas simples também funcionam, mas citar JSON entre diferentes shells pode ser complicado. Nesse caso, a importação baseada em arquivo no Método 2 é a escolha mais segura.

Alternativa sem cabeçalho. Se o cabeçalho ainda assim não chegar (um erro 401 ou Authentication required quando as ferramentas são atualizadas), ignore os cabeçalhos completamente. O 2Slides também aceita a chave como um parâmetro de consulta na URL, e testamos essa forma de ponta a ponta:

Trate essa URL como uma senha: não a cole em tarefas ou capturas de tela e rotacione a chave em 2slides.com/api se ela vazar.

O 2Slides usa uma chave de API simples, não OAuth, portanto, deixe todas as flags --oauth-* desativadas.

Método 2: Importar JSON do MCP

O qoderwake mcp add também aceita --json <json> ou --json-file <path> para importar o JSON do MCP diretamente. Salve isto como 2slides-mcp.json:

A referência da CLI não detalha quais formatos de JSON o importador aceita. O bloco acima é o formato comum mcpServers. Se a importação for rejeitada, use as flags do Método 1, que são totalmente documentadas. Exclua o arquivo depois ou mantenha-o fora de qualquer repositório Git, pois ele contém sua chave.

Método 3: Servidor stdio local

Para rodar o pacote de código aberto 2slides-mcp no dispositivo do Waker:

O --args aceita uma lista separada por vírgulas, o mesmo estilo do exemplo oficial de sistema de arquivos na referência da CLI. O --env aceita JSON. Isso requer Node.js na máquina onde o Waker é executado, e o QoderWake reside no dispositivo por padrão.

Verifique a conexão

Pegue o <mid> de mcp list. Em seguida, envie ao Waker um teste de apenas leitura. A própria orientação do QoderWake é validar um novo conector com uma chamada de apenas leitura primeiro:

O themes_search é gratuito, então este teste não custa nada. Se um conector se comportar mal, o qoderwake mcp toggle --waker-id ag_xxx --mcp-id <mid> --enabled false o desativa sem excluí-lo.

Método 4: Fazer o upload da skill do 2Slides

As skills do QoderWake são pacotes de capacidades com versionamento git que você pode comparar (diff) e reverter. Você faz o upload de "um arquivo Markdown ou um arquivo compactado contendo SKILL.md". A skill oficial do 2Slides está em github.com/2slides/slides-generation-2slides-skills. Compacte-a para que o SKILL.md fique na raiz do arquivo:

Isso deixa de fora o pacote .skill mais antigo do repositório. Os scripts Python da skill (Python 3 e requests) leem a chave da variável de ambiente SLIDES_2SLIDES_API_KEY.

Regra de segredos. A documentação do QoderWake afirma: "Nunca coloque segredos, tokens ou cookies em tarefas, memória, bases de conhecimento, arquivos de função ou capturas de tela". As credenciais pertencem a campos protegidos ou variáveis de ambiente. Portanto, nunca cole sua chave em um prompt de tarefa nem peça ao Waker para "lembrá-la". O QoderWake não documenta uma forma de passar variáveis de ambiente para scripts de skill, por isso recomendamos esta divisão:

• Use o conector MCP (Método 1) para as chamadas de API reais. A chave reside no cabeçalho.
• Use a skill apenas se a variável SLIDES_2SLIDES_API_KEY já estiver configurada no ambiente em que o Waker é executado. Verifique com uma tarefa de teste que execute scripts/search_themes.py --query minimal --limit 1.

Gere seu primeiro deck

O Waker deve chamar themes_search, depois slides_generate, e retornar um downloadUrl. Em nosso teste de produção, um deck Fast PPT de 3 páginas retornou em cerca de 22 segundos. O link expira após 1 hora. A documentação do QoderWake diz que a entrega de arquivos "depende das capacidades do canal. Use o link retornado ou o artefato da tarefa". Portanto, peça ao Waker para postar o link imediatamente ou baixar o .pptx em seu espaço de trabalho. Você pode então extraí-lo da sessão com qoderwake session artifacts --session-id sess_xxx.

Casos de uso para um funcionário de IA

Acionado pelo DingTalk ou Feishu. Uma vez que um Waker é pareado com um canal do DingTalk ou Feishu, um colega de equipe pode enviar uma mensagem: "@Assistente de Relatórios, faça uma atualização de 6 slides sobre o plano de contratação do 4º trimestre". O Waker reúne o contexto, chama o 2Slides e responde com o link.

Um deck semanal agendado. A referência da CLI documenta automações agendadas:

Execute uma vez com run-now e verifique o resultado com qoderwake automation detail antes de deixá-lo rodar por conta própria.

As ferramentas MCP do 2Slides

O que está confirmado vs. o que ainda não foi documentado (em 30 de setembro de 2026)

Solução de problemas

• "daemon unreachable". Execute qoderwake status. Se o daemon não estiver rodando, qoderwake start. Se a porta estiver ocupada, qoderwake start --port auto.
• 401 do próprio QoderWake. Execute qoderwake whoami e qoderwake login novamente, se necessário.
• 401 do 2Slides. O cabeçalho provavelmente chegou sem a chave. Adicione-o novamente com o par --header entre aspas ou o formato JSON --headers.
• Ferramentas ausentes. Execute qoderwake mcp refresh-tools e verifique se o conector está ativado com mcp toggle ... --enabled true.
• Falha no stdio. Verifique se o Node.js está instalado no dispositivo do Waker e se --args está separado por vírgulas.
• Erros em uma execução. qoderwake log --level error --limit 100 ou qoderwake trace list --status failed.
• Link expirado. O downloadUrl dura 1 hora. Peça ao Waker para salvar o arquivo como um artefato de tarefa.

Perguntas frequentes

O QoderWake suporta servidores MCP personalizados?

Sim. Cada Waker pode montar vários servidores MCP via stdio, HTTP ou SSE, usando qoderwake mcp add --waker-id <id> ou a tela de Conectores MCP Personalizados no console.

Qual é o comando exato para adicionar o 2Slides a um Waker?

qoderwake mcp add --waker-id ag_xxx --name 2slides --transport http --http-url https://2slides.com/api/mcp --header "Authorization=Bearer YOUR_2SLIDES_API_KEY". Coloque todo o par de cabeçalho entre aspas, pois o valor contém um espaço.

Onde devo armazenar a chave de API do 2Slides no QoderWake?

No cabeçalho do conector MCP (--header ou --headers) ou em seu --env para stdio. Nunca a coloque em uma tarefa, memória, base de conhecimento ou arquivo de função. A documentação do QoderWake proíbe isso explicitamente.

Um Waker pode enviar o PowerPoint para o DingTalk ou Feishu?

O Waker sempre pode responder com o link de download do 2Slides. Se o arquivo em si será anexado depende do canal. A documentação do QoderWake recomenda usar o link retornado ou o artefato da tarefa. O link expira após 1 hora.

Um Waker pode criar um deck toda semana automaticamente?

Sim. Crie uma automação agendada com qoderwake automation create schedule e uma expressão cron. Teste-a com automation run-now antes de deixá-la rodar sem supervisão.

Quanto custa?

Novas contas do 2Slides recebem 500 créditos gratuitos. O Fast PPT custa 10 créditos por página, então um deck semanal de 8 slides custa 80 créditos. A busca de temas, a consulta de status de trabalhos e as exportações são gratuitas.

Conclusão

Um único comando qoderwake mcp add transforma um Waker em um funcionário de IA que entrega apresentações reais. Mantenha a chave no cabeçalho MCP, acione via DingTalk, Feishu ou um agendamento cron, e salve o .pptx em menos de uma hora.

Guias relacionados: agentes de IA pessoais que criam slides, QwenWork com 2Slides, WorkBuddy com 2Slides, use qualquer agente de IA com o servidor MCP do 2Slides e habilidades de agentes vs servidores MCP.

Obtenha sua chave e configuração em 2slides.com/api?tab=mcp.

Fontes:

• Referência da CLI do QoderWake
• Habilidades e integrações do QoderWake
• Página do produto QoderWake
• API e servidor MCP do 2Slides
• Habilidade 2Slides no GitHub
• 2slides-mcp no GitHub