Gumroad MCP サーバー

お使いのブラウザはビデオタグをサポートしていません。

概要

Gumroad用の Model Context Protocol (MCP) サーバー実装。Claude Desktop などの MCP 対応 AI クライアントがGumroad の APIと対話できるようになります。

モデルコンテキストプロトコル (MCP)により、AI アシスタントは外部のツールやサービスと対話できるようになります。

クイックスタート

数秒でClaude DesktopでGumroad MCP Serverの使用を開始できます。

npx gumroad-mcp@latest init

このコマンドは、対話型プロンプトを通じて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 用の gutroad-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 (localhost) を入力できます。
「アプリケーションを作成」をクリックします。
「アクセストークンの生成」ボタンを使用してアクセストークンを取得します。

アクセストークンはパスワードと同様に安全かつ機密に保管してください。以下の手順で設定に含める必要があります。

クロードデスクトップインストール

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に送信されます。

MCP サーバーを Claude Desktop に追加する方法については、こちらの手順を参照してください。

貢献

バグを見つけた場合や機能を提案したい場合は、GitHub で問題を報告するか、プルリクエストを送信してください。

ライセンス

このMCPサーバーはMITライセンスに基づいてライセンスされています。つまり、MITライセンスの条件に従って、ソフトウェアを自由に使用、改変、配布することができます。詳細については、プロジェクトリポジトリのLICENSEファイルをご覧ください。

Gumroad

Integrations