Conecte o imagic ao OpenAI Codex CLI

1Instale o imagic e comece o teste

O servidor MCP vem com o imagic Max, e o teste grátis de 500 exportações libera tudo, sem cartão. Baixe-o antes na página do desktop, porque o Codex CLI precisa de algo com quem conversar.

2Adicione o imagic ao Codex CLI

O Codex CLI executa servidores MCP locais diretamente, sem túnel e sem endpoint remoto.

codex mcp add imagic -- imagic-mcp

Instalou o app empacotado a partir deste site? Então não existe o comando imagic-mcp na sua máquina: o próprio app é o servidor (exemplo para Windows; no macOS é /Applications/imagic.app/Contents/MacOS/imagic):

codex mcp add imagic -- "C:\Program Files\imagic\imagic.exe" --mcp

Configuração

O Codex CLI lê ~/.codex/config.toml. A chave de nível superior é mcp_servers, que não é a chave mcpServers que a maioria dos outros clientes usa.

[mcp_servers.imagic]
command = "imagic-mcp"

Instalou o app empacotado a partir deste site? Então não existe o comando imagic-mcp na sua máquina: o próprio app é o servidor. Aponte command para ele e passe --mcp (exemplo para Windows; no macOS o comando é /Applications/imagic.app/Contents/MacOS/imagic):

[mcp_servers.imagic]
command = "C:\\Program Files\\imagic\\imagic.exe"
args = ["--mcp"]

Onde esse arquivo fica

A OpenAI publica esse caminho só na forma com ~ e não documenta nenhuma expansão no Windows, então use o comando ou a interface acima em vez de adivinhar onde ele vai parar.

3Peça uma triagem

Reinicie o Codex CLI se ele já estava aberto e depois aponte para uma sessão de fotos:

Faça a triagem da sessão em D:/Shoots/eva_tom, aplique o meu estilo e exporte as escolhidas.

O Codex CLI vai chamar scan_directory, analyze_photos, apply_my_style e export_photos, em sequência. Cada uma delas roda na sua máquina: o agente envia instruções, nunca as suas fotos.

Armadilhas comuns

• Isto é TOML, e não JSON, e a chave é mcp_servers, com sublinhado (_).
• Um .codex/config.toml com escopo de projeto só é carregado se você confiar no projeto.
• O tempo limite de inicialização é de 10 segundos por padrão e o de ferramenta é de 60; aumente startup_timeout_sec se uma biblioteca grande demorar para abrir.
• A OpenAI não publica um caminho específico do Windows para o config.toml.

O que o imagic pode fazer depois de conectado

São 25 ferramentas no total, cobrindo a biblioteca, a triagem, a edição e o seu estilo aprendido. Veja a referência completa das ferramentas ou os fluxos de trabalho para saber o que pedir de fato.

Configurando outro cliente?

Configuração verificada na documentação da OpenAI. Se o Codex CLI mudar a configuração e esta página ficar para trás, avise a gente e vamos corrigir.