Gumroad MCP 서버

귀하의 브라우저는 비디오 태그를 지원하지 않습니다.

개요

Gumroad를 위한 MCP(Model Context Protocol) 서버 구현으로, Claude Desktop과 같은 MCP 호환 AI 클라이언트가 Gumroad의 API 와 상호 작용할 수 있습니다.

모델 컨텍스트 프로토콜(MCP)을 사용하면 AI 어시스턴트가 외부 도구 및 서비스와 상호 작용할 수 있습니다.

빠른 시작

몇 초 만에 Claude Desktop과 함께 Gumroad MCP Server를 사용해 보세요.

지엑스피1

이 명령은 대화형 프롬프트를 통해 Gumroad 자격 증명 으로 MCP 서버를 설정합니다.

용법

구성이 완료되면 MCP 호환 클라이언트에서 다음 명령을 시도해 보세요.

지난달과 1년 전에 비해 얼마나 많은 매출을 올렸나요?
작년 매출을 포함하는 대화형 차트를 생성합니다.
작년 Gumroad에서 가장 많이 팔린 제품을 나열해 보세요.
작년에 가장 많이 팔린 제품의 월별 추세를 보여주세요
"제품 이름" 제품 비활성화
"제품 이름" 제품 활성화
"제품 이름"에 대한 모든 제안 코드를 나열하세요
"제품명"에 대해 99% 할인되는 새로운 할인 코드 "FAFO"를 생성하세요.
"제품 이름"에서 "abc123" 할인 코드를 삭제하세요.

도구

제품

gumroad_get_products - 모든 제품 받기
gumroad_get_product - ID로 단일 제품 가져오기
gumroad_disable_product - 제품 비활성화
gumroad_enable_product - 제품 활성화

매상

gumroad_get_sales - 판매 데이터 가져오기

오퍼 코드

gumroad_get_offer_codes - 제품에 대한 모든 할인 코드를 가져옵니다.
gumroad_get_offer_code - 단일 오퍼 코드 받기
gumroad_create_offer_code - 새로운 오퍼 코드 생성
gumroad_update_offer_code - 기존 오퍼 코드 업데이트
gumroad_delete_offer_code - 오퍼 코드 삭제

사용자

gumroad_get_user - 인증된 사용자 데이터 가져오기

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 gumroad-mcp를 자동으로 설치하려면:

npx -y @smithery/cli install @rmarescu/gumroad-mcp --client claude

필수 조건

Node.js 18 이상
API 액세스가 가능한 Gumroad 계정
MCP 호환 클라이언트(Claude Desktop 등)

Node가 설치되었는지 확인하려면 컴퓨터에서 명령줄을 엽니다.

macOS에서는 응용 프로그램 폴더에서 터미널을 엽니다.
Windows에서는 Windows + R을 누르고 "cmd"를 입력한 후 Enter를 누릅니다.

명령줄에 들어가면 다음 명령을 입력하여 Node가 설치되어 있는지 확인하세요.

node --version

Gumroad 액세스 토큰 생성

Gumroad API를 사용하려면 인증이 필요합니다. 액세스 토큰을 생성하려면 다음 단계를 따르세요.

Gumroad 계정(또는 Gumroad 인스턴스)에 로그인하세요 .
설정 > 고급 페이지로 이동합니다.
다음 정보를 제공하여 새로운 신청서를 작성하세요.
- 애플리케이션 아이콘(선택 사항): 애플리케이션을 식별하는 작은 썸네일 이미지입니다.
- 애플리케이션 이름: 애플리케이션의 이름입니다.
- 리디렉션 URI: 개인적인 용도로는 http://127.0.0.1 (로컬호스트)을 입력할 수 있습니다. 이 값은 이 컨텍스트에서 의미가 없습니다.
"신청서 만들기"를 클릭하세요.
"액세스 토큰 생성" 버튼을 사용하여 액세스 토큰을 받으세요.

액세스 토큰은 비밀번호처럼 안전하고 기밀로 유지하세요. 아래와 같이 설정에 포함해야 합니다.

Claude Desktop 설치

Claude Desktop을 사용하면 대화형 설정을 사용할 수 있습니다.

npx gumroad-mcp@latest init

수동 설치

다른 MCP 지원 애플리케이션 의 경우 MCP 구성을 수동으로 업데이트해야 합니다.

예제 구성

{
  "mcpServers": {
    "gumroad": {
      "command": "npx",
      "args": ["-y", "gumroad-mcp@latest"],
      "env": {
        "GUMROAD_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

자체 호스팅 Gumroad 인스턴스를 사용하는 경우 GUMROAD_BASE_URL 통해 사용자 지정 URL에 연결하도록 서버를 구성할 수 있습니다.

{
  "mcpServers": {
    "gumroad": {
      "command": "npx",
      "args": ["-y", "gumroad-mcp@latest"],
      "env": {
        "GUMROAD_ACCESS_TOKEN": "<YOUR_TOKEN>",
        "GUMROAD_BASE_URL": "https://example.com"
      }
    }
  }
}

[!NOTE] 서버는 기본 URL에 API 버전( /v2 )을 자동으로 추가합니다. 예를 들어 GUMROAD_BASE_URL="https://example.com" 사용하면 API 요청이 https://example.com/v2 로 전송됩니다.

Claude Desktop에 MCP 서버를 추가하는 방법은 다음 지침 을 참조하세요.

기여하다

버그를 발견하셨거나 기능을 제안하고 싶으신가요? GitHub에서 이슈를 개설하거나 풀 리퀘스트를 제출해 주세요.

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 약관에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.

Gumroad

Integrations