Gumroad MCP

🚀 Gumroad MCP サーバー

このプロジェクトは、Gumroad APIとMCP互換のAIクライアントを接続し、データ取得や分析などの操作を可能にします。

🚀 クイックスタート

Claude Desktopを使用して、数秒でGumroad MCPサーバーを使い始めましょう。

npx gumroad-mcp@latest init

このコマンドは、あなたの Gumroad クレデンシャル を使用して、対話式のプロンプトでMCPサーバーを設定します。

✨ 主な機能

基本機能

• 初期化：npx gumroad-mcp@latest init
• クレデンシャルの取得：npx gumroad-mcp@latest credentials
• 商品の一覧表示：npx gumroad-mcp@latest products
• 注文履歴の表示：npx gumroad-mcp@latest orders

高度な機能

• カスタムフィールド：拡張データフィールドをサポート
• バッチ処理：複数の注文を一度に処理することができます
• フィルター：日付、商品IDなどの条件でデータを絞り込めます
• エクスポート：データをCSVまたはJSON形式でエクスポートできます

📦 インストール

基本的なインストール

ほとんどのユーザーは、以下のコマンドを実行するだけです。

npx gumroad-mcp@latest install

手動インストール

カスタム設定が必要な場合は、以下の例を参考にしてください。

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

自前でホストしているGumroadインスタンスを使用している場合は、GUMROAD_BASE_URL でカスタムアドレスを設定できます。

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

⚠️ 重要な注意事項

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

MCP プロトコルドキュメント を参照して、Claude DesktopにMCPサーバーを追加する方法を確認してください。

💻 使用例

設定が完了したら、MCP互換クライアントで以下のコマンドを試してみてください。

• 先月の売上は一年前と比べてどうですか？
• 昨年の売上のインタラクティブなグラフを生成してください
• 昨年のGumroadの売上状況を列挙してください
• 過去7日間の売上データを見てください

詳細な例は Gumroad ドキュメント を参照してください。

🤝 貢献

バグを見つけたり、提案がある場合は、GitHubでイシューを開くか、プルリクエストを送信してください。

📄 ライセンス

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