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

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 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 e onde o conector roda.

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 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
:

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

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
:

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

Prefere autenticação por cabeçalho? Adicione um objeto

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

Ou use o comando
gemini mcp add

# stdio (-e define variáveis de ambiente) gemini mcp add -e API_KEY=YOUR_2SLIDES_API_KEY 2slides npx 2slides-mcp # Streamable HTTP gemini mcp add --transport http 2slides-remote "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"

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:

/mcp

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:

Read ./notes/market-update.md and generate a 9-slide briefing. Find a professional theme from 2slides, build the PowerPoint, and give me the download link.

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

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 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:

About 2Slides

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

Try For Free