内容
# @affilync/mcp-server
Affilync 的 MCP（模型上下文协议）服务器 - 直接从 Claude 管理联盟营销。
## 设置
### Claude 桌面版
将以下内容添加到 `~/Library/Application Support/Claude/claude_desktop_config.json`：
```json
{
"mcpServers": {
"affilync": {
"command": "npx",
"args": ["@affilync/mcp-server"],
"env": {
"AFFILYNC_TOKEN": "<你的jwt-token>"
}
}
}
}
```
### Claude 代码
```bash
claude mcp add affilync -- env AFFILYNC_TOKEN=<你的jwt-token> npx @affilync/mcp-server
```
### 获取令牌
服务器将 `AFFILYNC_TOKEN` 发送为 `Authorization: Bearer <token>`，因此它必须是 **JWT 访问令牌**（来自您的 Affilync 登录会话或 OAuth 流）- 开发者 **API 密钥 (`af_live_...`) 将不能直接在此服务器上使用**。要获取一个：请登录 https://app.affilync.com，或完成 OAuth 流（参见 Affilync CLI/SDK），并将访问令牌值用作 `AFFILYNC_TOKEN`。注意令牌过期（~60 分钟）；根据需要重新颁发。
## 可用工具
### 共享（所有用户）
| 工具 | 描述 |
|------|-------------|
| `getUserProfile` | 获取您的个人资料（联盟或品牌方） |
| `searchCampaigns` | 按名称/类别搜索活动 |
| `getNotifications` | 查看最近的通知 |
### 联盟工具
| 工具 | 描述 |
|------|-------------|
| `listAvailableCampaigns` | 浏览可加入的活动 |
| `joinCampaign` | 申请加入活动 |
| `generateAffiliateLink` | 创建跟踪链接 |
| `listMyLinks` | 查看您的跟踪链接 |
| `getEarningsSummary` | 总/待结/可用收益 |
| `listCommissions` | 单个佣金记录 |
| `getClickAnalytics` | 点击量统计（今日/周/月） |
| `requestPayout` | 结算可用收益 |
| `listActiveCampaigns` | 您已加入的活动 |
### 品牌方工具
| 工具 | 描述 |
|------|-------------|
| `createCampaign` | 创建具有佣金结构的活动 |
| `listBrandCampaigns` | 查看您的活动 |
| `getCampaignPerformance` | 活动指标（点击量、转化率、EPC） |
| `listAffiliateApplications` | 查看申请 |
| `decideApplication` | 批准/拒绝申请 |
| `getBrandDashboard` | 品牌整体表现 |
| `listBrandAffiliates` | 与您合作的联盟 |
## 开发
```bash
npm install
AFFILYNC_TOKEN=<令牌> npm run dev
```
## 环境变量
| 变量 | 是否必需 | 默认值 | 描述 |
|----------|----------|---------|-------------|
| `AFFILYNC_TOKEN` | 是 | — | JWT 访问令牌 |
| `AFFILYNC_API_URL` | 否 | `https://api.affilync.com` | API 基地址 |
