연동 가이드

AI 도구 안에서 Shopix 사용하기

Claude Code, Codex, Cursor 및 다른 MCP 클라이언트에서 Shopix로 상품 대표 이미지와 상세페이지 이미지를 만들 수 있습니다. 웹 스튜디오를 먼저 열 필요는 없습니다.

연결 3단계

01
접속 키 만들기
Shopix에 로그인한 뒤 대시보드 오른쪽 위 터미널 아이콘에서 접속 키를 만듭니다. 전체 키는 한 번만 표시됩니다.
02
명령 한 줄 실행
Claude Code, Codex, Cursor용 조각을 붙여 넣으세요. 다른 MCP 클라이언트도 같은 주소와 키를 사용할 수 있습니다.
03
평소처럼 말하기
예: “이 상품 사진으로 아마존 대표 이미지 4장 만들어 줘.” 플랫폼, 장수, 품질을 모두 말하지 않아도 기본값으로 진행됩니다.

도구별 설정

Claude Code

터미널에서 아래 한 줄을 실행한 다음, Claude에게 Shopix 이미지 생성을 요청하세요.

claude mcp add --transport http shopix https://shopix-ai.company/api/mcp --header "Authorization: Bearer <YOUR_KEY>"

Codex

~/.codex/config.toml에 추가하세요. Codex 데스크톱과 CLI 모두에서 동작합니다.

# Codex 데스크톱 / CLI 공용
[mcp_servers.shopix]
url = "https://shopix-ai.company/api/mcp"
http_headers = { "Authorization" = "Bearer <YOUR_KEY>" }

Cursor

Cursor MCP 설정에 이 JSON을 합치면 대화에서 Shopix를 호출할 수 있습니다.

{
  "mcpServers": {
    "shopix": {
      "url": "https://shopix-ai.company/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_KEY>"
      }
    }
  }
}

다른 MCP 클라이언트

HTTP MCP를 지원하면 같은 /api/mcp 주소와 Bearer 키를 사용할 수 있습니다.

기본값

항목	기본값
플랫폼	일반. 대화에서 특정 마켓을 말하면 그 마켓을 사용
장수	대표 이미지 기본 4장
품질	실용 버전. 웹과 같은 표준 티어
대화에서 인식	AI가 대화에서 플랫폼, 장수, 품질을 읽습니다

크레딧과 결제

이미지 생성 크레딧은 웹과 같은 규칙입니다. 생성이 시작될 때 차감되고, 실패하거나 시간 초과되면 기존 환불 규칙을 따릅니다. 키 발급 자체는 크레딧을 쓰지 않습니다.

자주 묻는 질문

전체 키는 한 번만 보입니다. 잃어버리면요?

새 키를 만드세요. 기존 키는 바로 만료됩니다. AI 도구 설정도 새 키로 바꾸세요.

팀 하위 계정도 쓸 수 있나요?

없습니다. 메인 계정으로 로그인한 뒤 키를 만드세요.

추가 크레딧이 나가나요?

키 자체는 무료입니다. 이미지 생성은 웹과 같은 크레딧입니다. 부족하면 충전 안내가 나옵니다.

플랫폼, 장수, 품질을 말하지 않으면요?

기본값은 일반 플랫폼, 대표 이미지 4장, 실용 버전입니다. 대화에서 언급하면 그 값이 사용됩니다.

세 가지 도구만 되나요?

준비된 안내는 Claude Code, Codex, Cursor입니다. 다른 MCP 클라이언트도 같은 엔드포인트와 키로 연결할 수 있습니다.