agentfuse-mcp

agentfuse-mcp

AgentFuse 向け MCP サーバー — AI エージェント用アフィリエイト API ミドルウェアです。

MCP 対応の AI エージェント（Claude Code、Cowork、カスタムエージェント）なら、HTTP コードを書かずにアフィリエイトプログラムを閲覧し、トラッキングリンクを生成して、コンバージョンを記録できます。

---

ツール

ツール	説明
list_affiliate_programs	カタログ内のすべてのプログラムを閲覧します（カテゴリで絞り込み可能）
get_affiliate_program	スラッグを指定して、プログラムの詳細を取得します
generate_tracked_link	ユーザー向けにアトリビューションタグ付きの短縮リンクを作成します
get_stats	クリック数、登録数、コミッションのダッシュボード概要を表示します
record_signup	ユーザー登録時にコンバージョンイベントを記録します
list_tracked_links	ユーザー向けに生成されたすべてのトラッキングリンクを一覧表示します
record_commission	コミッションイベント（購入または更新）を記録します

---

必要条件

• Node.js >= 18
• AgentFuse API キー — agentfuse.io で取得できます

---

使い方

オプション 1 — Claude Code（推奨）

プロジェクトの .claude/mcp.json（またはグローバル設定の ~/.claude/mcp.json）に追加します。

{
  "mcpServers": {
    "agentfuse": {
      "command": "npx",
      "args": ["-y", "agentfuse-mcp"],
      "env": {
        "AGENTFUSE_API_KEY": "af_live_your_key_here"
      }
    }
  }
}

または、このリポジトリをローカルにクローンした場合：

{
  "mcpServers": {
    "agentfuse": {
      "command": "node",
      "args": ["/path/to/agentfuse-mcp/src/index.js"],
      "env": {
        "AGENTFUSE_API_KEY": "af_live_your_key_here"
      }
    }
  }
}

オプション 2 — 直接実行する

npm install
AGENTFUSE_API_KEY=af_live_... node src/index.js

オプション 3 — ツール一覧をテストする（API キー不要）

node src/index.js --test

---

エージェントとのやり取りの例

プログラムを閲覧する：

「AI ツールカテゴリのアフィリエイトプログラムをすべて一覧表示して」 -> list_affiliate_programs({ category: "ai-voice" }) を呼び出します

リンクを生成する：

「ユーザー [email protected] 用に、トラッキング付きの Webflow アフィリエイトリンクを作成して」 -> generate_tracked_link({ program_slug: "webflow", end_user_id: "[email protected]" }) を呼び出します

統計を確認する：

「今月のクリック数と登録数はいくつですか？」 -> get_stats() を呼び出します

---

環境変数

変数	必須	デフォルト	説明
AGENTFUSE_API_KEY	はい	--	AgentFuse API キー（af_live_...）
AGENTFUSE_API_URL	いいえ	https://api.agentfuse.io	API のベース URL を上書きします

---

ライセンス

MIT (c) AgentFuse / GSK AIOrch LLC