agentfuse-mcp

agentfuse-mcp

适用于 AgentFuse 的 MCP 服务——面向 AI Agent 的联盟营销 API 中间件。

任何兼容 MCP 的 AI Agent（Claude Code、Cowork、自定义 Agent）都可以浏览联盟计划、生成跟踪链接并记录转化，无需编写 HTTP 代码。

---

工具

工具	描述
list_affiliate_programs	浏览目录中的所有计划（可按类别筛选）
get_affiliate_program	根据 slug 获取某个计划的完整详情
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

---

Agent 交互示例

浏览计划：

“列出 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