retain-so

Retain MCP Server

让你的 AI Agent 了解哪些客户即将流失，并采取行动。

@retain-so/mcp-server 可将 Retain 连接到任意 MCP 客户端（Claude Code、Claude Desktop、Cursor、Windsurf 等）。你可以用自然语言询问哪些客户面临风险、调取客户的完整健康状况档案、查看面临风险的 MRR，以及记录客户联系情况，全程无需打开控制面板。

Retain 是一个 AI 优先的客户流失预防与客户分析平台。此服务是你的 Agent 与 Retain 数据之间的桥梁。

你可以让 Agent 做什么

读取：

• “本周有哪些客户面临严重风险？”
• “按 MRR 排序，列出我的高风险客户。”
• “我面临风险的 MRR 总额是多少？按风险级别细分。”
• “调取 Acme Inc. 的完整档案。”
• “列出我尚未联系的有效提醒。”
• “总结本月的客户流失指标和净收入留存率。”

执行操作（需要读写密钥）：

• “将 Globex 的提醒标记为已联系。”
• “归档 Initech 已解决的提醒。”

设置（不到 5 分钟）

1. 在 Retain 中，前往 Settings → Agent keys 并创建密钥。仅查询请选择 read；若要让 Agent 执行操作，请选择 read & write。复制密钥（仅显示一次）。
2. 添加下方适用于你的客户端的配置片段。
3. 重启客户端并提出你的第一个问题。

Claude Code

claude mcp add retain --env RETAIN_API_KEY=rk_agent_xxx -- npx -y @retain-so/mcp-server

Claude Desktop（claude_desktop_config.json）

{
  "mcpServers": {
    "retain": {
      "command": "npx",
      "args": ["-y", "@retain-so/mcp-server"],
      "env": { "RETAIN_API_KEY": "rk_agent_xxx" }
    }
  }
}

Cursor / Windsurf（.cursor/mcp.json 或 ~/.codeium/windsurf/mcp_config.json）

{
  "mcpServers": {
    "retain": {
      "command": "npx",
      "args": ["-y", "@retain-so/mcp-server"],
      "env": { "RETAIN_API_KEY": "rk_agent_xxx" }
    }
  }
}

工具

工具	类型	功能
get_at_risk_customers	读取	按客户流失风险（Critical/High/Stable/Healthy）列出客户，并按 MRR 排序。默认列出 Critical + High。
get_customer_details	读取	按 ID 或名称获取单个客户的完整档案。
get_mrr_at_risk	读取	面临风险的 MRR 总额，以及按风险级别统计的有效提醒数量。
get_active_alerts	读取	按优先级列出有效提醒，包含风险因素和联系状态。
get_churn_metrics	读取	客户流失率、流失的 MRR、扩张/收缩情况、净收入留存率。
mark_alert_contacted	写入	将提醒标记为已联系。
archive_alert	写入	归档已解决的提醒。

即将推出：send_retention_email（触发发送模板化客户留存邮件）。

对话示例

你： 哪些客户即将流失？涉及多少金额？

Agent： （调用 get_mrr_at_risk，然后调用 get_at_risk_customers） 你有 7 条有效提醒，涉及 4,200 美元的风险 MRR。金额最高的两位客户是 Acme Inc.（900 美元，严重风险，18 天未活跃）和 Globex（650 美元，高风险）。

你： 我今天给 Acme 发了邮件，将他们的提醒标记为已联系。

Agent： （调用 mark_alert_contacted） 已完成。Acme 的提醒现已标记为已联系。

配置

变量	必填	默认值	说明
RETAIN_API_KEY	是	（无）	在 Settings → Agent keys 中创建的 Agent 密钥。
RETAIN_API_URL	否	https://api.retain.so	覆盖 API 基础 URL（自托管/预发布环境）。

开发

npm install
npm run dev        # run from source with tsx
npm run build      # bundle to dist/
npm run typecheck

该服务不包含业务逻辑或数据库，只负责将 MCP 工具调用转换为针对 Retain 公共 /agent/* API 的 HTTP 请求。欢迎贡献代码和开发新工具。

许可证

MIT