2Slides Team
7 min read
Como Usar o OpenClaw com o Servidor MCP do 2Slides (Guia 2026)
Resposta rápida (≤60 palavras): O OpenClaw pode gerar arquivos PowerPoint reais adicionando o servidor MCP do 2Slides sob a chave
mcp.serversem~/.openclaw/openclaw.json. Pegue uma chave em 2slides.com/api, adicione um servidor stdio (command: "npx",args: ["2slides-mcp"],env.API_KEY) ou um remoto (url+transport: "streamable-http") e então peça ao seu agente OpenClaw que monte um deck.
O OpenClaw é um framework de agentes de IA de código aberto, e é um cliente completo do Model Context Protocol (MCP). Conecte o servidor MCP do 2Slides e qualquer agente OpenClaw ganha a capacidade de transformar um briefing — ou um documento que ele consiga ler — em um .pptx finalizado e editável.
Este guia cobre o schema exato de openclaw.json para os dois transportes (stdio local e Streamable HTTP remoto), os atalhos da CLI openclaw mcp, como as ferramentas MCP aparecem nos perfis de ferramentas do agente e como verificar tudo com uma sondagem ao vivo.
Por que dar ao OpenClaw o servidor do 2Slides?
Os agentes OpenClaw raciocinam, planejam e leem seus arquivos. Eles não renderizam arquivos binários de slides — isso é tarefa de um gerador dedicado. Com o 2Slides conectado:
- O OpenClaw decide a estrutura dos slides, o texto e a narrativa a partir do seu material de origem.
- O servidor MCP do 2Slides produz o PowerPoint de verdade — Fast PPT baseado em tema, ou slides desenhados com imagem, com narração de voz por IA opcional e um pacote de recursos exportável.
O que você precisa primeiro
- OpenClaw instalado (
openclawno seu PATH). - Uma chave de API do 2Slides em 2slides.com/api.
- 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?
O servidor MCP do 2Slides suporta os dois. No OpenClaw, os dois são distinguidos simplesmente por quais campos você define — não há campo type:
| Stdio (local) | Streamable HTTP (remoto) | |
|---|---|---|
| Campo identificador | command presente | url presente |
| Campo de transporte | n/a | transport: "streamable-http" |
| Node.js local | Obrigatório | Não obrigatório |
| Melhor para | Agentes locais, controle total | Agentes remotos/hospedados, CI |
Método 1: stdio no openclaw.json
A configuração do OpenClaw fica em ~/.openclaw/openclaw.json. Os servidores MCP vão sob a chave de nível superior mcp, em um objeto servers indexado por nome:
{
"mcp": {
"servers": {
"2slides": {
"command": "npx",
"args": ["-y", "2slides-mcp@latest"],
"env": { "API_KEY": "YOUR_2SLIDES_API_KEY" }
}
}
}
}É só isso — a presença de command o marca como um servidor stdio local.
Método 2: Streamable HTTP no openclaw.json
Para o endpoint hospedado, defina url e o campo canônico transport:
{
"mcp": {
"servers": {
"2slides": {
"url": "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY",
"transport": "streamable-http"
}
}
}
}Nota: o valor de transporte canônico do OpenClaw é
"streamable-http"(um alias legadotype: "http"é aceito, mas normalizado — escrevatransport). Se a sua chave deve ir em um cabeçalho em vez da URL, use"headers": { "Authorization": "Bearer YOUR_2SLIDES_API_KEY" }em vez da query?apikey=.
Ou use a CLI openclaw mcp
Estes gravam na mesma configuração mcp.servers:
# stdio
openclaw mcp add 2slides --command npx --arg 2slides-mcp --env API_KEY=YOUR_2SLIDES_API_KEY
# remoto (define o objeto completo do servidor como JSON)
openclaw mcp set 2slides '{"url":"https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY","transport":"streamable-http"}'Verifique a conexão
O OpenClaw vem com diagnósticos MCP dedicados:
openclaw mcp status --verbose # transporte/auth/timeouts resolvidos (estático, sem conexão)
openclaw mcp doctor 2slides --probe # verificações estáticas, depois um teste de conexão ao vivo
openclaw mcp probe 2slides --json # conecta ao vivo e lista as ferramentas expostas
openclaw mcp reload # descarta runtimes MCP em cache no processoUm probe bem-sucedido lista as ferramentas do 2Slides (slides_generate, themes_search e as demais), confirmando que o agente pode chamá-las.
Como as ferramentas chegam ao seu agente
As ferramentas MCP configuradas são expostas automaticamente nos perfis de ferramentas coding e messaging do OpenClaw. Observações:
- O perfil
minimaloculta as ferramentas MCP; troque de perfil se não as vir. - Para desabilitar as ferramentas MCP explicitamente, adicione
"bundle-mcp"atools.deny. - Para expor apenas algumas ferramentas do 2Slides, use
toolFilter.include/toolFilter.excludepor servidor (nomes exatos ou globs*):
{
"mcp": {
"servers": {
"2slides": {
"command": "npx",
"args": ["-y", "2slides-mcp@latest"],
"env": { "API_KEY": "YOUR_2SLIDES_API_KEY" },
"toolFilter": { "include": ["themes_search", "slides_generate", "jobs_get"] }
}
}
}
}Para manter um servidor definido, porém inativo, defina "enabled": false.
Gere seu primeiro deck
Peça ao seu agente OpenClaw em linguagem natural:
Read PROJECT_BRIEF.md and generate an 8-slide overview deck.
Find a clean "minimal" theme from 2slides first, then create
the PowerPoint and give me the download link.O OpenClaw chama themes_search → slides_generate (Fast PPT) → retorna a downloadUrl. Para slides personalizados desenhados com imagem, ele usa slides_create_pdf_slides e faz polling em jobs_get (a cada cerca de 20 segundos) até ficar pronto.
As ferramentas do MCP do 2Slides
| Ferramenta | O que faz | Créditos |
|---|---|---|
themes_search | Encontra um themeId para o Fast PPT | Grátis |
slides_generate | PowerPoint baseado em tema (Fast PPT), síncrono/assíncrono | 10 / 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ência | 100 / página (1K/2K), 200 (4K) |
slides_generate_narration | Adiciona narração de voz por IA a um job Nano Banana | 210 / página |
slides_download_slides_pages_voices | Exporta páginas + áudio como um ZIP | Grátis |
jobs_get | Faz polling de um job assíncrono até a conclusão | Grátis |
Erros comuns e solução de problemas
- Usou
mcpServersem vez demcp.servers. Na configuração do OpenClaw, a chave émcp.servers. (mcpServersé um conceito diferente, de cliente externo — executar o OpenClaw como um servidor.) - Escreveu
typeem vez detransport.typeé um alias legado; o campo canônico étransport: "streamable-http". - As ferramentas não aparecem. Você provavelmente está no perfil
minimal, outools.denycontémbundle-mcp. Mude paracoding/messaginge executeopenclaw mcp reload. - O servidor stdio não inicia. Confirme que o Node.js está instalado e que
API_KEYestá definido emenv. - Polling de jobs assíncronos. Deixe o agente fazer polling em
jobs_geta cada ~20s; jobs Nano Banana e de narração são assíncronos por padrão.
Perguntas frequentes
O OpenClaw suporta servidores MCP personalizados?
Sim. O OpenClaw é um cliente MCP nativo. Adicione servidores sob a chave mcp.servers em ~/.openclaw/openclaw.json, ou via openclaw mcp add / openclaw mcp set. Tanto o transporte stdio quanto o Streamable HTTP são suportados.
Qual é a chave de configuração dos servidores MCP no OpenClaw?
mcp.servers — um objeto indexado por nome dentro do objeto de nível superior mcp. Servidores locais usam command/args/env; servidores remotos usam url + transport: "streamable-http".
Como confirmo que o 2Slides está conectado?
Execute openclaw mcp probe 2slides --json para uma conexão ao vivo que lista as ferramentas expostas, ou openclaw mcp doctor 2slides --probe para verificações estáticas mais um teste de conexão.
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 e um pacote exportável.
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
mcp.serversnoopenclaw.jsondá a todo agente OpenClaw um gerador de slides. Stdio para local,transport: "streamable-http"para remoto — depoisopenclaw mcp probepara provar que funciona.
Para o contexto 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. Comparando agentes? Veja como usar o Claude Code e o OpenAI Codex com o mesmo servidor.
Pegue sua chave e configuração em 2slides.com/api?tab=mcp e dê ao seu agente OpenClaw um caminho de uma frase até um deck finalizado.
Fontes:
About 2Slides
Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.
Try For Free
