Refgrow MCP Server

@refgrow/mcp

Refgrow REST API をラップする Model Context Protocol（MCP）サーバーです。これにより、AI エージェント（Claude Desktop、Cursor、ChatGPT、その他の MCP 互換クライアント）がアフィリエイトプログラムを直接管理できるようになります。

前提条件

• Node.js 18+
• API キー（プロジェクト設定で生成）を持つ Refgrow アカウント
• API キーは rgk_ で始まります

インストール

npm install @refgrow/mcp

または、ソースをクローンしてビルドします。

git clone https://github.com/refgrow/refgrow-mcp.git
cd refgrow-mcp
npm install
npm run build

設定

サーバーには、次の 2 つの環境変数が必要です。

変数	必須	デフォルト	説明
REFGROW_API_KEY	はい	--	Refgrow API キー（rgk_ で始まります）
REFGROW_API_URL	いいえ	https://refgrow.com	Refgrow インスタンスのベース URL

API キーの取得

1. Refgrow にログインします
2. プロジェクト設定に移動します
3. API Keys セクションまでスクロールします
4. Generate API Key をクリックします
5. キーをコピーします（rgk_ で始まり、一度だけ表示されます）

Claude Desktop での使用

Claude Desktop の設定ファイルに次の内容を追加します。

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "refgrow": {
      "command": "npx",
      "args": ["-y", "@refgrow/mcp"],
      "env": {
        "REFGROW_API_KEY": "rgk_your_api_key_here"
      }
    }
  }
}

グローバルにインストールした場合、またはソースからインストールした場合は、次のようにします。

{
  "mcpServers": {
    "refgrow": {
      "command": "node",
      "args": ["/path/to/packages/mcp-server/dist/index.js"],
      "env": {
        "REFGROW_API_KEY": "rgk_your_api_key_here"
      }
    }
  }
}

Cursor での使用

Cursor の設定で、次の内容の MCP サーバーを追加します。

• 名前: refgrow
• コマンド: npx -y @refgrow/mcp
• 環境: REFGROW_API_KEY=rgk_your_api_key_here

または、プロジェクトのルートにある .cursor/mcp.json に追加します。

{
  "mcpServers": {
    "refgrow": {
      "command": "npx",
      "args": ["-y", "@refgrow/mcp"],
      "env": {
        "REFGROW_API_KEY": "rgk_your_api_key_here"
      }
    }
  }
}

Claude Code での使用

プロジェクトの .mcp.json に追加します。

{
  "mcpServers": {
    "refgrow": {
      "command": "npx",
      "args": ["-y", "@refgrow/mcp"],
      "env": {
        "REFGROW_API_KEY": "rgk_your_api_key_here"
      }
    }
  }
}

利用可能なツール

アフィリエイト

ツール	説明
list_affiliates	すべてのアフィリエイトを統計（クリック数、登録数、購入数、収益）とともに一覧表示します
get_affiliate_details	メールアドレスで指定したアフィリエイトの詳細を取得します
create_affiliate	任意のカスタム紹介コードを指定して、新しいアフィリエイトを作成します
update_affiliate	アフィリエイトのメールアドレス、紹介コード、ステータス、またはパートナースラッグを更新します
delete_affiliate	プロジェクトからアフィリエイトを削除します

紹介

ツール	説明
list_referrals	紹介されたユーザーを一覧表示します。アフィリエイトまたはステータスで絞り込めます
get_referral_details	メールアドレスで指定した紹介ユーザーの詳細を取得します
create_referral	紹介ユーザーのレコードを手動で作成します

コンバージョン

ツール	説明
list_conversions	種類、アフィリエイト、期間、支払い状況で絞り込んでコンバージョンを一覧表示します
get_conversion	ID で指定したコンバージョンを取得します
create_conversion	自動コミッション計算付きで、コンバージョン（登録／購入）を作成します
update_conversion	コンバージョンの詳細を更新するか、支払い済みとしてマークします
delete_conversion	コンバージョンのレコードを削除します

クーポン

ツール	説明
list_coupons	アフィリエイト情報付きでクーポンコードを一覧表示します
get_coupon	ID で指定したクーポンを取得します
create_coupon	アフィリエイトに紐付けたクーポンを作成します（Stripe／LemonSqueezy ID は任意です）
update_coupon	クーポンの詳細を更新します
delete_coupon	クーポンを削除します（紐付けられている場合は Stripe からも削除します）

会話の例

接続すると、AI エージェントに次のようなことを依頼できます。

• 「有効なアフィリエイトとその収益をすべて表示して」
• 「紹介コード PARTNER2025 を使って、[email protected] の新しいアフィリエイトを作成して」
• 「過去 30 日間の未払いコンバージョンを一覧表示して」
• 「今月、アフィリエイト紹介経由で登録したユーザーは何人？」
• 「アフィリエイト ID 42 に紐付けたクーポンコード SAVE20 を作成して」
• 「コンバージョン #123 を支払い済みとしてマークして」
• 「メールアドレスが [email protected] のアフィリエイトを無効にして」

開発

# Install dependencies
npm install

# Build
npm run build

# Watch mode for development
npm run dev

# Run the server (requires REFGROW_API_KEY env var)
REFGROW_API_KEY=rgk_your_key npm start

ドキュメント

例とトラブルシューティングを含む、セットアップガイドの全文： https://refgrow.com/docs/mcp-server

REST API リファレンス（HTTP による直接連携向け）： https://refgrow.com/docs/api-reference

ライセンス

MIT