Como Usar o Gemini CLI com o Servidor MCP do 2Slides (Guia 2026)

Resposta rápida (≤60 palavras): O Gemini CLI do Google pode gerar arquivos PowerPoint reais via servidor MCP do 2Slides. Pegue uma chave em 2slides.com/api e adicione uma entrada mcpServers ao ~/.gemini/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 gemini mcp add. Depois, peça ao Gemini que monte um deck.

O Gemini CLI é o agente de IA de terminal de código aberto do Google, e ele fala o Model Context Protocol (MCP). Conecte-o ao servidor MCP do 2Slides e o Gemini pode transformar um prompt — ou um arquivo no seu diretório de trabalho — em um .pptx finalizado e editável.

Este guia traz os blocos exatos de settings.json para os dois transportes (stdio local e Streamable HTTP remoto), o atalho gemini mcp add e o que cada ferramenta do 2Slides faz.

Por que conectar o Gemini CLI ao 2Slides?

O Gemini é um raciocinador multimodal forte, mas não gera arquivos binários .pptx sozinho. O servidor MCP do 2Slides é o gerador dedicado:

• O Gemini CLI lê sua origem, planeja os slides e escreve o texto.
• 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 que você precisa primeiro

1. Gemini CLI instalado (gemini 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 e onde o conector roda.

O nome da chave importa: o Gemini CLI usa httpUrl para Streamable HTTP e url para SSE legado. Para o endpoint Streamable HTTP do 2Slides, use httpUrl.

Método 1: stdio no settings.json

O Gemini CLI lê ~/.gemini/settings.json (global) e .gemini/settings.json (projeto). Adicione um bloco mcpServers:

Os valores em env também podem referenciar variáveis de shell (por exemplo, "API_KEY": "$TWOSLIDES_API_KEY") se você preferir não inserir a chave inline.

Método 2: Streamable HTTP no settings.json

Para o endpoint hospedado, use httpUrl:

Prefere autenticação por cabeçalho? Adicione um objeto headers: "headers": { "Authorization": "Bearer YOUR_2SLIDES_API_KEY" }.

Ou use o comando gemini mcp add

Estes gravam as mesmas entradas mcpServers no settings.json. As flags incluem -t, --transport (stdio | sse | http), -e, --env, -H, --header e --timeout.

Verifique a conexão

Dentro de uma sessão interativa do gemini, execute:

Ele mostra o status de cada servidor (CONNECTED / CONNECTING / DISCONNECTED) e as ferramentas descobertas. Use /mcp auth se um servidor remoto exigir OAuth.

Gere seu primeiro deck

É só pedir:

O Gemini CLI executa 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 até o deck ficar pronto.

As ferramentas do MCP do 2Slides

Erros comuns e solução de problemas

• Usou url para o endpoint Streamable HTTP. O Gemini CLI trata url como SSE. Use httpUrl para o Streamable HTTP do 2Slides.
• O servidor aparece como DISCONNECTED no /mcp. Verifique a chave de API e, para stdio, confirme que o Node.js está instalado.
• Nenhuma ferramenta listada. Reinicie a sessão após editar o settings.json, ou rode novamente gemini mcp add.
• Nenhum .pptx sem a ferramenta. O Gemini sozinho rascunha um roteiro; o 2Slides produz o arquivo.
• Polling apertado. Deixe o Gemini fazer polling em jobs_get a cada cerca de 20 segundos para jobs assíncronos Nano Banana / de narração.

Perguntas frequentes

O Gemini CLI suporta servidores MCP?

Sim. O Gemini CLI é um cliente MCP. Configure servidores sob mcpServers em ~/.gemini/settings.json, ou os adicione com gemini mcp add. Os transportes stdio, SSE e Streamable HTTP são todos suportados.

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

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

Onde o Gemini CLI armazena a configuração MCP?

~/.gemini/settings.json (global) ou .gemini/settings.json (projeto). O bloco MCP é a chave de nível superior mcpServers.

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 a URL do endpoint Streamable HTTP.

Conclusão

Uma única entrada mcpServers — command para local, httpUrl para remoto — transforma o Gemini CLI em um gerador de slides. Verifique com /mcp e então é só pedir um deck.

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. Trabalhando em outro agente de terminal? Veja Claude Code, OpenAI Codex e Qwen Code com o mesmo servidor.

Pegue sua chave e configuração em 2slides.com/api?tab=mcp e gere seu primeiro deck pelo Gemini CLI em menos de um minuto.

Fontes:

• Gemini CLI — MCP servers (official docs)
• 2Slides API & MCP server