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 -y 2slides-mcp@latest (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 -y 2slides-mcp@latest. 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 .pptx finalizado e editável, tudo a partir do terminal.

Este guia traz os blocos exatos de config.toml para os dois transportes (stdio local e Streamable HTTP remoto), o atalho de uma linha codex mcp add, 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 -y 2slides-mcp@latest). 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 ~/.codex/config.toml e adicione:

Campos opcionais que o Codex suporta para servidores stdio incluem cwd, startup_timeout_sec (padrão 10s) e tool_timeout_sec (padrão 60s). Se preferir repassar uma variável de ambiente existente em vez de inline da chave, use env_vars = ["API_KEY"].

Ou use o atalho codex mcp add

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

Tudo após -- é o comando do servidor. Execute codex mcp --help 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:

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:

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 missing field command in mcp_servers até você habilitar o cliente experimental. Se isso acontecer com você, adicione:

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

Verifique a conexão

Ou, dentro da TUI do Codex, execute /mcp para ver os servidores ativos e suas ferramentas. (Os subcomandos de gerenciamento codex mcp ainda estão evoluindo; codex mcp --help é a fonte definitiva para o seu build.)

Gere seu primeiro deck

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

O Codex executa themes_search para encontrar um themeId, depois slides_generate (Fast PPT), e retorna uma downloadUrl — um PowerPoint de verdade em cerca de 30–60 segundos. Peça slides desenhados com imagem e ele muda para slides_create_pdf_slides, fazendo polling em jobs_get 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 ~/.codex/config.toml sob [mcp_servers.NAME], ou os adiciona com codex mcp add. Tanto servidores stdio quanto HTTP remotos são suportados.

Onde o Codex armazena a configuração MCP?

Em ~/.codex/config.toml (global). Projetos confiáveis também podem usar um .codex/config.toml local do projeto. Cada servidor MCP é uma tabela [mcp_servers.NAME].

Stdio ou Streamable HTTP?

O stdio executa npx -y 2slides-mcp@latest na sua máquina e é o padrão para o trabalho local. O Streamable HTTP aponta para o endpoint hospedado https://2slides.com/api/mcp 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 — slides_generate retorna um .pptx 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