imagic을 Amazon Q Developer에 연결하기

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

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

2Amazon Q Developer에 imagic 추가하기

CLI는 파일을 대신 써 주기 때문에, 아래의 두 파일 혼동을 피할 수 있어요.

q mcp add --name imagic --command imagic-mcp

설정

Amazon Q Developer은(는) ~/.aws/amazonq/mcp.json(전역) 또는 .amazonq/mcp.json(워크스페이스)을(를) 읽어요. 최상위 키는 mcpServers예요.

{
  "mcpServers": {
    "imagic": {
      "command": "imagic-mcp",
      "args": []
    }
  }
}

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

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

그 파일이 있는 위치

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

인터페이스에서 찾는 위치

Amazon Q Developer 패널, Chat, 도구 아이콘, 더하기 순서예요.

3셀렉 요청하기

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

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

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

자주 하는 실수

• AWS는 두 파일 사이에서 이전을 진행하는 중이에요. IDE는 이제 default.json에 쓰고, mcp.json은 기본값이 true인 useLegacyMcpJson 설정으로 계속 작동해요. CLI는 mcp.json을 읽어요.
• 같은 서버 이름이 둘 다 있으면 워크스페이스 설정이 전역 설정보다 우선해요.
• timeout 필드의 단위는 밀리초이고 기본값은 120000이에요.
• AWS는 이 경로를 물결표(~) 형태로만 공개하고, Windows용으로 풀어 쓴 경로는 없어요.

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

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

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

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