질문답변 · 공통
내가 쓰는 Claude에 우리 매장을 연결하려면 어떻게 하나요?
쓰던 Claude에 매장을 연결하는 건 새 앱 설치가 아니라, Claude Desktop 설정 파일에 워커AI가 발급한 서버 주소 한 줄을 넣고 로그인 한 번 하는 일입니다 — 설정(Settings) → 개발자(Developer) → 설정 편집(Edit Config)을 열어 mcpServers에 worker-ai 항목을 추가하고 앱을 재시작하면 끝입니다. 이미 ChatGPT가 아니라 Claude를 쓰는 얼리어답터 식당 사장님이 'Claude한테 우리 매출·리뷰를 바로 물어보고 싶다' 할 때 보면 되는 글입니다. 핵심은 본인 매장은 토큰을 복사·붙여넣을 필요 없이 처음 연결 시 OAuth 로그인으로 자동 인증된다는 점입니다(토큰 직접 입력은 데모 체험에서만). 개인 서버 주소·토큰은 로그인한 대시보드의 '연결 가이드'에서 본인에게만 발급되며, 이 글에는 싣지 않습니다.
이 글은 사장님 AI 매장운영 서비스 '워커AI'가 직접 작성한 활용 안내입니다. 본문 예시 수치는 데모 매장 기준 예시이며, 실제 매장 숫자와는 다릅니다.
먼저 알아둘 것: Claude는 '설정 파일'에 서버를 추가합니다
ChatGPT가 화면에서 커넥터를 추가하는 방식이라면, Claude Desktop은 설정 파일(claude_desktop_config.json)에 서버 항목을 적어 넣는 방식입니다. 그래서 연결에 필요한 건 딱 두 가지 개념입니다 — '서버 주소(Server URL)'와 '인증'. 서버 주소는 https://mcp.ai-worker.kr/v1/{내 매장 ID} 형태로 로그인하면 본인 전용으로 발급되고, 인증은 본인 매장이면 처음 연결할 때 로그인으로 자동 처리됩니다(데모만 토큰을 직접 입력).
- 서버 주소(Server URL) — https://mcp.ai-worker.kr/v1/{내 매장 ID}, 로그인 후 본인 전용 발급
- 본인 매장 = OAuth 자동 인증 — 설정 파일엔 url만, 토큰 붙여넣기 불필요
- 데모(체험) = Bearer 토큰 — headers에 Access Token을 직접 입력
- 서버 주소·토큰은 비밀 — 공개 글이 아닌 대시보드 '연결 가이드'에서 본인에게만 표시
Claude Desktop에 연결하는 4단계
Claude Desktop 앱 기준 순서입니다. 웹 claude.ai가 아니라 데스크톱 앱에서 설정 파일을 여는 것이 핵심이고, 마지막에 앱을 '완전히 종료했다 재시작'해야 적용된다는 점만 놓치지 않으면 됩니다. 사장님이 자주 막히는 곳은 두 군데입니다 — 콤마(,)·따옴표(") 같은 JSON 형식이 어긋나면 항목이 안 뜨고, 재시작을 안 하면 방금 저장한 설정이 반영되지 않습니다.
- 1단계 — 설정 열기: Claude Desktop에서 설정(Settings) → 개발자(Developer) → 설정 편집(Edit Config)을 눌러 claude_desktop_config.json을 엽니다.
- 2단계 — worker-ai 추가: mcpServers 안에 worker-ai 항목을 넣습니다. 본인 매장은 url만, 데모는 headers에 Bearer 토큰을 넣습니다(실제 값은 대시보드 '연결 가이드'에서 복사).
- 3단계 — 재시작: 앱을 완전히 종료했다 다시 엽니다. 본인 매장이면 이때 로그인 창이 떠 OAuth로 자동 인증됩니다.
- 4단계 — 확인: 입력창의 커넥터(🔌) 아이콘에서 worker-ai가 보이면 연결 완료입니다.
막혔을 때 점검 포인트
연결이 안 보이거나 답을 못 할 때, 개발 지식 없이도 스스로 확인할 수 있는 것들입니다. 대부분은 형식 오타, 재시작 누락, 또는 웹 claude.ai에서 시도한 경우입니다.
- 설정 파일 형식: 따옴표(")와 콤마(,)가 빠지거나 더해지지 않았는지 확인. JSON은 형식 한 글자만 어긋나도 항목이 안 뜹니다.
- 앱 재시작: 창만 닫지 말고 완전히 종료(Quit) 후 다시 열기. 재시작 없이는 저장한 설정이 반영되지 않습니다.
- 데스크톱 앱 여부: 설정 파일 방식은 Claude Desktop 앱 전용입니다(웹 claude.ai가 아님).
- 주소·인증 재확인: url이 본인 매장 주소인지, 데모라면 토큰을 정확히 붙여넣었는지 대시보드 '연결 가이드'와 대조.
연결한 뒤 이렇게 물어보세요
연결되면 명령어를 외울 필요 없이 평소 말투로 물으면 됩니다. 매출·메뉴·리뷰 같은 조회는 그 자리에서 답하고, 리뷰 답변 게시처럼 매장을 바꾸는 작업은 먼저 확인을 거친 뒤 진행됩니다. 리뷰 답변·직원 메시지는 '초안'까지 만들어 드리며 게시·발송은 사장님이 직접 합니다.
- "오늘 매출 어땠어?" — 그날 매출 + 어제·지난주 대비 증감 요약
- "어제 김치찌개 몇 그릇 팔렸어?" — 메뉴별 판매량 조회
- "안 답한 네이버 리뷰 있어?" — 미답변 리뷰 정리(+요청 시 답변 초안)
- "이번주 손님 제일 많은 시간대는?" — 시간대 방문 분석
- "이번주 매출 전주 대비 어때?" — 기간 비교
실제로 이렇게 답합니다 (예시)
데모 매장 '김씨네 한식당'(90일치 가상 데이터)을 Claude Desktop에 MCP로 연결한 뒤, 사장님이 평소 말투로 물어본 대화입니다. 수치는 모두 데모 기준 예시입니다.
명령어를 외울 필요 없이 평소 말투로 물으면 Claude가 매출·메뉴·리뷰를 한 번에 불러와 답합니다. 조회는 바로, 리뷰 답변은 '초안'까지만 만들고 게시는 사장님 몸입니다.
위 예시는 데모 매장 데이터 기준이며, 실제 매장 숫자는 다릅니다. 워커AI에 내 매장을 연결하면 내 데이터로 답합니다.
Claude에 매장 데이터를 붙이는 현실 대안 비교
| 구분 | 워커AI MCP 연결 | 엑셀 파일 첨부 | 복사·붙여넣기 수기 입력 |
|---|---|---|---|
| 연결 방식 | 설정에 서버 주소 1회 등록(+로그인) 후 계속 사용 | 물어볼 때마다 파일을 채팅에 첨부 | 필요한 숫자를 직접 타이핑해 넣음 |
| 데이터 최신성 | 물어보는 시점의 매장 데이터를 자동으로 불러옴 | 첨부한 그 파일 시점에 고정(매번 새로 받아 올려야 함) | 사람이 챙긴 만큼만 최신 |
| 할 수 있는 일 | 매출·메뉴·시간대·리뷰·인건비·손익까지 자연어 질의(추정 항목은 추정으로 표기) | 올린 표 범위 안에서 계산·요약 | 물어본 그 숫자에 대한 단발 계산 |
| 한계·주의 | 외부 플랫폼 자동 게시·POS 자동연동은 Phase 2(준비 중), 게시는 사장님 확인 | 원본을 직접 관리해야 하고 누락·버전 꼬임 위험 | 양 많아지면 번거롭고 입력 오류 가능 |
가끔 한 번, 단순한 표 하나만 보면 될 때는 엑셀 첨부가 더 간편할 수 있습니다. 매일·반복적으로 매장 데이터를 물어볼 때 연결 방식이 유리합니다. 상황에 맞게 고르세요.
자주 묻는 질문
Claude 연결은 무료인가요? 카드가 필요한가요?
무료로 시작하고 카드 등록도 필요 없습니다. 매출·메뉴·시간대·리뷰 조회와 오늘 요약·기간 비교, 리뷰 답변 초안까지 무료 범위에서 쓸 수 있습니다(월 200회·데이터 소스 1개 기준 예시). 손익·세무·매출 예측 같은 고급 분석을 본격적으로 쓰기 시작할 때 프로 상담을 안내드립니다.
토큰을 직접 복사·붙여넣어야 하나요?
본인 매장을 연결할 때는 그럴 필요가 없습니다. 처음 연결할 때 워커AI 로그인 창이 뜨고, 로그인하면 OAuth로 자동 인증됩니다(설정 파일엔 url만 넣음). Bearer 토큰을 헤더에 직접 붙여넣는 방식은 데모(체험) 연결에서만 씁니다.
Claude가 우리 매장을 마음대로 바꾸나요?
아닙니다. 매출·메뉴·리뷰 조회 같은 읽기 작업은 바로 답하지만, 리뷰 답변 게시나 직원 정보 수정처럼 매장을 바꾸는 작업은 사장님 확인을 거친 뒤에만 진행됩니다. 리뷰 답변·직원 메시지는 현재 '초안'까지 만들어 드리고, 네이버 등 외부 게시와 배민·요기요·POS 자동연동은 순차 추가 중(Phase 2)입니다.
우리 매장 데이터는 안전한가요?
매장 데이터는 사장님 계정에 연결되어 저장되고, 인증된 본인의 Claude만 접근할 수 있습니다. 연결 요청은 인증을 거쳐 검증되며, 검증되지 않은 요청은 매장 데이터에 닿지 못합니다. 세무·인건비 금액은 '추정'이며 최종 확인은 세무사·노무사에게 받으시길 권합니다.