MercaderIA 단계별 설치

MercaderIA는 네 가지 구성요소 위에서 동작합니다. 작동 원리를 이해할 필요는 없고, 준비만 되어 있으면 됩니다:

• Node.js: 내부 도구들을 구동하는 엔진입니다.
• Git: 그 도구들이 내부적으로 사용하는 유틸리티입니다.
• Claude Code: 당신의 스토어에서 일할 인공지능입니다.
• MercaderIA: 스토어 전체를 자동화하는 에이전트 시스템입니다.

이 작업은 MercaderIA 다운로드보다 먼저입니다. 공식 사이트에서 LTS라고 표시된 버전을 받으세요.

LTS는 “장기 지원 안정 버전”을 뜻합니다. 버튼이 두 개면 항상 LTS를 고르고 “Current”는 고르지 마세요.

설치할 때는 다음, 다음, 다음. 아무것도 바꾸지 말고 기본값을 그대로 두세요.

정상 설치 확인:

Terminal을(를) 열고(여는 방법은 2단계) 다음을 입력하세요:

v22.14.0 같은 응답이 나오면 완료입니다.

“command not found: node” 라고 나오면 설치가 안 됐거나 재시작하지 않은 것입니다. 재시작 후 다시 시도하세요.

터미널은 텍스트로 명령을 쓰고 Enter를 누르면 프로그램이 답하는 창입니다. 그게 전부입니다. 아무것도 망가뜨리지 않습니다.

maria@MacBook ~ % node --version
v22.14.0
maria@MacBook ~ % 

글자로 가득한 검은색 또는 파란색 창은 완전히 정상입니다. 방금 연 터미널은 원래 그렇게 보입니다.

두 가지 방법이 있습니다. 둘 다 괜찮습니다:

화면에 많은 텍스트가 지나갑니다. 정상입니다. 입력 줄($)이 다시 나타나면 끝난 것입니다.

Claude Code에는 계정이 필요합니다. 처음에는 로그인을 요구합니다. 브라우저 탭이 열리고 Claude 계정으로 로그인해 승인한 뒤 앱으로 돌아옵니다.

MercaderIA는 Claude Code를 처음 설치한 직후 해당 탭을 자동으로 엽니다. Claude가 이미 설치되어 있었다면 로그인되어 있다고 보고 열지 않습니다. 실제로 로그인되어 있지 않다면 터미널을 열고 다음을 입력하면 됩니다:

…그리고 화면에 나오는 안내를 따르세요.

Git, Claude Code, Node.js가 각각 상태와 함께 목록으로 표시되고, 앱이 빠진 항목을 알아서 설치합니다.

• Node.js확인됨 — v22.14.0
• Git설치 중…
• Claude Code찾을 수 없음

앱이 다음 형식으로 스토어 주소를 물어봅니다:

주의: 이 주소이지 스토어의 예쁜 도메인이 아닙니다. Shopify 관리자 → 설정 → 도메인에서 Shopify 내부 도메인으로 표시된 .myshopify.com 주소를 확인하세요.

그다음 브라우저에 Shopify 권한 승인 화면이 열립니다. 목록이 긴 것은 정상입니다. 도우미가 대신 일하려면 상품·주문·재고·배송·반품을 읽고 편집할 수 있어야 합니다. 확인 후 승인하세요.

각 항목을 체크하세요. 다섯 개가 모두 되면 스토어와 대화하며 일을 시작할 수 있습니다.

• Node.js 설치됨 (node --version 응답)
• Claude Code 설치 및 로그인 완료
• MercaderIA에 남은 경고 없음
• Shopify 스토어 연결 및 이름 표시
• MercaderIA 라이선스 활성화