고객·픽업 데이터를 어디서 가져올지 정하는 단계예요. 상황에 따라 세 가지 중 하나를 고르면 됩니다 — 언제든 바꿀 수 있어요.
관리형 (바로 시작)
자체 DB (커넥터)
카페24
이런 분께
DB가 없거나 일단 체험하고 싶을 때
자체 CRM/POS DB(PostgreSQL)가 있을 때
자사몰이 카페24일 때
데이터 위치
저희가 보관 (테넌트 전용 공간, 내보내기 보장)
고객사 서버에 그대로 — 복사 안 함
카페24 API로 조회
설치
클릭 1번 (1분)
전산담당자가 서버에서 명령 1줄 (10분)
API 키 입력
필요한 사람
아무나
전산담당자
쇼핑몰 관리자
1) 관리형 — 클릭 한 번
운영 → 데이터 연결에서 바로 시작을 누르면 끝이에요. 전용 저장 공간이 만들어지고 연습용 데이터(고객 80명)가 채워져요. 나중에 실제 데이터를 올리거나 다른 방식으로 갈아탈 수 있고, 데이터는 언제든 운영 → 데이터 내려받기로 가져갈 수 있어요.
2) 자체 DB — 커넥터 설치
1
서버에서 로그인·연결 (브라우저 승인)
실제 화면 컴포넌트 — 콘솔과 항상 동일
npx @crmforall/connect login # 브라우저 코드 승인 (머신당 1회)
npx @crmforall/connect init # DB 정보 입력 → 등록까지 자동
고객사 서버 터미널에서 — 브라우저 코드 승인 1회 → DB 정보 입력(비밀번호 가림).로그인은 브라우저 디바이스 승인 1회면 끝이에요(토큰 복붙 없음). 승인 직후 신원이 저장돼 중간에 끊기거나 다시 시작해도 재승인 없이 이어집니다.
2
권한 검사 — 자동
설치 과정에서 권한 검사가 자동으로 돌아요 — 읽기 전용인지, 원본 테이블에 쓰기 권한이 없는지 확인하고, 과하면 설치가 거부돼요(보안).
3
콘솔에서 자동 감지
설치가 끝나면 콘솔의 안내 페이지가 자동으로 “설치 완료”로 바뀌고, 운영 → 데이터 연결에 커넥터가 나타나요.
전산담당자가 따로라면(분리 담당자): 콘솔 운영 → 데이터 연결에서 설치 코드(cfit_…, 7일·1회용)를 발급해 전달 → 담당자가 connect init --token=cfit_…로 설치. 또는 터미널 없이 Claude 세션 안에서 setup_login → setup_database로도 연결돼요.
중요한 약속: 자체 DB 방식은 고객 데이터를 저희 서버로 복사하지 않아요. “누구에게 보낼지” 계산은 고객사 서버 안에서 커넥터가 하고, 저희에게는 인원수와 제외 집계만 옵니다. 자세한 구조는 커넥터 설치·운영 (개발자), 커넥터와 플랫폼 MCP의 차이는 연동 구조 한눈에 보기에 있어요.
3) 카페24 — 자사몰 연동
운영 → 데이터 연결에서 카페24를 선택하고 쇼핑몰 ID를 입력하면, 연결 즉시 회원·주문을 표준 모델로 가져와요:
회원 → 고객 (SMS 수신동의 → 마케팅 동의, 전화는 해시로만 저장)
주문(구매확정) → 픽업 + 구매 이벤트(금액·상품군)
그래서 가져온 데이터로 세그먼트·전환 측정·태그·발송 정책이 그대로 동작해요. 연결 목록의 다시 동기화로 최신 회원·주문을 다시 불러올 수 있어요.
※ 실시간 OAuth 연동은 카페24 개발자센터 앱 등록(외부 진행) 후 활성화돼요. 그 전에는 데모(mock) 데이터로 흐름을 체험할 수 있습니다.
연결 후 — 내 데이터 확인하기
운영 → 데이터 보기 — 데이터가 표준 형태(pickup_completed_at 등)로 정리된 모습을 표로 확인. 컬럼을 누르면 그 컬럼이 어떤 변수·조건에 쓰이는지 보여요