imagic을 OpenAI Codex CLI에 연결하기

1imagic 설치하고 체험 시작하기

MCP 서버는 imagic Max에 포함돼 있고, 내보내기 500회 무료 체험에서 카드 없이 모든 기능을 쓸 수 있어요. Codex CLI이(가) 연결할 대상이 필요하니 먼저 데스크톱 페이지에서 다운로드하세요.

2Codex CLI에 imagic 추가하기

Codex CLI는 터널이나 원격 엔드포인트 없이 로컬 MCP 서버를 직접 실행해요.

codex mcp add imagic -- imagic-mcp

이 사이트에서 받은 패키지 앱을 설치하셨나요? 그러면 내 컴퓨터에는 imagic-mcp 명령어가 없어요. 앱 자체가 서버예요(Windows 기준이며, macOS에서는 /Applications/imagic.app/Contents/MacOS/imagic이에요):

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

설정

Codex CLI은(는) ~/.codex/config.toml을(를) 읽어요. 최상위 키는 mcp_servers이고, 다른 대부분의 클라이언트가 쓰는 mcpServers 키가 아니에요.

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

이 사이트에서 받은 패키지 앱을 설치하셨나요? 그러면 내 컴퓨터에는 imagic-mcp 명령어가 없어요. 앱 자체가 서버예요. command가 앱을 가리키게 하고 --mcp를 넘기세요(Windows 기준이며, macOS에서 명령어는 /Applications/imagic.app/Contents/MacOS/imagic이에요):

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

그 파일이 있는 위치

OpenAI은(는) 이 경로를 ~ 형태로만 공개하고 Windows에서 어떻게 확장되는지는 문서화하지 않았어요. 그래서 위치를 짐작하지 말고 위의 명령어나 UI를 쓰세요.

3셀렉 요청하기

Codex CLI이(가) 이미 실행 중이었다면 다시 시작하고, 촬영분을 알려 주세요:

D:/Shoots/eva_tom에 있는 촬영분을 셀렉하고, 내 스타일을 적용한 다음, 남길 사진을 내보내 줘.

Codex CLI이(가) scan_directory, analyze_photos, apply_my_style, export_photos를 차례로 호출해요. 이 모든 작업은 내 컴퓨터에서 실행돼요. 에이전트는 지시를 보낼 뿐 사진은 보내지 않아요.

자주 하는 실수

• JSON이 아니라 TOML이고, 키는 밑줄이 있는 mcp_servers예요.
• 프로젝트 범위의 .codex/config.toml은 그 프로젝트를 신뢰할 때만 로드돼요.
• 시작 타임아웃의 기본값은 10초이고 도구 타임아웃은 60초예요. 큰 라이브러리를 여는 데 오래 걸리면 startup_timeout_sec를 늘리세요.
• OpenAI는 config.toml의 Windows용 경로를 따로 공개하지 않아요.

연결한 뒤에 imagic이 할 수 있는 일

라이브러리, 셀렉, 편집, 학습한 스타일을 아우르는 도구가 모두 30개예요. 전체 도구 레퍼런스를 보거나, 무엇을 요청하면 좋을지는 워크플로를 참고하세요.

다른 클라이언트를 설정하시나요?

설정은 OpenAI 문서와 대조해 확인했어요. Codex CLI의 설정이 바뀌어서 이 페이지가 뒤처졌다면 알려 주세요. 고칠게요.