1Instala o imagic e começa a avaliação
O servidor MCP vem com o imagic Max, e a avaliação gratuita de 500 exportações desbloqueia tudo sem cartão. Transfere-o primeiro a partir da página de computador, porque o Codex CLI precisa de algo com que comunicar.
2Acrescenta o imagic ao Codex CLI
O Codex CLI corre servidores MCP locais diretamente, sem túnel e sem endpoint remoto.
codex mcp add imagic -- imagic-mcp
Instalaste a aplicação empacotada a partir deste site? Então não existe um comando imagic-mcp no teu computador: a própria aplicação é o servidor (mostrado 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 topo é mcp_servers, que não é a chave mcpServers que a maioria dos outros clientes usa.
[mcp_servers.imagic] command = "imagic-mcp"
Instalaste a aplicação empacotada a partir deste site? Então não existe um comando imagic-mcp no teu computador: a própria aplicação é o servidor. Aponta command para ela e passa --mcp (mostrado 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 fica esse ficheiro
| macOS | ~/.codex/config.toml |
|---|---|
| Linux | ~/.codex/config.toml |
OpenAI publica este caminho apenas na forma ~ e não documenta nenhuma expansão no Windows, por isso usa o comando ou a interface acima em vez de adivinhares onde vai parar.
3Pede uma seleção
Reinicia o Codex CLI se já estava a correr e aponta-o para uma sessão:
Seleciona a sessão em D:/Shoots/eva_tom, aplica o meu estilo e exporta as fotografias a manter.
O Codex CLI vai chamar, por ordem, scan_directory, analyze_photos, apply_my_style e export_photos. Cada uma delas corre no teu computador: o agente envia instruções, nunca as tuas fotografias.
Coisas em que as pessoas costumam cair
- Isto é TOML, não JSON, e a chave é mcp_servers, com um sublinhado.
- Um .codex/config.toml com âmbito de projeto só é carregado se confiares no projeto.
- O tempo limite de arranque é por predefinição de 10 segundos e o das ferramentas de 60; aumenta startup_timeout_sec se uma biblioteca grande demorar a abrir.
- A OpenAI não publica nenhum caminho específico do Windows para o config.toml.
O que o imagic pode fazer depois de ligado
São 30 ferramentas no total, que cobrem a biblioteca, a seleção, a edição e o teu estilo aprendido. Vê a referência completa das ferramentas, ou os fluxos de trabalho para saberes o que pedir na prática.
Vais configurar outro cliente?
Experimenta numa sessão real
A avaliação de 500 exportações inclui o imagic Max, o servidor MCP e todas as ferramentas desta página. Sem cartão.
Configuração verificada na documentação do OpenAI. Se o Codex CLI mudar a sua configuração e esta página ficar desatualizada, diz-nos e corrigimos.