imagic을 Claude Code에 연결하기

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

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

2Claude Code에 imagic 추가하기

대시 두 개가 꼭 필요해요. 없으면 Claude Code가 imagic 자체의 플래그를 자기 플래그로 읽어요.

claude mcp add imagic -- imagic-mcp

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

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

설정

Claude Code은(는) .mcp.json(프로젝트) 또는 ~/.claude.json(사용자)을(를) 읽어요. 최상위 키는 mcpServers예요.

{
  "mcpServers": {
    "imagic": {
      "type": "stdio",
      "command": "imagic-mcp"
    }
  }
}

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

{
  "mcpServers": {
    "imagic": {
      "type": "stdio",
      "command": "C:\\Program Files\\imagic\\imagic.exe",
      "args": ["--mcp"]
    }
  }
}

그 파일이 있는 위치

인터페이스에서 찾는 위치

세션 안에서 /mcp를 실행하면 상태를 보고 서버를 켜거나 끌 수 있어요.

3셀렉 요청하기

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

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

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

자주 하는 실수

• 범위는 서버를 추가할 때 정해져요. 기본값은 local이고 이 프로젝트에만 적용돼요. imagic을 어디서나 쓰려면 --scope user를 붙이세요.
• Anthropic 문서는 ~/.claude/mcp.json과 %APPDATA%\Claude\mcp.json은 읽지 않는다고 분명히 밝혀요. 위의 경로만 읽어요.
• 프로젝트 범위 서버는 Claude Code가 처음 볼 때 직접 승인해야 해요.
• .mcp.json을 손으로 고쳤다면 세션을 다시 시작하세요. 세션이 시작될 때 읽어요.

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

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

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

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