Groble MCP

이 문서는 클로드(Claude)에서 대화만으로 그로블 상품을 올리고 관리하고 싶은 판매자님을 위한 가이드예요.
지금은 베타 참여 판매자님만 사용하실 수 있어요.

1. 그로블 MCP가 무엇인가요?

그로블 웹에 들어가지 않고 클로드와 대화하면서 상품을 올리고 판매를 시작할 수 있는 연결이에요.
“내 전자책 3만원에 팔아줘”라고 말하면 클로드가 상품 초안을 만들고, 판매자님이 확인하면 판매를 시작해 판매 링크를 알려드려요.

MCP(Model Context Protocol)는 클로드 같은 AI가 외부 서비스를 직접 다룰 수 있게 해주는 표준이에요. 그로블이 이 표준에 맞춰 도구 11개를 열어두었고, 클로드가 필요할 때 그 도구를 호출해요.

할 수 있는 일

상품 초안 만들기 (자료, 서비스, 이벤트, 제품 네 가지 유형 모두 가능해요)
이미 만든 상품 확인하고 고치기
판매 시작하기, 판매 중단하기
내 상품 목록 보기
매출 확인하기 (누적 매출과 이번 달 매출)
판매 플랜 고르기
구매자에게 전달할 파일과 상품 대표 이미지 올리기

아직 그로블 웹에서 하셔야 하는 일

주문 하나하나의 상세 내역과 구매자 정보 확인
정산 내역 조회, 환불·취소 처리
기간을 지정한 매출 조회 (누적·이번 달 요약만 제공해요)
쿠폰·추적 링크·웹훅 설정
상품 삭제

클로드가 그로블에서 할 수 있는 일은 위 도구 11개가 전부예요. 그 밖의 요청은 그로블 웹으로 안내해 드려요.

2. 시작하기 전에

준비물 세 가지

준비물	설명
판매 플랜	상품 등록과 매출 조회에 플랜이 필요해요. 무료로 바로 시작하는 플랜도 있으니, 아직 고르지 않으셨다면 클로드에게 말씀하시면 선택을 도와드려요.
베타 참여	베타 참여 판매자님만 사용하실 수 있어요. 고객센터로 참여를 신청해 주세요.
API 키	베타 참여가 확인되면 그로블에서 `grbl_` 로 시작하는 키를 만들어 전달해 드려요.

API 키는 이렇게 다뤄 주세요

키는 전달받은 그 순간에만 볼 수 있어요. 그로블은 키 원문을 저장하지 않아서 다시 알려드릴 수 없어요. 분실하면 새로 발급받으셔야 해요.
이 키 하나로 상품 등록·수정·판매 시작·매출 조회가 모두 가능해요. 비밀번호와 똑같이 다뤄 주세요.
다른 사람에게 보내거나, 공개 저장소·채팅방에 붙여넣지 마세요.
노출된 것 같으면 바로 고객센터로 알려주세요. 해당 키를 폐기하고 새로 발급해 드려요.

3. 연결하기

사용하시는 프로그램에 따라 한 가지만 하시면 돼요.

3-1. 클로드 데스크톱 앱

클로드 앱에 그로블을 등록하는 과정이에요. 처음 한 번만 하시면 되고, 순서대로 따라 하시면 5분쯤 걸려요.

① 먼저 Node.js를 설치해 주세요.
클로드와 그로블을 이어 주는 작은 프로그램이에요. nodejs.org 에 접속해서 LTS 라고 적힌 쪽을 내려받아 실행해 주세요. 설치 화면에서는 계속 ‘다음’을 누르시면 됩니다. 이미 설치되어 있다면 이 단계는 넘어가세요.

② 설정 파일을 열어 주세요.
클로드가 어떤 서비스와 연결할지 적어두는 파일이에요. 아래 방법으로 폴더를 여신 뒤, 그 안의 claude_desktop_config.json 파일을 메모장이나 텍스트 편집기로 열어 주세요. 파일이 없으면 그 이름으로 새로 만드셔도 됩니다.

맥(macOS): 파인더를 켜고 위쪽 메뉴에서 이동 을 누른 뒤 폴더로 이동 을 고르세요. 그다음 ~/Library/Application Support/Claude 를 붙여넣고 엔터를 눌러 주세요.
윈도우(Windows): 파일 탐색기를 켜고 위쪽 주소창에 %APPDATA%\Claude 를 붙여넣은 뒤 엔터를 눌러 주세요.

③ 아래 내용을 붙여넣고 저장해 주세요.
발급받은-키 자리에만 전달받은 키를 바꿔 넣으시면 됩니다. 나머지는 그대로 두세요.

{
  "mcpServers": {
    "groble": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.groble.im/mcp",
        "--header",
        "Authorization: Bearer 발급받은-키",
        "--transport",
        "http-only"
      ]
    }
  }
}

이미 다른 연결을 쓰고 계시다면 mcpServers 안에 "groble" 항목만 추가해 주세요. 파일 전체를 덮어쓰면 기존 연결이 사라져요.

④ 클로드를 껐다가 다시 켜 주세요.
여기서 많이들 놓치시는데, 창을 닫는 것만으로는 안 돼요. 앱을 완전히 종료했다가 다시 실행하셔야 바뀐 설정을 읽어요. 맥은 위쪽 메뉴에서 Claude 를 누르고 Quit, 윈도우는 작업 표시줄의 클로드 아이콘에서 종료를 눌러 주세요.

3-2. 클로드 코드 (터미널)

명령 한 줄이면 끝나요.

claude mcp add --transport http groble https://api.groble.im/mcp \
  --header "Authorization: Bearer 발급받은-키"

등록된 연결은 아래 명령으로 확인하실 수 있어요.

claude mcp list

연결됐는지 확인하기

클로드에게 이렇게 물어봐 주세요.

그로블 연결됐는지 확인해줘

연결이 정상이면 연결됐다고 알려드려요. 이어서 “내 판매 준비 상태 확인해줘”라고 하시면 플랜과 상품 등록 가능 여부까지 확인해 드려요.

4. 첫 상품 올리기

필요한 정보를 한 번에 말씀하지 않으셔도 돼요. 클로드가 빠진 것을 되물어봐요.

내 전자책을 3만원에 팔고 싶어. 제목은 "블로그 글쓰기 30일 챌린지"야.

상품 유형 네 가지

유형	예시	함께 알려주시면 좋은 것
자료	전자책·템플릿·강의자료	구매자가 받을 다운로드 링크 또는 파일
서비스	코칭·컨설팅	누구를 위한 서비스인지, 진행 방식
이벤트	클래스·모임	진행 장소와 시작·종료 일시
제품	실물 상품	무료 배송인지, 유료라면 배송비

정기결제로 파실 상품은 자동으로 ‘서비스’ 유형이 돼요. 그로블 정책상 정기결제는 서비스로만 판매할 수 있어서, 다른 유형으로 요청하셔도 서비스로 바뀌어요. 이때는 몇 개월마다 결제할지(1~12개월)도 함께 알려주셔야 해요.

판매까지의 흐름

초안 저장. 클로드가 상품 초안을 만들어요. 이 단계에서는 아직 아무도 살 수 없으니 마음 놓고 만들어 보세요.
미리보기 확인. 클로드가 미리보기 링크를 알려드려요. 눌러서 실제 판매 페이지가 어떻게 보이는지 확인해 주세요.
판매 시작. 확인이 끝나면 판매를 시작해요. 판매가 시작되면 누구나 구매할 수 있게 되니까, 클로드는 판매를 시작하기 전에 반드시 판매자님께 한 번 더 여쭤봐요.
판매 링크 받기. 판매가 시작되면 공유하실 수 있는 링크를 알려드려요.

빠진 정보가 있으면 초안은 저장되지만 판매를 시작할 수 없어요. 클로드가 무엇이 빠졌는지 알려드리니 그것만 채워주시면 돼요. 채우고 다시 시도하는 데는 제한이 없어요. 실패한 시도는 등록 한도를 쓰지 않으니까요.

가격은 ‘옵션’으로 정해요. 하나짜리 상품이라도 옵션이 최소 한 개는 있어야 해서, 가격을 알려주시면 클로드가 옵션 하나로 만들어 드려요. 여러 가격대로 파실 거라면 옵션을 여러 개 두셔도 돼요.

5. 상품 고치기

바꾸고 싶은 것만 말씀하시면 돼요.

블로그 글쓰기 챌린지 가격을 2만 5천원으로 바꿔줘

수정할 때 알아두실 점

말씀하신 것만 바뀌어요. 가격만 바꾸면 소개글·자료 링크·할인 설정은 그대로 남아요.
값을 비우는 것은 따로 말씀해 주세요. “소개글 지워줘”처럼 명확히 요청하셔야 지워져요. 그냥 언급하지 않는 것은 ‘그대로 두기’로 처리돼요.
판매 중인 상품을 고치면 판매가 멈춰요. 그로블 웹에서 수정할 때와 같아요. 수정이 끝나면 다시 판매를 시작해 주세요. 클로드가 이 안내도 잊지 않고 함께 드려요.
상품 제목은 30자, 옵션 이름은 20자까지예요.

6. 파일 올리기

자료 상품의 전달 파일이나 상품 대표 이미지를 올리실 수 있어요.

용도	형식	크기
구매자 전달 자료	PDF, ZIP	60MB까지
상품 대표 이미지	PNG, JPG, WEBP	5MB까지

업로드가 실제로 끝난 파일만 상품에 붙어요. 주소만 받아두고 올리지 않으면 상품에 넣을 수 없어요.
상품에 붙는 순간 파일이 바뀌지 않는 자리로 옮겨져요. 구매자가 받는 파일이 나중에 다른 내용으로 바뀌는 일을 막기 위한 거예요.
업로드 주소 발급은 시간당 30번까지예요.
수정이 거절돼도 올린 파일은 그대로 다시 쓸 수 있어요. 파일을 새로 붙이면서 다른 값에 문제가 있어 요청이 거절되면, 잘못된 부분만 고쳐서 같은 파일로 다시 요청하시면 돼요. 파일을 다시 올리실 필요가 없어요.

구글 드라이브·노션처럼 외부 링크로 자료를 전달하고 계시다면 파일을 올리지 않고 링크만 알려주셔도 돼요.

7. 안전장치

대화만으로 상품이 바뀌기 때문에, 되돌리기 어려운 일에는 안전장치를 두었어요.

이미 팔린 옵션은 고칠 수 없어요

한 번이라도 판매된 옵션은 내용을 바꿀 수 없고, 목록에서 뺄 수도 없어요. 가격, 이름, 설명, 구매자 전달 자료, 결제 주기, 할인, 재고, 할부 표시, 추가 옵션이 모두 여기에 해당돼요.

구매자가 받는 자료는 ‘구매 시점에 복사해둔 것’이 아니라 지금 상품에 연결된 파일이에요. 그래서 판매 후 자료를 바꾸면 이미 구매하신 분들이 받는 내용까지 통째로 달라져요. 값을 바꾸셔야 한다면 그 옵션은 그대로 두고 새 옵션을 추가해 주세요.

진열 순서만은 언제든 바꾸실 수 있어요. 이미 판매된 내용을 훼손하지 않으니까요.

판매 시작·중단은 확인을 받아요

판매를 시작하면 누구나 구매할 수 있게 되고, 중단하면 구매가 막혀요. 두 경우 모두 클로드가 판매자님께 먼저 확인을 받은 뒤에 진행해요.

사용 한도

전체 요청은 1분에 60번까지
상품 등록(판매 시작)은 1시간에 5개까지
업로드 주소 발급은 1시간에 30번까지

한도를 넘으면 얼마나 기다려야 하는지 알려드려요. 이때는 값을 바꿔 다시 시도해도 통하지 않으니 안내한 시간만큼 기다려 주세요.

한도는 실제로 등록된 상품에만 쌓여요. 빠진 항목 때문에 판매 시작이 거절되면 그 시도는 한도에서 빠져요. 그러니 안내받은 것을 채워 몇 번이든 다시 시도하셔도 괜찮아요.

같은 요청을 두 번 보내도 안전해요

답이 늦거나 연결이 끊겨 클로드가 같은 요청을 다시 보내더라도 상품이 두 개 만들어지지 않아요. 처음 만든 상품을 그대로 다시 알려드려요.

8. 잘 안 될 때

안내 문구	이렇게 해주세요
연동을 사용할 수 없어요	연동이 잠시 꺼져 있어요. 그로블 웹에서 진행해 주세요.
베타 참여 판매자만 사용할 수 있어요	고객센터로 베타 참여를 신청해 주세요.
먼저 판매 플랜을 선택해 주세요	클로드에게 플랜을 선택하고 싶다고 말씀해 주세요.
이 API 키로는 할 수 없는 작업이에요	고객센터로 키 재발급을 요청해 주세요.
입력값이 올바르지 않다는 안내	무엇을 고쳐야 하는지 함께 안내돼요. 그대로 알려주시면 클로드가 다시 시도해요.
한도를 넘었다는 안내	안내된 시간만큼 기다린 뒤 다시 시도해 주세요. 값을 바꿔도 통하지 않아요.
이 상품은 웹에서 수정해 주세요	이미 판매된 옵션을 바꾸려 했을 때 나와요. 새 옵션을 추가하시거나 그로블 웹에서 진행해 주세요.
아직 유형이 정해지지 않았어요	그로블 웹에서 만들다 만 초안이에요. 웹에서 상품 유형(자료·서비스·제품·이벤트)만 고르고 저장하시면, 그다음부터는 클로드로 이어서 하실 수 있어요.
판매할 옵션이 하나도 없어요	가격이 되는 옵션이 모두 내려간 상품이에요. 클로드에게 가격을 알려주고 옵션을 추가한 뒤 다시 판매를 시작해 주세요.
아직 에이전트에서 지원하지 않아요	그로블 웹에서 진행해 주세요.
일시적인 오류가 발생했어요	잠시 후 다시 시도해 주세요. 반복되면 고객센터로 문의해 주세요.

연결 자체가 안 될 때

클로드가 그로블 도구를 못 찾아요.
데스크톱 앱을 완전히 껐다가 다시 켜 보세요. 창만 닫으면 설정 파일을 다시 읽지 않아요. 맥은 화면 위쪽 메뉴에서 Claude > Quit, 윈도우는 작업 표시줄 아이콘에서 종료를 눌러 주세요.
설정 파일을 저장했는데 그대로예요.
파일 형식이 살짝 어긋났을 수 있어요. 쉼표와 중괄호 개수가 맞는지 확인해 주세요. 위 예시를 그대로 복사해서 키 부분만 바꾸시는 것이 가장 안전해요.
npx 를 찾을 수 없다고 나와요.
Node.js가 설치되어 있지 않아서예요. nodejs.org 에서 설치한 뒤 클로드를 다시 켜 주세요.
인증에 실패해요.
키를 붙여넣을 때 앞뒤에 공백이 섞였을 수 있어요. 그리고 Bearer 와 키 사이에는 띄어쓰기 한 칸이 꼭 있어야 해요.

9. 시작 체크리스트

베타 참여 신청 후 API 키 전달받기
키를 안전한 곳에 보관 (다시 확인할 수 없어요)
클로드 데스크톱 또는 클로드 코드에 연결 등록
“그로블 연결됐는지 확인해줘”로 연결 확인
판매 플랜 확인
첫 상품 초안 만들고 미리보기로 확인
확인이 끝나면 판매 시작