가이드
ChatGPT·Claude·Gemini에 매장 연결하는 법 (MCP)
쓰던 ChatGPT·Claude·Gemini에 매장을 연결하는 방법은 세 단계로 끝납니다 — ① 워커AI가 발급한 MCP 서버 주소를 쓰는 AI의 커넥터 설정에 등록하고, ② 처음 연결할 때 뜨는 로그인 창에서 로그인하면 OAuth로 자동 인증되며(토큰을 따로 복사·붙여넣을 필요 없음), ③ 그 뒤로는 '오늘 매출 어땠어?'처럼 평소 말하듯 물으면 AI가 매장 데이터를 불러와 답합니다. 'ChatGPT에 MCP 연결', 'Claude 매장 연결' 같은 검색으로 이 글에 오셨다면, 핵심은 새 앱을 설치하는 게 아니라 이미 쓰는 AI에 서버 주소 하나를 등록하는 것입니다. 이 글은 ChatGPT·Claude·Gemini 각각의 연결 방식 차이와 공통 3단계를 사실 그대로 정리합니다(개인 토큰·매장 주소는 로그인한 대시보드의 '연결 가이드'에서 본인에게만 발급됩니다).
먼저 알아둘 것: 서버 주소 + 인증 방식
AI에 매장을 연결하는 데 필요한 건 두 가지입니다 — '서버 주소(Server URL)'와 '인증'입니다. 서버 주소는 https://mcp.ai-worker.kr/v1/{내 매장 ID} 형태로, 로그인하면 본인에게만 발급됩니다(이 글에는 실제 주소·토큰을 싣지 않습니다). 인증은 두 갈래입니다: 실제로 로그인한 매장은 처음 연결할 때 OAuth 로그인으로 자동 인증돼 토큰을 붙여넣을 필요가 없고, 데모(체험)에서만 Bearer 토큰을 직접 붙여넣는 방식을 씁니다.
- 서버 주소(Server URL) — https://mcp.ai-worker.kr/v1/{내 매장 ID} (로그인 후 본인 전용으로 발급).
- 실제 매장 = OAuth 자동 인증 — 처음 연결 시 로그인 창에서 로그인하면 자동 연결, 토큰 복사·붙여넣기 불필요.
- 데모(체험) = Bearer 토큰 — 체험용에서만 Access Token을 인증 헤더에 직접 입력.
- 개인 토큰·매장 ID는 비밀 — 공개 가이드(이 글)에는 넣지 않고, 로그인한 대시보드의 '연결 가이드' 페이지에서 본인에게만 표시됩니다.
ChatGPT에 연결하기 (커넥터)
ChatGPT는 설정의 '커넥터(Connectors)'에서 MCP 서버를 추가하는 방식입니다. 설정(Settings) → 커넥터(Connectors) → 새 커넥터 추가에서 MCP 서버를 고르고, 커넥터 주소에 본인 서버 URL을 붙여넣으세요. 실제 매장이면 커넥터를 추가할 때 워커AI 로그인 창이 떠 OAuth로 자동 인증되므로 토큰을 따로 넣지 않아도 됩니다(데모만 인증 방식을 Bearer 토큰으로 선택해 Access Token을 붙여넣습니다). 연결되면 '안 답한 네이버 리뷰 있어?'처럼 바로 물어볼 수 있습니다.
- 설정 → 커넥터(Connectors) → 새 커넥터 추가 → MCP 서버 선택.
- 커넥터 주소에 본인 Server URL 입력.
- 실제 매장: 뜨는 로그인 창에서 로그인 → OAuth 자동 인증(토큰 입력 없음).
- 데모: 인증을 Bearer 토큰으로 선택 후 Access Token 붙여넣기.
Claude에 연결하기 (Desktop 설정 파일)
Claude Desktop은 설정 파일에 서버를 추가하는 방식입니다. 앱에서 설정(Settings) → 개발자(Developer) → 설정 편집(Edit Config)을 눌러 claude_desktop_config.json을 열고, mcpServers 안에 워커AI 항목을 추가합니다. 이미 mcpServers가 있다면 그 안에 worker-ai 항목만 넣으면 됩니다. 아래는 비밀값을 뺀 형식 예시입니다(실제 url·token은 본인 대시보드 값으로 교체). 데모는 headers에 Bearer 토큰을 넣고, 실제 매장은 url만 넣은 뒤 처음 연결 시 OAuth로 인증합니다. 파일을 저장하고 앱을 완전히 종료했다 다시 열면 입력창의 커넥터 아이콘에서 worker-ai가 보입니다.
- 데모(토큰 직접): { "mcpServers": { "worker-ai": { "url": "https://mcp.ai-worker.kr/v1/<MERCHANT_ID>", "headers": { "Authorization": "Bearer <ACCESS_TOKEN>" } } } }
- 실제 매장(OAuth): { "mcpServers": { "worker-ai": { "url": "https://mcp.ai-worker.kr/v1/<MERCHANT_ID>" } } } — 처음 연결 시 로그인으로 자동 인증.
- <MERCHANT_ID>·<ACCESS_TOKEN>은 예시 자리표시자 — 실제 값은 로그인한 대시보드 '연결 가이드'에서 확인.
- 저장 후 Claude Desktop을 완전히 종료했다 재시작해야 적용됩니다.
Gemini에 연결하기 (MCP 커넥터)
Gemini는 앱(gemini.google.com)이나 Google AI Studio에서 MCP 커넥터를 추가하는 방식입니다. 설정 → 확장 프로그램(Extensions)/도구 연결에서 'MCP 서버 추가'를 고르고, 엔드포인트 URL에 본인 서버 URL을 붙여넣으세요. 실제 매장이면 연결을 추가할 때 워커AI 로그인 창이 떠 OAuth로 자동 인증되고, 데모만 인증 방식을 Bearer 토큰으로 선택해 Access Token을 입력합니다. 저장하면 Gemini가 워커AI 도구를 인식하고, 채팅에서 도구 아이콘이나 @worker-ai로 연결 상태를 확인할 수 있습니다.
- Gemini 앱/AI Studio → 설정 → 확장 프로그램(Extensions) → MCP 서버 추가.
- 엔드포인트 URL에 본인 Server URL 입력.
- 실제 매장: 로그인 창에서 로그인 → OAuth 자동 인증.
- 데모: 인증을 Bearer 토큰으로 선택 후 Access Token 입력.
- 저장 후 채팅창의 도구 아이콘/@worker-ai로 연결 확인.
연결한 뒤 이렇게 물어보세요
연결되면 평소 말투로 물으면 됩니다. 매출·메뉴·리뷰 같은 조회는 그 자리에서 답하고, 리뷰 답변 게시처럼 매장을 바꾸는 작업은 먼저 확인을 거친 뒤 진행됩니다. 참고로 리뷰 답변·직원 메시지는 현재 '초안'까지 만들어 주며, 게시·발송은 사장님이 직접 합니다.
- "오늘 매출 어땠어?" — 그날 매출과 어제·지난주 대비 증감 요약.
- "어제 김치찌개 몇 그릇 팔렸어?" — 메뉴별 판매량 조회.
- "안 답한 네이버 리뷰 있어?" — 미답변 리뷰 정리(+요청 시 답변 초안).
- "이번주 손님 제일 많은 시간대는?" — 시간대 방문 분석.
- "이번주 매출 전주 대비 어때?" — 기간 비교.
쓰던 AI에 매장 연결하는 법 (공통 3단계)
- 1주소 등록 — 워커AI가 발급한 MCP 서버 주소(https://mcp.ai-worker.kr/v1/{내 매장 ID})를 쓰는 ChatGPT·Claude·Gemini의 커넥터/설정에 추가합니다.
- 2로그인(OAuth) — 처음 연결할 때 뜨는 로그인 창에서 로그인하면 OAuth로 자동 인증됩니다(토큰 복사·붙여넣기 불필요). 데모 체험에서만 Bearer 토큰을 직접 입력합니다.
- 3자연어로 질문 — '오늘 매출 어땠어?'처럼 평소 말하듯 물으면 AI가 워커AI를 통해 매장 데이터를 불러와 답합니다.
자주 묻는 질문
OAuth 자동 인증인가요, 토큰을 직접 붙여넣어야 하나요?
실제로 로그인한 매장은 OAuth 자동 인증입니다 — 처음 연결할 때 뜨는 워커AI 로그인 창에서 로그인하면 자동으로 연결되고, 토큰을 따로 복사·붙여넣을 필요가 없습니다. Bearer 토큰을 직접 인증 헤더에 붙여넣는 방식은 데모(체험) 연결에서만 씁니다. 즉 본인 매장을 연결할 때는 로그인 한 번으로 끝납니다.
연결하는 데 얼마나 걸리나요?
3분 정도면 됩니다. 쓰는 AI의 커넥터 설정에 서버 주소를 등록하고(약 1분), 뜨는 로그인 창에서 로그인해 OAuth로 자동 인증하면(약 1분) 끝입니다. 별도 앱 설치나 개발 지식은 필요 없고, Claude Desktop만 설정 파일을 저장한 뒤 앱을 재시작하는 단계가 있습니다.
내 매장 데이터는 안전한가요?
매장 데이터는 사장님 계정에 연결되어 저장되고, 인증된 본인의 ChatGPT·Claude·Gemini만 접근할 수 있습니다. 연결 요청은 Authorization Bearer 토큰으로 검증되며, 검증되지 않은 요청은 매장 데이터에 접근하지 못합니다. 또한 매출·리뷰 조회처럼 데이터를 읽는 작업과 달리, 리뷰 답변 게시처럼 매장을 실제로 바꾸는 작업은 사장님 확인을 거쳐 실행됩니다.
무료로 쓸 수 있나요?
무료로 시작합니다. 카드 등록 없이 매출·메뉴·시간대·직원·리뷰 조회와 오늘 요약·기간 비교, 리뷰 답변 초안까지 무료로 쓸 수 있습니다(월 200회·데이터 소스 1개 기준). 손익·세무·매출 예측 같은 고급 분석과 자동화를 본격적으로 쓰기 시작하면 그때 프로 상담을 안내드립니다.
연결하면 AI가 매장을 마음대로 바꾸나요?
아닙니다. 매출·메뉴·리뷰 조회 같은 읽기 작업은 바로 답하지만, 리뷰 답변 게시·직원 정보 수정처럼 매장을 바꾸는 작업은 사장님 확인을 거친 뒤에만 실행됩니다. 또한 리뷰 답변·직원 메시지는 현재 규칙 기반 '초안'까지 만들어 주며, 네이버·배민 등 외부 플랫폼 자동 게시와 배민·요기요·POS 자동 연동은 순차 추가 중(Phase 2)입니다.