# MCP 연동 가이드

출처 https://www.groble.im/help/guides/mcp

전체 가이드 목록 https://www.groble.im/llms.txt

---

이 문서는 Claude나 ChatGPT 같은 AI와 대화하면서 상품을 만들고 관리하려는 판매자님을 위한 가이드예요.

## 1\. Groble MCP가 무엇인가요?

> **그로블에 직접 접속하지 않아도 AI와 대화하면서 상품을 등록하고 판매할 수 있도록 도와주는 기능이에요.**
> 
> “내 전자책을 3만 원에 팔아줘”라고 말하면 AI가 상품 초안을 만들고, 판매자님이 확인하면 판매를 시작해 공유할 링크까지 알려드려요.

Groble MCP를 연결하면 AI가 판매자님이 허용한 범위 안에서 상품을 등록하고 수정하는 일을 대신할 수 있어요.

[영상: Groble MCP 활용 예시를 영상으로 확인해 보세요.](https://image.groble.im/article/2026/09/44c210d9-c13c-4f5b-990e-34d76c1134fb_%E1%84%80%E1%85%B3%E1%84%85%E1%85%A9%E1%84%87%E1%85%B3%E1%86%AF-%E1%84%80%E1%85%A7%E1%86%AF%E1%84%8C%E1%85%A6%E1%84%8E%E1%85%A1%E1%86%BC-%E1%84%88%E1%85%A1%E1%84%85%E1%85%B3%E1%86%AB%E1%84%91%E1%85%A1%E1%86%AB-%E1%84%89%E1%85%A9%E1%84%80%E1%85%A2-%E1%84%82%E1%85%AE%E1%84%80%E1%85%AE%E1%84%82%E1%85%A1-4K.mp4)

### 이렇게 시작해요

> 1.  **연결하기**  
>     사용하는 AI에 Groble MCP 주소를 추가하고 그로블 계정으로 로그인해요.
>
> 2.  **상품 만들기**  
>     팔고 싶은 상품과 가격을 AI에게 알려 주세요. AI와 함께 필요한 내용을 채우고 초안으로 저장해요.
>
> 3.  **미리보기 확인하기**  
>     AI가 알려준 링크에서 구매자에게 보일 화면을 확인해요.
>
> 4.  **판매 시작하기**  
>     판매자님이 최종 확인하면 AI가 판매를 시작하고 공유할 링크를 알려드려요.

### Groble MCP로 할 수 있는 일

-   **판매 준비하기**  
    현재 멤버십 플랜을 확인하고, 아직 플랜이 없다면 Pro 기본형 또는 Pro 구독형을 선택할 수 있어요.
    
-   **상품 만들고 수정하기**  
    자료·서비스·이벤트·제품 상품의 제목, 가격, 옵션, 소개, 이미지, 구매자에게 제공할 자료, 판매 기간을 설정하고 고칠 수 있어요.
    
-   **상품 미리보기 확인하기**  
    판매 페이지와 결제창이 구매자에게 어떻게 보이는지 판매 전에 확인할 수 있어요.
    
-   **판매 관리하기**  
    상품 판매를 시작하거나 중단하고, 중단한 판매를 다시 시작할 수 있어요.
    
-   **매출 현황 확인하기**  
    누적·이번 달 매출과 판매 건수, 누적 고객 수, 정산 예정 금액도 조회할 수 있어요.
    

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

-   주문별 상세 내역과 구매자 정보 확인
    
-   정산 상세 내역 조회, 환불과 취소 처리
    
-   원하는 기간을 지정한 매출 조회
    
-   쿠폰, 추적 링크, 웹훅 설정
    
-   상품 삭제
    
-   기존 모든 구매자의 정기결제를 해지하는 판매 종료
    

이 작업들은 [그로블 판매 관리](https://groble.im/manage/store/products)에서 직접 진행해 주세요.

## 2\. 시작하기 전에

### 준비물

| 준비물 | 설명 |
| --- | --- |
| 그로블 계정 | AI로 만든 상품은 연결한 그로블 계정에 등록돼요.<br>상품을 판매할 계정을 준비해 주세요. |
| 그로블 멤버십 | MCP 이용에 필요해요.<br>Pro 기본형 또는 Pro 구독형을 선택해 주세요. |
| MCP를 지원하는 AI | AI에서 그로블 상품을 관리하려면 MCP 연결을 지원하는 서비스를 사용해야 해요. 지원 환경은 아래 표에서 확인해 주세요. |

**AI 서비스의 요금제와 그로블 멤버십은 별개예요.**  
AI 서비스 이용료는 사용 중인 AI의 요금제에 따라 달라져요.  
그로블의 구독료와 수수료는 [멤버십 안내](https://groble.im/pro)에서 자세히 확인해 주세요.

그로블 멤버십이 없다면 AI에게 플랜 선택을 요청해 주세요.

-   **Pro 기본형**  
    플랜을 선택하면 바로 시작할 수 있어요.
    
-   **Pro 구독형**  
    AI가 알려준 결제 페이지에서 직접 결제해 주세요.  
    결제를 마친 뒤 AI에게 판매 준비 상태를 다시 확인해 달라고 말씀해 주세요.
    

> AI에 그로블을 연결하는 기능은 사용 중인 AI 서비스의 요금제와 조직 정책에 따라 이용이 제한될 수 있어요.

### 어떤 환경에서 연결할 수 있나요?

| 사용 환경 | 연결 전 확인할 점 |
| --- | --- |
| Claude 웹·데스크톱 앱 | Free는 사용자 지정 커넥터 1개를 사용할 수 있어요.<br>Pro·Max도 지원하며, Team·Enterprise는 조직 소유자가 먼저 커넥터를 추가해야 해요. |
| ChatGPT 웹 | 플러그인 메뉴에서 새 플러그인으로 그로블 MCP를 추가해요.<br>요금제와 조직 정책에 따라 플러그인 추가·사용이 제한될 수 있어요. |
| ChatGPT 데스크톱 앱 | 좌측 상단 모드에서 Codex를 선택해야 해요.<br>플러그인 메뉴에서 새 플러그인으로 그로블 MCP를 추가해요. |
| Claude Code·Codex CLI | 해당 도구가 설치되어 있어야 해요. 서버 주소를 등록한 뒤 그로블 로그인을 별도로 완료해 주세요. |

메뉴나 제공 범위가 달라졌다면 [Claude 공식 안내](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp)와 [ChatGPT 공식 안내](https://developers.openai.com/api/docs/guides/developer-mode)를 확인해 주세요.

## 3\. 연결하기

필요한 주소는 하나예요. 아래 주소를 복사해 주세요.

```
https://mcp.groble.im/mcp
```

### 3-1. Claude 앱과 웹에서 연결하기

1.  Claude에서 **사용자 지정(Customize) → 커넥터(Connectors)**를 여세요. 화면에 따라 설정 안에 커넥터 메뉴가 보일 수도 있어요.
    
2.  **추가 → 커스텀 커넥터 추가**를 누르세요. 이름은 **Groble**, 주소는 `https://mcp.groble.im/mcp`로 입력하세요.  
    입력한 뒤 **계속** 또는 **추가**를 눌러 주세요.
    
3.  Claude 데스크톱 앱에서는 인증과 OAuth 클라이언트를 선택한 뒤 **추가**를 눌러 주세요. 선택할 항목은 아래 ‘Claude 데스크톱 앱의 인증 설정’ 안내에서 확인할 수 있어요.
    
4.  그로블 커넥터를 추가한 뒤 **연결**을 누르고, 아래 3-4절의 그로블 로그인과 권한 허용을 마쳐 주세요.
    
5.  새 대화의 **\+ → 커넥터**에서 그로블을 켜 주세요. 커넥터를 추가한 뒤에도 대화에서 그로블을 켜야 사용할 수 있어요.
    

![Claude의 커스텀 커넥터 추가 창에 Groble 이름과 MCP 서버 주소를 입력한 화면](https://image.groble.im/article/2026/09/4a6a3b3b-8570-4f0b-ad16-d828db38b176_image.png)

*이름과 MCP 서버 주소를 입력한 뒤 계속을 눌러 주세요.*

**Claude 데스크톱 앱의 인증 설정**

이름과 서버 주소를 입력한 다음에는 아래 항목을 선택해 주세요.

-   **인증**  
    ‘항상 필요’를 선택해 주세요.
    
-   **OAuth 클라이언트**  
    ‘클라이언트 ID 없음’의 ‘자동으로 등록’ 항목을 선택해 주세요.
    
-   **추가 요청 헤더**  
    헤더를 추가하지 않고 비워 두세요.
    

클라이언트 ID와 비밀키는 직접 입력하지 않아도 돼요.  
선택을 마친 뒤 **추가**를 눌러 주세요. 웹에서 이 화면이 나타나지 않으면 그로블 커넥터 연결 단계로 진행해 주세요.

![Claude 데스크톱 앱의 커스텀 커넥터 추가 화면에서 인증은 항상 필요, OAuth 클라이언트는 클라이언트 ID 없이 자동 등록하는 항목을 선택한 예시](https://image.groble.im/article/2026/09/42c86491-dbca-482e-b42c-3205045b7266_image.png)

*‘항상 필요’와 ‘클라이언트 ID 없음’의 자동 등록 항목을 선택한 화면이에요.*

Team·Enterprise 계정은 조직 소유자가 조직 설정에서 먼저 그로블 커넥터를 추가해야 해요. 이후 각 사용자가 자신의 그로블 계정으로 연결하고 대화에서 켤 수 있어요. [Claude 연결 안내 보기](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp)

### 3-2. ChatGPT 웹에서 연결하기

ChatGPT 웹에서 [**플러그인**](https://chatgpt.com/plugins)을 선택하고 **새 플러그인** 창을 열어 주세요. 아래와 같이 입력하면 돼요.

1.  **이름**에 **Groble**을 입력해 주세요.  
    아이콘과 설명은 선택 사항이므로 비워 두어도 돼요.
    
2.  **연결**에서 **서버 URL**을 선택하고 아래 주소를 입력해 주세요.
    
    ```
    https://mcp.groble.im/mcp
    ```
    
3.  **인증**은 **OAuth**를 선택해 주세요.  
    **고급 OAuth 설정**은 기본값 그대로 두세요.
    
4.  화면 하단의 안내를 읽고 동의하시면 **내용을 이해했으며 계속 진행하길 원합니다** 항목에 체크해 주세요.
    
5.  **만들기**를 눌러 주세요.  
    그로블 로그인 화면이 열리면 그로블 로그인과 권한 허용을 완료해 주세요.
    

**만들기** 버튼이 비활성화되어 있다면 이름·서버 URL을 입력했는지와 하단 안내 확인 항목에 체크했는지 확인해 주세요.

메뉴가 보이지 않으면 웹에서 접속했는지와 요금제·조직 정책을 먼저 확인해 주세요. 화면과 제공 범위가 달라졌다면 [ChatGPT 공식 안내](https://developers.openai.com/api/docs/guides/developer-mode)를 참고해 주세요.

연결을 마쳤다면 새 대화에서 추가한 **Groble** 플러그인을 선택하고, 연결됐는지 확인하기에 따라 연결 상태를 확인해 주세요.

### 3-3. ChatGPT 데스크톱 앱에서 연결하기

데스크톱 앱은 좌측 상단에서 모드를 고를 수 있어요. 먼저 **Codex** 모드를 선택해 주세요. 일반 ChatGPT 모드에서는 그로블 연결을 쓸 수 없어요.

Codex 모드에서 **플러그인**에 그로블을 추가해요. 넣는 값은 웹과 같아요.

1.  **이름**에 **Groble**을 입력해 주세요.
    
2.  **연결**에서 **서버 URL**을 선택하고 아래 주소를 입력해 주세요.
    
    ```
    https://mcp.groble.im/mcp
    ```
    
3.  **인증**은 **OAuth**를 선택하고, **고급 OAuth 설정**은 기본값 그대로 두세요.
    
4.  그로블 로그인 화면이 열리면 아래 3-4절의 로그인과 권한 허용을 마쳐 주세요.
    

화면 구성은 위 3-2절의 새 플러그인 창과 같아요. 그쪽 안내를 함께 보셔도 돼요.

### 3-4. 그로블 로그인하고 권한 허용하기

Claude나 ChatGPT에서 연결을 시작하면 그로블 로그인 화면이 열려요.  
상품을 판매할 그로블 계정으로 로그인해 주세요.

![Groble MCP 연결을 위한 로그인 화면](https://image.groble.im/article/2026/09/5db332fe-0559-4515-b6e3-f5f820e53464_image.png)

*상품을 판매할 그로블 계정으로 로그인해 주세요.*

마지막으로 AI가 그로블에서 어떤 작업을 할 수 있는지 확인하는 권한 화면이 나와요. 내용을 읽고 동의하신다면 **허용하기**를 눌러 주세요.

![Claude와 그로블의 연결 권한을 확인하고 허용하는 화면](https://image.groble.im/article/2026/09/b8363c12-01eb-4481-8835-23a968d268a0_image.png)

*직접 시작한 연결인지 확인해 주세요. 연결할 AI와 요청 권한을 확인하고 동의하신다면 허용하기를 눌러 주세요.*

### 3-5. 개발 도구에서 연결하기

Claude Code 또는 Codex CLI를 설치한 뒤 터미널에서 진행해 주세요.  
**서버 주소를 등록한 뒤 그로블 로그인과 권한 허용도 완료해야 해요.**

**Claude Code**

```
claude mcp add --transport http groble https://mcp.groble.im/mcp
```

등록 후 Claude Code를 실행하고 아래 명령을 입력해 그로블 로그인과 권한 허용을 진행해 주세요.

```
/mcp
```

Claude Code 2.1.186 이상에서는 터미널에서 다음 명령으로 로그인할 수도 있어요.

```
claude mcp login groble
```

브라우저에서 로그인과 권한 허용을 마친 뒤 연결 상태를 확인하세요.

```
claude mcp list
```

등록 명령은 기본적으로 현재 프로젝트에 적용돼요. 여러 프로젝트에서 같은 연결을 쓰려면 등록할 때 `--scope user`를 추가할 수 있어요. [Claude Code 공식 안내](https://code.claude.com/docs/en/mcp)

**Codex CLI**

```
codex mcp add groble --url https://mcp.groble.im/mcp
codex mcp login groble
```

그로블 로그인과 권한 허용을 마친 뒤 등록된 서버를 확인하세요.

```
codex mcp list
```

[Codex MCP 공식 안내](https://learn.chatgpt.com/docs/extend/mcp?surface=cli)

### 연결됐는지 확인하기

새 대화에서 그로블 연결을 켠 뒤 AI에게 이렇게 물어보세요.

```
그로블 MCP 연결 확인해줘
```

**AI가 실제로 그로블에서 연결 상태를 조회했는지 확인해 주세요.** 로그인 방법이나 웹 검색 결과만 보여준다면 연결 여부를 확인한 것이 아니에요.

```
내 판매 준비 상태 확인해줘
```

현재 플랜과 함께 상품을 등록할 수 있다는 안내가 나오면 준비가 된 거예요.  
다른 계정으로 연결한 것 같다면 기존 연결을 끊고, 사용하려는 그로블 계정으로 다시 로그인해 주세요.

### 연결 끊기

Claude에서는 커넥터 목록, ChatGPT에서는 플러그인 목록에서 그로블 연결을 제거해 주세요.

**AI가 그로블에 접근할 수 있는 권한까지 해제하려면** [**그로블 고객센터**](https://4q124.channel.io)**에 연결 해제를 요청해 주세요.** 사용 중이던 AI의 이름을 알려주시고, 연결 권한을 해제해 달라고 요청하시면 돼요.

연결을 끊어도 이미 등록한 상품의 판매나 구매자의 정기결제가 자동으로 중단되지는 않아요. 판매도 멈추려면 연결을 끊기 전에 판매 중단을 요청하거나 그로블 웹에서 직접 진행해 주세요.

## 4\. 첫 상품 올리기

제목과 가격부터 말씀해 주세요. 상품을 만들면서 옵션, 소개, 이미지, 구매자에게 제공할 자료, 판매 기간도 함께 정할 수 있어요. 저장에 꼭 필요한 정보가 빠졌다면 AI의 안내에 따라 먼저 채워 주세요.

```
내 전자책을 3만 원에 팔고 싶어.
제목은 "블로그 글쓰기 30일 챌린지"야.
우선 초안으로 만들고, 판매 시작 전에는 내용을 보여줘.
```

### 판매 페이지와 결제창 중에서 골라 주세요

| 구분 | 판매 페이지 | 결제창 |
| --- | --- | --- |
| 이럴 때 사용해요 | 상품 소개와 여러 가격·구성을 함께 보여주고 싶을 때 | 이미 상품을 소개하는 페이지가 있고 결제창을 연결하고 싶을 때 |
| 옵션 | 한 개 이상 | 한 개만 가능 |
| 준비할 내용 | 상품 소개, 이미지, 가격·구성, 자료 전달 방법 등 | 가격, 판매할 상품에 대한 설명, 연결할 소개 페이지 주소 등 |
| 미리보기 | 상품 초안의 미리보기 주소 | 30분 동안 유효한 결제창 미리보기 주소 |

여러 옵션이 필요하면 처음부터 **판매 페이지로 만들어 달라**고 말씀해 주세요. 결제창에서는 옵션 이름·추가 옵션·할부 표시를 사용하지 않아요.

### 네 가지 상품 유형

| 유형 | 예시 | 함께 알려주시면 좋은 것 |
| --- | --- | --- |
| 자료 | 전자책, 템플릿, 강의 자료 | 구매자에게 제공할 PDF·ZIP 파일 또는 외부 링크 |
| 서비스 | 강의, 컨설팅, SaaS, 멤버십 | 누구를 위한 서비스인지, 어떻게 진행하는지 |
| 이벤트 | 클래스, 모임, 행사 | 진행 장소와 시작·종료 일시 |
| 제품 | 굿즈, 책 등 실물 상품 | 무료 배송 여부와 배송비 |

> **정기결제 상품은 서비스 유형으로 만들어져요.**
> 
> 결제 주기는 1~12개월 중에서 정해 주세요.

### 상품을 만들고 판매하는 순서

1.  **상품 설명하기**  
    상품 유형, 판매 방식, 제목과 가격을 말씀해 주세요.
    
2.  **초안 저장하기**  
    필요한 정보를 채워 초안으로 저장해요. 초안 상태에서는 구매할 수 없어요.
    
3.  **미리보기 확인하기**  
    AI가 알려준 링크에서 제목, 가격, 이미지와 자료 전달 방법을 확인해 주세요. 결제창 미리보기는 30분 뒤 만료되며 실제 결제는 진행되지 않아요. 만료되면 새 링크를 요청하세요.
    
4.  **판매 시작하기**  
    판매 기간과 공개 설정까지 확인한 뒤 판매 시작을 요청해 주세요. AI가 표시하는 대상 상품과 변경 내용을 확인하세요.
    
5.  **링크 확인하기**  
    AI가 알려준 링크를 직접 열어 현재 상태를 확인해 주세요. 판매 시작 일시를 미래로 설정했다면 지정한 시각부터 구매할 수 있어요.
    

소개나 이미지처럼 보완할 내용이 있어도 초안으로 저장할 수 있어요. 다만 제목, 옵션 가격, 제품의 배송 설정처럼 저장에 필요한 정보는 먼저 정해야 해요. 판매에 필요한 항목이 빠졌다면 안내받은 내용을 채운 뒤 다시 판매를 시작해 주세요.

> 상품 가격은 **옵션별로** 정해요. 판매 페이지는 여러 옵션을 둘 수 있고, 결제창은 옵션 한 개만 사용할 수 있어요.

### 전자책을 처음 올리는 대화 예시

아래는 진행 순서를 보여주는 예시예요. 질문 순서와 표현은 사용하는 AI에 따라 달라질 수 있어요.

1.  **판매자(나)**  
    판매 페이지로 전자책을 만들고 싶어.  
    제목은 블로그 글쓰기 30일 챌린지, 가격은 3만 원이야.  
    아직 판매는 시작하지 말아줘.
    
2.  **AI**  
    판매 준비 상태를 확인할게요.  
    전자책 소개, 대표 이미지, 구매자에게 제공할 자료도 알려 주세요.  
    리뷰와 누적 구매자 수를 공개할까요? 검색 엔진에도 상품이 노출되도록 할까요?
    
3.  **판매자(나)**  
    옵션 이름은 전자책 1권이야. 글쓰기를 시작하는 사람을 위한 30일 실습서로 소개해줘.  
    대표 이미지가 내 컴퓨터에 있으니 업로드 링크를 만들어줘. 자료는 공유 링크로 전달할게.  
    리뷰와 검색 노출은 켜고, 구매자 수는 숨겨줘. 판매 기간 제한은 없어.
    
4.  **AI**  
    대표 이미지를 올릴 링크를 준비했어요. 이 링크에서 이미지를 올린 뒤 알려 주세요.  
    전자책 자료의 공유 링크도 보내 주세요.
    
5.  **판매자(나)**  
    이미지 업로드를 마쳤어.  
    자료는 이 공유 링크로 전달해줘. 구매자가 열 수 있는지도 확인했어.  
    \[구매자용 공유 링크\]
    
6.  **AI**  
    업로드 결과를 확인하고 이미지와 자료 링크를 연결해 초안을 저장했어요.  
    미리보기에서 상품 내용과 가격, 자료 전달 방법을 확인해 주세요.
    
7.  **판매자(나)**  
    미리보기를 확인했어. 이 상품을 3만 원에 지금부터 판매 시작해줘.  
    완료하면 판매 링크와 현재 상태를 알려줘.
    
8.  **AI**  
    판매 시작 결과와 현재 판매 상태를 확인했어요. 공유할 판매 링크를 알려드릴게요.  
    링크를 직접 열어 마지막으로 확인해 주세요.
    

판매 페이지의 **리뷰 노출·누적 구매자 수 공개·검색 엔진 노출**은 각각 정할 수 있어요. 별도로 정하지 않으면 세 항목 모두 공개하지 않는 상태로 저장돼요. 판매 시작 전에 원하는 설정인지 확인해 주세요.

## 5\. 상품 관리하고 매출 확인하기

상품 이름이나 판매 링크와 함께 바꾸고 싶은 내용을 말씀해 주세요. 이름이 비슷한 상품이 여러 개라면 AI가 찾은 상품이 맞는지 먼저 확인해 주세요.

```
블로그 글쓰기 챌린지 상품을 찾아서 현재 가격과 판매 여부를 보여줘.
가격을 바꾸면 판매가 멈추는지도 먼저 알려줘.
```

판매 이력이 없는 옵션의 가격을 고칠 때는 이렇게 이어서 요청할 수 있어요.

```
전자책 1권 옵션의 가격을 2만 5천 원으로 수정하고,
수정한 초안의 미리보기를 보여줘.
```

### 수정할 때 알아두실 점

-   **바꿀 내용과 유지할 내용을 확인해 주세요**  
    가격만 수정해 달라고 요청하면 소개글과 자료 링크 등 나머지 내용은 유지돼요. 저장 후 결과도 확인해 주세요.
    
-   **내용을 지우려면 분명하게 말씀해 주세요**  
    소개글을 지우거나 판매 마감일을 없애고 싶다면 어떤 항목을 삭제할지 정확히 말씀해 주세요.
    
-   **판매 중인 상품을 수정하고 저장하면 판매가 중단돼요**  
    상품이 초안 상태로 바뀌므로 수정 후 미리보기를 확인하고 판매를 다시 시작해야 해요. 신규 구매가 멈추는 시간을 고려해 수정해 주세요.
    
-   **MCP에서는 이미 판매된 옵션을 수정할 수 없어요**  
    일반결제는 그로블 웹의 상품 수정 화면에서 바꿀 수 있고, 정기결제는 그로블 웹에서도 바꿀 수 없어요.  
    MCP로 다른 가격이나 자료를 팔고 싶다면 판매 페이지는 기존 옵션을 두고 새 옵션을 추가하고, 결제창은 새 상품을 만들어 주세요.
    
-   **제목과 옵션 이름에는 글자 수 제한이 있어요**  
    상품 제목은 30자, 판매 페이지의 옵션 이름은 20자까지예요.
    

```
수정한 상품의 미리보기를 보여줘. 확인한 뒤 판매를 다시 시작할게.
```

### 상품 목록과 매출 확인하기

| 확인할 내용 | 이렇게 요청해 보세요 |
| --- | --- |
| 특정 상품 찾기 | 제목에 블로그가 들어간 내 상품을 찾아줘. 판매 상태와 링크도 보여줘. |
| 판매 상태 확인 | 내 상품 전체 개수와 상품별 판매 상태를 보여줘. 목록이 더 있으면 이어서 보여줘. |
| 이번 달 매출 | 이번 달 매출과 판매 건수를 알려줘. |
| 누적 현황 | 누적 매출, 판매 건수와 고객 수를 알려줘. |
| 정산 예정 금액 | 현재 정산 예정 금액을 알려줘. |

정산 예정 금액은 요약 정보예요. 정산별 상세 내역과 주문·구매자 정보, 원하는 기간을 지정한 매출은 그로블 웹에서 확인해 주세요.

## 6\. 파일과 이미지 넣기

> 컴퓨터나 휴대폰에 있는 파일은 AI가 알려준 업로드 링크를 열어 올려 주세요.
> 
> **일반 대화창에 첨부한 파일은 MCP를 통해 그로블로 직접 옮길 수 없어요.**
> 
> 상품 이미지는 HTTPS 이미지 주소를 알려 주거나 업로드 링크로 올릴 수 있어요.  
> 구매자에게 제공할 자료는 자료용 업로드 링크로 올리거나 외부 공유 링크로 연결해 주세요.

### 상품 이미지 넣기

| 방법 | 이럴 때 사용하세요 | 하는 법 |
| --- | --- | --- |
| 웹 주소로 가져오기 | 이미지가 인터넷에 올라가 있고 HTTPS 직접 주소를 알고 있을 때 | 이미지 주소와 대표 이미지인지 소개 본문 이미지인지 AI에게 알려 주세요. AI가 그로블로 가져와요. |
| 업로드 링크로 올리기 | 이미지가 컴퓨터나 휴대폰에만 있을 때 | AI에게 이미지를 올리고 싶다고 말씀해 주세요. AI가 만든 링크를 열고 파일을 고른 뒤, 업로드가 끝났다고 알려 주세요. |
| 터미널에서 직접 올리기 | Claude Code나 Codex처럼 내 파일을 직접 전송할 수 있는 환경을 사용할 때 | 파일 경로와 용도를 AI에게 알려 주세요. AI가 업로드 주소를 준비하고 파일을 전송해요. |

이미지 업로드 링크는 대표 이미지와 소개 본문 이미지에 사용할 수 있어요.  
링크는 15분 동안 유효하며, 링크 하나로 이미지 1~10장을 올릴 수 있어요. 시간이 지나거나 정해진 장수를 모두 올리면 새 링크를 요청해 주세요.

![이미지 올리기 화면의 안내 문구와 이미지 고르기 버튼](https://image.groble.im/article/2026/09/2190c6ae-8bfb-431c-aa73-70be5de3132d_image.png)

*이미지 고르기를 눌러 파일을 선택해 주세요. 업로드가 끝나면 대화로 돌아와 AI에게 알려 주세요.*

### 구매자에게 제공할 자료 연결하기

자료 상품은 판매 옵션마다 구매자에게 제공할 파일 또는 외부 링크가 필요해요. 아래 방법 중에서 골라 주세요.

-   **외부 공유 링크로 전달하기**  
    구글 드라이브·노션처럼 구매자가 열 수 있는 HTTPS 링크를 AI에게 알려 주세요. 구매자에게 읽기 권한이 있는지 직접 확인하고, 판매 후에도 링크와 접근 권한을 유지해 주세요.
    
-   **자료용 업로드 링크로 올리기**  
    구매자에게 제공할 PDF 또는 ZIP 파일을 올리고 싶다고 AI에게 말씀해 주세요. 링크가 제공되면 파일을 올린 뒤 대화로 돌아와 업로드가 끝났다고 알려 주세요. AI가 업로드 결과를 확인하고 해당 옵션에 자료를 연결해요.
    
-   **터미널에서 직접 올리기**  
    Claude Code·Codex CLI에서 내 파일을 전송할 수 있다면 파일 경로와 연결할 상품·옵션을 알려 주세요.
    

자료용 업로드 링크는 30분 동안 유효해요. 링크 하나로 파일 1~3개를 올릴 수 있고, 파일당 최대 크기는 60MB예요.  
이미지용 링크에는 PDF·ZIP을 올릴 수 없으니 **자료 파일을 올릴 업로드 링크**라고 요청해 주세요.

> AI가 자료 업로드 링크를 현재 사용할 수 없다고 안내하면 구매자가 열 수 있는 외부 공유 링크를 사용해 주세요. 일반 대화창에 파일을 첨부하는 것으로 대체할 수는 없어요.

```
이 전자책 구매자에게 제공할 PDF 파일을 올리고 싶어. 자료용 업로드 링크를 만들어줘.
```

한 옵션에는 자료 파일 한 개를 연결해요. 여러 파일을 함께 전달하려면 ZIP으로 묶거나 외부 공유 폴더 링크를 사용할 수 있어요. 업로드 후에는 어떤 파일을 어느 옵션에 연결했는지 AI에게 확인해 주세요.

### 지원 형식과 크기

| 용도 | 형식 | 최대 크기 |
| --- | --- | --- |
| 상품 대표 이미지 | PNG, JPG, JPEG, WEBP | 5MB |
| 상품 소개 본문 이미지 | PNG, JPG, JPEG, WEBP | 10MB |
| 구매자에게 제공할 자료 | PDF, ZIP | 60MB |

### 업로드할 때 알아두실 점

-   **업로드 완료 후 상품에 연결됐는지 확인해 주세요**  
    업로드가 끝나면 대화로 돌아와 AI에게 알려 주세요. AI가 업로드한 파일을 확인하고 상품의 대표 이미지, 소개 본문 또는 구매자에게 제공할 자료로 연결해야 상품에 반영돼요.
    
-   이미 올린 대표 이미지와 소개 본문 이미지는 다시 사용할 수 있어요.
    
-   **업로드 링크와 미리보기 링크는 판매 링크와 달라요**  
    개인 작업용 링크는 구매자에게 공유하지 마세요. 판매 시작 후 AI가 알려준 판매 링크를 공유해 주세요.
    

## 7\. 안전장치

상품을 수정하거나 판매 상태를 바꿀 때 구매자와 매출에 미치는 영향을 줄일 수 있도록 안전장치를 두고 있어요.

### 이미 판매된 옵션은 보호돼요

한 번이라도 판매된 옵션은 MCP에서 아래 항목을 수정할 수 없고, 옵션을 목록에서 뺄 수도 없어요.

-   가격·이름·설명
    
-   구매자에게 제공하는 자료
    
-   할인·재고·추가 옵션·할부 표시
    
-   정기결제의 결제 주기
    

그로블 웹에서도 수정이 막히는지는 결제 방식에 따라 달라요.

-   **일반결제는 그로블 웹에서 수정할 수 있어요**  
    판매 이력이 있어도 그로블 웹의 상품 수정 화면에서는 위에 나열된 항목들을 바꿀 수 있어요.  
    판매된 옵션의 값을 꼭 고쳐야 한다면 그로블 웹에서 진행해 주세요.
    
-   **정기결제는 그로블 웹에서도 수정할 수 없어요**  
    판매된 옵션은 수정도 삭제도 막혀 있고, 결제 주기도 바꿀 수 없어요.  
    다른 조건으로 팔고 싶다면 아래 방법으로 새로 만들어 주세요.
    

> 구매자가 받는 자료는 지금 옵션에 연결된 파일이에요. 판매 후 자료를 바꾸면 이미 구매한 분이 받는 파일까지 바뀌니, 그로블 웹에서 일반결제 옵션의 자료를 바꿀 때는 특히 확인해 주세요.
> 
> 가격이나 자료가 다른 조건으로 팔고 싶다면 기존 옵션은 그대로 두고 **판매 페이지는 새 옵션을 추가**해 주세요. 결제창은 옵션을 한 개만 둘 수 있으니 **새 상품을 만들어** 주세요. 기존 옵션의 신규 구매만 막고 싶다면 그로블 웹에서 가능한 관리 방법을 확인해 주세요.

옵션의 진열 순서는 MCP에서도 바꿀 수 있어요.  
다만 MCP로 판매 중인 상품을 수정하고 저장하면 판매가 중단되므로 확인 후 다시 판매를 시작해 주세요.

### 판매 시작과 중단 전에 확인해 주세요

판매를 시작하거나 재개하면 신규 구매가 가능해지고, 판매를 중단하면 신규 구매가 멈춰요. 판매 시작 일시를 미래로 설정했다면 지정한 시각부터 구매할 수 있어요.

그로블은 AI가 미리보기와 작업 내용을 보여주고 확인을 받은 뒤 진행하도록 안내해요. 다만 **확인 요청 방식은 AI 서비스의 승인 설정에 따라 달라질 수 있어요.** 모든 환경에서 별도의 최종 확인 창이 뜨는 것은 아니에요.

판매 시작·중단을 요청할 때는 대상 상품, 가격, 판매 기간과 작업 내용을 직접 확인해 주세요. 초안만 만들고 싶다면 판매를 시작하지 말고 미리보기까지 만들어 달라고 말씀해 주세요.

### 정기결제의 판매 중단과 판매 종료는 달라요

-   **판매 중단은 AI에서 요청할 수 있어요**  
    새로운 정기결제 구매만 멈춰요.  
    기존 구매자의 정기결제는 유지되고, 나중에 신규 판매를 다시 시작할 수 있어요.
    
-   **판매 종료는 그로블 웹에서 직접 진행해 주세요**  
    기존 모든 구매자의 정기결제가 즉시 해지돼요.  
    나중에 판매를 다시 시작해도 이미 해지된 정기결제는 복구되지 않아요.
    

AI에게 판매 중단을 요청하면 신규 판매만 멈춰요.  
기존 정기결제까지 해지하려면 [그로블 스토어 관리 → 상품 목록](https://groble.im/manage/store/products)에서 해당 상품의 **⋮ → 종료하기**를 선택하고 영향 범위를 확인한 뒤 직접 진행해 주세요.

### 판매 시작·재개 횟수 제한

MCP를 통한 판매 시작과 재개에는 그로블 계정별로 다음 한도가 적용돼요.

-   **새 상품의 첫 판매 시작**  
    시간당 최대 10개까지예요.
    
-   **이미 판매를 시작했던 상품의 판매 재개**  
    시간당 최대 30회까지예요. 상품을 수정한 뒤 다시 판매하는 경우도 포함돼요.
    

두 한도는 각각 계산해요.  
이미 판매 중인 상품의 상태만 다시 확인하는 요청은 횟수에 포함되지 않아요.

필수 정보가 빠져 판매를 시작하지 못한 경우에는 횟수에 포함되지 않아요. 다만 전체 요청과 업로드에는 별도의 한도가 있어요. 한도 초과 안내가 나오면 표시된 대기 시간이 지난 뒤 다시 진행해 주세요.

## 8\. 잘 안 될 때

| 안내 문구 또는 상황 | 이렇게 해 주세요 |
| --- | --- |
| 연동을 사용할 수 없어요 | 일시적으로 사용할 수 없는 상태예요.<br>잠시 후 다시 시도하거나 그로블 웹에서 직접 진행해 주세요. |
| 먼저 멤버십 플랜을 선택해 주세요 | 판매 준비 상태를 확인한 뒤 플랜을 선택해 주세요. Pro 구독형은 결제 페이지에서 직접 결제한 뒤 상태를 다시 확인해야 해요. |
| 연결에 필요한 권한이 없어요 | 그로블 연결을 다시 인증하고 권한 화면에서 허용하기를 눌렀는지 확인해 주세요. 계속 실패하면 연결을 제거한 뒤 다시 추가해 주세요. |
| 입력값이 올바르지 않아요 | 오류 안내에 나온 항목을 AI에게 알려주고 수정을 요청해 주세요.<br>제목, 옵션 가격, 배송비 등 저장에 필요한 값은 먼저 채워야 해요. |
| 한도를 넘었어요 | 안내된 대기 시간이 지난 뒤 다시 시도해 주세요.<br>새 상품의 첫 판매 시작과 기존 상품의 판매 재개에는 서로 다른 한도가 적용돼요. |
| 이미 판매된 옵션을 수정할 수 없어요 | 일반결제는 그로블 웹에서 옵션을 수정해 주세요. 정기결제는 그로블 웹에서도 판매된 옵션을 수정할 수 없어요.<br>MCP로 진행하려면 판매 페이지는 기존 옵션을 유지하고 새 옵션을 추가하고, 결제창은 새 상품을 만들어 주세요. |
| 결제창에 옵션을 여러 개 넣을 수 없어요 | 옵션을 한 개로 구성하거나 여러 옵션을 지원하는 판매 페이지로 만들어 주세요. |
| 자료 파일 또는 링크가 필요해요 | 자료 상품의 판매 옵션마다 PDF·ZIP 파일 또는 구매자가 열 수 있는 HTTPS 외부 링크를 연결해 주세요. |
| 자료 업로드 링크를 사용할 수 없어요 | 자료 업로드가 현재 제공되지 않는 경우예요.<br>외부 공유 링크로 전달하거나 그로블 웹에서 자료를 연결해 주세요. |
| PDF·ZIP 파일을 선택할 수 없어요 | 이미지용 업로드 링크를 열었는지 확인하고 AI에게 자료 파일을 올릴 업로드 링크를 새로 요청하세요. |
| 업로드 링크가 만료됐어요 | AI에게 새 업로드 링크를 요청하세요. 이미 업로드한 파일이 있다면 업로드 결과를 먼저 확인해 달라고 말씀해 주세요. |
| 판매 마감일이 이미 지났어요 | 마감일을 미루거나 없앤 뒤 미리보기를 확인하고 다시 판매를 시작해 주세요. |
| 판매 종료는 웹에서만 할 수 있어요 | [상품 목록](https://groble.im/manage/store/products)의 해당 상품 ⋮ 메뉴에서 종료하기를 선택해 주세요.<br>기존 구독이 모두 해지되는 작업이므로 판매 중단과 구분해 주세요. |
| 아직 AI 연동에서 지원하지 않아요 | 현재 MCP에서 제공하지 않는 작업이에요.<br>그로블 웹에서 직접 진행해 주세요. |
| 일시적인 오류가 반복돼요 | 잠시 후에도 같은 문제가 반복되면 [그로블 고객센터](https://4q124.channel.io)로 문의해 주세요. |

### 연결 자체가 안 될 때

#### ChatGPT에서 “연결에 문제가 발생했습니다”라고 나와요

새 플러그인 창에서 연결은 **서버 URL**, 인증은 **OAuth**로 선택했는지 확인해 주세요. 고급 OAuth 설정은 기본값 그대로 두세요.  
추가에 실패한 그로블 연결이 플러그인 목록에 남아 있다면 해당 연결을 제거한 뒤 ChatGPT 연결 절차에 따라 다시 추가해 주세요.

그로블 로그인과 권한 허용을 마친 뒤 새 대화에서 추가한 **Groble** 플러그인을 선택하고 연결 상태를 확인해 주세요. 같은 오류가 반복되면 오류 문구와 발생 시각을 함께 고객센터에 알려 주세요.

#### Claude에서 커스텀 커넥터 추가 메뉴가 보이지 않아요

웹 또는 데스크톱 앱의 사용자 지정(Customize) → 커넥터 메뉴를 확인하세요. Free는 사용자 지정 커넥터 한 개까지 사용할 수 있어요. Team·Enterprise는 조직 소유자가 먼저 그로블을 추가해야 해요.

#### ChatGPT에서 플러그인 추가 메뉴가 보이지 않아요

ChatGPT 웹에서 플러그인 메뉴를 열었는지 확인해 주세요. 사용 중인 요금제와 조직 정책에 따라 추가·사용이 제한될 수 있어요. 조직 계정이라면 관리자에게 플러그인 추가가 허용되어 있는지 확인해 주세요.

#### 주소를 추가했는데 연결에 실패해요

주소가 `https://mcp.groble.im/mcp`인지 확인해 주세요. 앞뒤에 공백이 없고, 끝에 `/mcp`가 포함되어 있어야 해요.  
ChatGPT는 새 플러그인 창에서 서버 URL과 OAuth를 선택하고, 고급 OAuth 설정은 기본값 그대로 두세요. Claude의 인증 설정은 위의 Claude 연결 안내를 따라 주세요.

#### 로그인했는데 AI가 그로블 도구를 찾지 못해요

권한 화면의 허용하기까지 마쳤는지 확인해 주세요.  
Claude는 새 대화의 + → 커넥터에서 그로블을 활성화해 주세요. ChatGPT는 새 대화에서 추가한 Groble 플러그인을 선택해 주세요.  
Claude Code·Codex CLI는 주소 등록 후 로그인도 완료해야 해요.  
그래도 도구가 보이지 않으면 연결 상세 화면에서 새로고침을 해 보세요. 계속 같은 문제가 생기면 기존 그로블 연결을 제거한 뒤 다시 연결해 주세요.

#### “연결이 이어지지 않았어요” 화면이 나와요

로그인을 마친 뒤 뒤로가기로 이전 화면을 다시 열면 나타날 수 있어요.  
사용 중인 AI에서 새로운 연결을 시작해 주세요.

#### 쓸 수 있는 기능이 예전 그대로예요

AI가 이전 도구 목록을 기억하고 있을 수 있어요. 연결 상세 화면에서 새로고침을 지원한다면 먼저 갱신하세요. 이후 새 대화에서 그로블을 켜 보세요. 계속 이전 기능만 보인다면 연결을 제거하고 다시 추가해 주세요.

#### CLI에서 이미 등록된 서버라고 나와요

등록 명령을 반복하기보다 목록에서 기존 그로블 주소를 먼저 확인해 주세요. 주소가 맞으면 로그인을 진행해 주세요. 예전 주소라면 기존 등록을 정리하고 새 주소로 다시 추가해 주세요.

### 해결되지 않으면 문의해 주세요

[그로블 고객센터](https://4q124.channel.io)에 **사용한 AI 이름과 접속 환경(웹·앱·CLI), 문제가 발생한 시각, 하려던 작업, 오류 문구**를 함께 알려 주세요. 응답에 요청 ID가 있다면 함께 전달해 주시면 확인에 도움이 돼요.

비밀번호, 인증 토큰, 개인 업로드 링크는 문의 내용에 넣지 마세요. 화면을 보내실 때도 해당 정보는 가려 주세요.

## 9\. 시작 체크리스트

- [ ] 사용하는 AI의 지원 요금제와 조직 정책 확인하기
- [ ] `https://mcp.groble.im/mcp` 주소로 연결 추가하기
- [ ] 그로블 로그인과 권한 허용을 마치고 새 대화에서 연결 확인하기
- [ ] AI가 그로블에서 조회한 결과로 연결 상태 확인하기
- [ ] 판매 준비 상태 확인하기  
  멤버십 Pro 구독형을 선택했다면 결제 완료 여부도 확인해 주세요.
- [ ] 판매 페이지 또는 결제창 중에서 판매 방식 고르기
- [ ] 제목·가격·옵션 구성·이미지·구매자에게 제공할 자료 확인하기
- [ ] 판매 페이지의 리뷰·구매자 수·검색 노출 여부 정하기
- [ ] 미리보기와 판매 시작·마감 일시를 확인한 뒤 판매 시작 요청하기
- [ ] 판매 링크를 직접 열어 현재 상태 확인하기
- [ ] 판매 중인 상품을 수정했다면 미리보기 확인 후 판매 재개하기