Como Usar o OpenAI Codex com o Servidor MCP do 2Slides (Guia 2026)

Resposta rápida (≤60 palavras): O OpenAI Codex pode produzir arquivos PowerPoint reais adicionando o servidor MCP do 2Slides ao

~/.codex/config.toml

. Pegue uma chave em 2slides.com/api e adicione um bloco

[mcp_servers.2slides]

executando

npx 2slides-mcp

(stdio) ou um bloco com

url = "https://2slides.com/api/mcp?apikey=KEY"

(Streamable HTTP). Ou execute

codex mcp add 2slides --env API_KEY=xxx -- npx 2slides-mcp

. Depois, peça ao Codex que monte um deck.

O OpenAI Codex é o agente de programação por CLI de código aberto da OpenAI, e é um cliente do Model Context Protocol (MCP). Conecte-o ao servidor MCP do 2Slides e o Codex pode transformar um briefing — ou um arquivo no seu repositório — em um

finalizado e editável, tudo a partir do terminal.

Este guia traz os blocos exatos de

para os dois transportes (stdio local e Streamable HTTP remoto), o atalho de uma linha , o que cada ferramenta do 2Slides faz e o detalhe específico de versão a observar com servidores HTTP.

Por que combinar o Codex com o 2Slides?

O Codex raciocina sobre código e conteúdo; ele não gera arquivos binários de slides por conta própria. O servidor MCP do 2Slides preenche essa lacuna. A divisão de trabalho:

• O Codex lê sua origem (especificação, README, arquivo de dados), planeja os slides e decide a narrativa.
• 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 de recursos exportável.

Você pede em linguagem natural; o Codex chama as ferramentas; um link de download volta.

O que você precisa primeiro

1. Codex CLI instalado (
   codex
   no seu PATH).
2. Uma chave de API do 2Slides em 2slides.com/api — essa página também tem a configuração MCP e o endpoint Streamable HTTP.
3. Node.js para o transporte stdio (que executa
   npx 2slides-mcp
   ). O transporte HTTP não precisa de nada local.

Stdio vs Streamable HTTP: qual transporte?

O servidor MCP do 2Slides oferece os dois. As mesmas ferramentas de qualquer forma — a diferença é onde o conector roda.

Use stdio na sua estação de trabalho; use Streamable HTTP quando o Codex rodar onde você não pode instalar Node.

Método 1: stdio no config.toml

Edite

e adicione:

[mcp_servers.2slides]
command = "npx"
args = ["2slides-mcp"]

[mcp_servers.2slides.env]
API_KEY = "YOUR_2SLIDES_API_KEY"

Campos opcionais que o Codex suporta para servidores stdio incluem

, (padrão 10s) e (padrão 60s). Se preferir repassar uma variável de ambiente existente em vez de inline da chave, use .

Ou use o atalho

codex mcp add

Sem precisar editar arquivo — isto escreve o bloco para você:

codex mcp add 2slides --env API_KEY=YOUR_2SLIDES_API_KEY -- npx 2slides-mcp

Tudo após

é o comando do servidor. Execute para a lista completa de subcomandos na versão que você tem instalada.

Método 2: Streamable HTTP no config.toml

Aponte o Codex para o endpoint hospedado:

[mcp_servers.2slides_remote]
url = "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"

Se preferir autenticação por cabeçalho em vez de uma chave na query string, o Codex suporta uma variável de ambiente com bearer token e cabeçalhos estáticos:

[mcp_servers.2slides_remote]
url = "https://2slides.com/api/mcp"
bearer_token_env_var = "TWOSLIDES_TOKEN"

Detalhe de versão (importante): o Codex roteia servidores MCP HTTP através do seu cliente MCP em Rust. As versões recentes configuram isso automaticamente, mas alguns builds mais antigos dão erro com

até você habilitar o cliente experimental. Se isso acontecer com você, adicione:

[features]
experimental_use_rmcp_client = true

Verifique

primeiro — lançamentos mais novos já incorporam isso, e a flag está sendo renomeada para . Mostre este bloco apenas como fallback, caso sua versão reclame.

Verifique a conexão

codex mcp list      # lista os servidores MCP configurados
codex mcp get 2slides

Ou, dentro da TUI do Codex, execute

para ver os servidores ativos e suas ferramentas. (Os subcomandos de gerenciamento ainda estão evoluindo; é a fonte definitiva para o seu build.)

Gere seu primeiro deck

Você não invoca as ferramentas manualmente — você pede:

Read ./docs/launch-plan.md and generate a 10-slide launch deck.
Use a modern, dark business theme from 2slides. Return the
download link when it's done.

O Codex executa

para encontrar um , depois (Fast PPT), e retorna uma — um PowerPoint de verdade em cerca de 30–60 segundos. Peça slides desenhados com imagem e ele muda para , fazendo polling em até o arquivo ficar pronto.

As ferramentas do MCP do 2Slides

Erros comuns e solução de problemas

• missing field command in mcp_servers
  em um servidor HTTP. Sua versão do Codex precisa de
  experimental_use_rmcp_client = true
  em
  [features]
  . Atualize o Codex ou adicione a flag.
• Cabeçalhos de tabela TOML vs tabelas inline.
  [mcp_servers.2slides.env]
  é uma subtabela; se você usar inline, escreva
  env = { API_KEY = "..." }
  na linha do servidor — não misture os dois estilos.
• O nome do servidor deve ser único. Cada servidor é indexado pelo segmento
  [mcp_servers.NAME]
  ; reutilizar um nome sobrescreve o bloco anterior.
• Nenhum
  .pptx
  sem a ferramenta. O Codex sozinho consegue rascunhar um roteiro, mas não gerar um PowerPoint. Adicione o 2Slides primeiro.
• Timeouts de ferramenta em decks grandes. Jobs grandes ou narrados podem ultrapassar o
  tool_timeout_sec
  padrão de 60s; aumente-o, ou deixe o Codex fazer polling em
  jobs_get
  para jobs assíncronos.

Perguntas frequentes

O OpenAI Codex suporta servidores MCP?

Sim. O Codex é um cliente MCP. Você configura servidores em

sob , ou os adiciona com . Tanto servidores stdio quanto HTTP remotos são suportados.

Onde o Codex armazena a configuração MCP?

Em

(global). Projetos confiáveis também podem usar um local do projeto. Cada servidor MCP é uma tabela .

Stdio ou Streamable HTTP?

O stdio executa

na sua máquina e é o padrão para o trabalho local. O Streamable HTTP aponta para o endpoint hospedado e não precisa de nada instalado — ideal para CI e ambientes remotos. As mesmas ferramentas, a mesma saída.

Isso gera um PowerPoint de verdade?

Sim —

retorna um editável. As ferramentas Nano Banana retornam decks desenhados com imagem e podem adicionar narração de IA mais um pacote de recursos exportável.

Onde pego a chave e a configuração?

Em 2slides.com/api?tab=mcp: sua chave de API, uma configuração pronta para copiar e colar e a URL do endpoint Streamable HTTP.

Conclusão

Adicione um bloco

[mcp_servers.2slides]

ao

config.toml

(ou execute

codex mcp add

), e o Codex ganha uma ferramenta que transforma qualquer briefing em um PowerPoint finalizado — sem sair do terminal.

O Codex é um agente forte de raciocínio; o 2Slides é o gerador de arquivos que faltava. 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. Prefere o agente da Anthropic? Veja como usar o Claude Code com o servidor MCP do 2Slides.

Pegue sua chave e a configuração exata em 2slides.com/api?tab=mcp e entregue hoje seu primeiro deck gerado pelo Codex.

Fontes:

• OpenAI Codex — Model Context Protocol (official docs)
• OpenAI Codex — Configuration Reference
• 2Slides API & MCP server