@retainq/mcp

RetainQ MCP 服务器 — 将 AI 助手连接到您的流失减少平台。

这是什么？

这是用于 RetainQ 的 Model Context Protocol (MCP) 服务器。它让 AI 助手（如 Claude、Cursor、Kiro 等）与您的 RetainQ 工作区交互 — 查询留存指标、管理流程、分析流失数据等。

Related MCP server: Attio MCP Server

安装

npx @retainq/mcp

或全局安装：

npm install -g @retainq/mcp

配置

环境变量

设置您的 RetainQ API 密钥：

export RETAINQ_API_KEY=rq_live_your_key_here

从 RetainQ 仪表板的 设置 → API 密钥 获取 API 密钥。

MCP 客户端配置

添加到您的 MCP 客户端配置（例如 Claude Desktop、Kiro、Cursor）：

{
  "mcpServers": {
    "retainq": {
      "command": "npx",
      "args": ["@retainq/mcp"],
      "env": {
        "RETAINQ_API_KEY": "rq_live_your_key_here"
      }
    }
  }
}

可用工具（32 个）

分析

• get_retention_stats — 工作区指标概览

• get_recent_sessions — 最近的流程会话及结果

• get_top_churn_reasons — 按频率排序的取消原因

• get_high_risk_customers — 超过流失风险阈值的客户

• get_offer_performance — 优惠接受率和收入

流程

• list_flows — 列出所有流程

• get_flow — 获取流程详情

• create_flow — 创建新流程（简单或高级）

• update_flow — 更新流程元数据

• delete_flow — 归档流程

• configure_simple_flow — 设置简单流程配置（调查、优惠、反馈、设计）

• set_advanced_flow_schema — 设置基于节点的流程架构

• publish_flow — 发布并上线

• get_flow_schema — 获取当前已发布的架构

优惠

• list_offers — 列出所有留存优惠

• create_offer — 创建新优惠

• update_offer — 更新优惠

• delete_offer — 归档优惠

客户

• list_customers — 列出带有流失评分的客户

• get_customer — 按电子邮件获取客户

• get_customer_sessions — 获取客户的会话历史

机会

• list_opportunities — 列出留存机会

• confirm_opportunity — 确认/履行机会

• reject_opportunity — 拒绝机会

AI 智能

• run_churn_analysis — 运行 AI 驱动的流失分析

• ask_ai — 向 RetainQ AI 询问有关您数据的问题

通知

• list_notifications — 获取最近的通知

• get_notification_preferences — 获取通知设置

• update_notification_preferences — 更新通知设置

反馈

• list_feedback — 获取会话反馈/答案

• export_feedback_csv — 将反馈导出为 CSV

API 基础 URL

默认连接到 https://app.retainq.com/api/v1/public。可通过以下方式覆盖：

export RETAINQ_API_URL=http://localhost:3000/api/v1/public

许可证

MIT