Collega imagic a OpenAI Codex CLI

1Installa imagic e inizia la prova

Il server MCP è incluso in imagic Max, e la prova gratuita da 500 esportazioni sblocca tutto senza carta. Scarica prima l'app dalla pagina desktop, perché Codex CLI ha bisogno di qualcosa con cui parlare.

2Aggiungi imagic a Codex CLI

Codex CLI esegue direttamente i server MCP locali, senza tunnel e senza endpoint remoto.

codex mcp add imagic -- imagic-mcp

Hai installato l'app dal nostro sito? Allora sul tuo computer non c'è nessun comando imagic-mcp: il server è l'app stessa (qui Windows; su macOS è /Applications/imagic.app/Contents/MacOS/imagic):

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

Configurazione

Codex CLI legge ~/.codex/config.toml. La chiave di primo livello è mcp_servers, che non è la chiave mcpServers usata dalla maggior parte degli altri client.

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

Hai installato l'app dal nostro sito? Allora sul tuo computer non c'è nessun comando imagic-mcp: il server è l'app stessa. Imposta command sul percorso dell'app e passa --mcp (qui Windows; su macOS il comando è /Applications/imagic.app/Contents/MacOS/imagic):

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

Dove si trova quel file

OpenAI pubblica questo percorso solo nella forma con ~ e non documenta alcuna espansione su Windows, quindi usa il comando o l'interfaccia qui sopra invece di indovinare dove finisce.

3Chiedi una selezione

Riavvia Codex CLI se era già aperto, poi chiedigli di lavorare su uno shooting:

Seleziona lo shooting in D:/Shoots/eva_tom, applica il mio stile ed esporta le foto tenute.

Codex CLI richiamerà in sequenza scan_directory, analyze_photos, apply_my_style ed export_photos. Ognuno di questi gira sul tuo computer: l'agente invia istruzioni, mai le tue foto.

Errori comuni

• È TOML, non JSON, e la chiave è mcp_servers con il trattino basso.
• Un .codex/config.toml a livello di progetto viene caricato solo se ti fidi del progetto.
• Il timeout di avvio è di 10 secondi per impostazione predefinita e quello degli strumenti di 60; alza startup_timeout_sec se una libreria grande è lenta ad aprirsi.
• OpenAI non pubblica alcun percorso specifico per Windows per config.toml.

Cosa può fare imagic una volta connesso

In tutto sono 25 strumenti, che coprono la libreria, la selezione, l'editing e il tuo stile appreso. Vedi il riferimento completo degli strumenti, o i flussi di lavoro per sapere cosa chiedere davvero.

Configuri un altro client?

Configurazione verificata sulla documentazione di OpenAI. Se Codex CLI cambia la sua configurazione e questa pagina resta indietro, faccelo sapere e la correggeremo.