Gumroad MCP Server

Gumroad MCP サーバー

お使いのブラウザーは video タグに対応していません。

概要

Gumroad 向けの Model Context Protocol（MCP）サーバー実装です。Claude Desktop などの MCP 対応 AI クライアントが Gumroad API とやり取りできるようにします。

Model Context Protocol（MCP） を使用すると、AI アシスタントが外部のツールやサービスとやり取りできます。

クイックスタート

Claude Desktop で Gumroad MCP Server をすぐに使い始められます。

npx gumroad-mcp@latest init

このコマンドでは、対話形式のプロンプトを通じて Gumroad の認証情報 を使用し、MCP サーバーをセットアップします。

使用方法

設定が完了したら、MCP 対応クライアントで次のコマンドを試してください。

• 先月の売上は、1 年前と比べてどのくらいでしたか？
• 昨年の売上をインタラクティブなグラフで表示する
• 昨年の Gumroad での売上上位商品を一覧表示する
• 昨年の売上上位商品の月ごとの推移を表示する
• 「Product Name」商品を無効にする
• 「Product Name」商品を有効にする
• 「Product Name」のすべてのオファーコードを一覧表示する
• 「Product Name」に 99% 割引の新しいオファーコード「FAFO」を作成する
• 「Product Name」からオファーコード「abc123」を削除する

ツール

商品

• gumroad_get_products - すべての商品を取得
• gumroad_get_product - ID を指定して商品を 1 件取得
• gumroad_disable_product - 商品を無効にする
• gumroad_enable_product - 商品を有効にする

売上

• gumroad_get_sales - 売上データを取得

オファーコード

• gumroad_get_offer_codes - 商品のすべてのオファーコードを取得
• gumroad_get_offer_code - オファーコードを 1 件取得
• gumroad_create_offer_code - 新しいオファーコードを作成
• gumroad_update_offer_code - 既存のオファーコードを更新
• gumroad_delete_offer_code - オファーコードを削除

ユーザー

• gumroad_get_user - 認証済みユーザーのデータを取得

インストール

Smithery 経由でのインストール

Smithery 経由で gumroad-mcp を Claude Desktop に自動インストールするには、次の手順を実行します。

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. 「Settings」>「Advanced」ページに移動します。
3. 次の情報を入力して、新しいアプリケーションを作成します。
   • アプリケーションアイコン（任意）：アプリケーションを識別するための小さなサムネイル画像です。
   • アプリケーション名：アプリケーションの名前です。
   • リダイレクト URI：個人利用の場合、このコンテキストでは意味を持たないため、値として http://127.0.0.1（localhost）を入力できます。
4. 「Create application」をクリックします。
5. 「Generate access token」ボタンを使用してアクセストークンを取得します。

アクセストークンはパスワードと同様に安全に保管し、秘密にしてください。以下に示すように、設定に含める必要があります。

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"
      }
    }
  }
}

メモ

サーバーは API バージョン（/v2）をベース URL に自動的に追加します。たとえば、GUMROAD_BASE_URL="https://example.com" の場合、API リクエストは https://example.com/v2 に送信されます。

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

貢献

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

ライセンス

この MCP サーバーは MIT ライセンスのもとでライセンスされています。MIT ライセンスの条項に従うことを条件に、このソフトウェアを自由に使用、変更、配布できます。詳細については、プロジェクトリポジトリの LICENSE ファイルを参照してください。