Affonso MCP Server

什么是 Affonso MCP Server？

Affonso MCP 服务器是 Affonso 官方托管的端点（https://api.affonso.io/mcp），让 AI 助手管理 Affonso 联盟营销计划：联盟伙伴、推荐、佣金、付款、欺诈事件和合作伙伴发掘。

Affonso 是面向软件公司的合作伙伴增长平台。它帮助团队运营联盟、创作者和应用内推荐计划，追踪哪些合作伙伴带来了付费客户，通过计费集成让佣金与订阅、续费和退款保持同步，并在完成身份、税务和欺诈检查后向合作伙伴付款。MCP 服务器把这些操作封装为 35 个工具，你可以让 Claude 或其他助手审批佣金、查询合作伙伴，而不必在后台逐页点击。

如何使用 Affonso MCP Server？

你需要一个 Affonso 账户。根据 Affonso 的定价页，MCP 集成包含在 Growth 和 Elite 套餐中，Launch 套餐不包含。

有两种认证方式：

• OAuth 2.1（推荐用于 AI 应用）：添加 URL 后在浏览器中登录 Affonso；如果你属于多个团队，选择一个团队，然后批准所请求的权限。无需 API 密钥。
• API 密钥（IDE 和自定义客户端）：在 Affonso 中创建密钥（生产密钥以 sk_live_ 开头），以 Authorization: Bearer ${AFFONSO_API_KEY} 的形式发送。Affonso 提醒，密钥拥有你联盟数据的完全访问权限，请勿提交到版本控制中。

Claude Code

Affonso 文档使用下面的命令，然后在提示时登录（在 Claude Code 中运行 /mcp 可发起或查看认证状态）：

claude mcp add --transport http --scope user affonso https://api.affonso.io/mcp

如果改用 API 密钥，先导出密钥，再以请求头传入：

export AFFONSO_API_KEY="sk_live_..."
claude mcp add --transport http affonso https://api.affonso.io/mcp --header "Authorization: Bearer ${AFFONSO_API_KEY}"

Claude Desktop 和 claude.ai

打开 Settings > Connectors > Add custom connector，命名为"Affonso"，填写 https://api.affonso.io/mcp。连接时会在浏览器中打开 Affonso 的 OAuth 登录页面。

Cursor

Affonso 文档给出了下面的 ~/.cursor/mcp.json 配置，保存后重启 Cursor：

{
  "mcpServers": {
    "affonso": {
      "url": "https://api.affonso.io/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-key>"
      }
    }
  }
}

VS Code

在 .vscode/mcp.json 中添加服务器。VS Code 首次连接时会在浏览器中完成 OAuth 登录：

{
  "servers": {
    "affonso": {
      "type": "http",
      "url": "https://api.affonso.io/mcp"
    }
  }
}

Affonso MCP Server 的主要功能

• 官方托管服务器，使用 Streamable HTTP，无需在本地安装任何东西。
• 支持带团队选择的 OAuth 2.1 登录，也支持 IDE 和脚本使用 API 密钥访问。
• 35 个工具覆盖七个领域：联盟伙伴、欺诈事件、推荐、佣金、付款、合作伙伴发掘（Finder）和推广素材。
• 支持批量操作，例如批量更新联盟伙伴、批量审批佣金。
• 可访问 Risk Center：在对话中列出、确认和处理欺诈事件。
• 通过 Finder 工具和团队候选清单发掘合作伙伴。
• 默认返回 Markdown，也可通过 response_format 参数返回 JSON。

Affonso MCP Server 的使用场景

• 月度佣金审核："列出本月待处理的佣金，并审批来自已验证联盟伙伴的那些。"
• 付款处理："告诉我哪些联盟伙伴应该付款了，并处理这些付款。"
• 欺诈排查："列出 Risk Center 中未处理的欺诈事件，总结哪些看起来像自我推荐。"
• 合作伙伴入驻："为 jane@example.com 创建一个联盟伙伴，然后列出我们当前的推广素材。"
• 招募合作伙伴："在 Finder 中搜索适合我们产品的联盟机会，把前五个加入候选清单。"
• 报表："上个季度哪些联盟伙伴带来的转化最多？"

Affonso MCP Server 常见问题排查

• "API key is required. Use Authorization: Bearer <api_key>"：客户端既没有完成 OAuth，也没有提供密钥。请完成浏览器登录，或添加 Authorization: Bearer 请求头。
• 不确定套餐是否包含 MCP：Affonso 定价页只在 Growth 和 Elite 套餐中列出了 MCP 集成。配置客户端之前请先确认你的套餐。
• 看到的是其他团队的数据：如果你属于多个团队，OAuth 会要求你选择团队。重新连接并选择正确的团队。
• Cursor 识别不到服务器：Affonso 指南提示，保存 mcp.json 后需要重启 Cursor。