Gumroad MCP サーバー

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

概要

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

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

Related MCP server: MCP Server Example

クイックスタート

数秒で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 は認証が必要です。アクセストークンを生成するには、以下の手順に従ってください。

1. Gumroad アカウント (または Gumroad の独自のインスタンス) にログインします。

2. [設定] > [詳細設定]ページに移動します。

3. 次の情報を入力して新しいアプリケーションを作成します。

   • アプリケーション アイコン (オプション): アプリケーションを識別するための小さなサムネイル画像。

   • アプリケーション名: アプリケーションの名前。

   • リダイレクト URI: 個人使用の場合、この値はこのコンテキストでは意味がないため、 http://127.0.0.1 (localhost) を入力できます。

4. 「アプリケーションを作成」をクリックします。

5. 「アクセス トークンの生成」ボタンを使用してアクセス トークンを取得します。

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

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

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ファイルをご覧ください。