AI导哈

AI客户反馈分析客户端

轻量级MCP协议客户端，为AI助手提供客户反馈数据访问和高级搜索功能。

  • by closedloop-ai-org
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 closed-loop-ai/mcp-client

使用说明

ClosedLoop AI MCP客户端

一个轻量级的模型上下文协议（MCP）客户端，为AI助手提供对ClosedLoop AI客户反馈数据和高级搜索功能的访问。

特性

  • MCP协议支持：用于AI客户端集成的完整MCP协议实施
  • API密钥验证：安全的基于团队的API密钥身份验证
  • 团队隔离：所有数据访问的范围均为拥有API密钥的团队
  • 高级搜索：全文搜索，在8+个洞察领域进行相关性排名
  • 三个核心工具:
    • list_insights：通过日期范围和分页获取客户见解
    • get_insight_detail：获取有关具体见解的详细信息
    • search_insights: 新 具有过滤和相关性排名的高级全文搜索

安装

npm install -g @closedloop-ai/mcp-client

配置

设置以下环境变量：

  • CLOSEDLOOP_API_KEY：您的ClosedLoop AI API密钥（必需）
  • CLOSEDLOOP_SERVER_URL：服务器URL（默认值：https://mcp.closedloop.sh)

与Claude一起使用

将此配置添加到您的Claude Desktop应用程序：

{
  "mcpServers": {
    "closedloop": {
      "command": "npx",
      "args": ["@closedloop-ai/mcp-client"],
      "env": {
        "CLOSEDLOOP_API_KEY": "your-api-key-here",
        "CLOSEDLOOP_SERVER_URL": "https://mcp.closedloop.sh"
      }
    }
  }
}

MCP工具

list_景点

通过可选的过滤和分页检索客户见解。

参数：

参数 类型 必填 说明
date_from string 否 开始日期（YYYY-MM-DD）
date_to string 否 结束日期（YYYY-MM-DD）
page integer 否 页码（默认值：1）
limit integer 否 每页项目数（默认值：20，最大值：100）

响应字段：

字段 类型 描述
id string 唯一洞察标识符（UUID）
signal_title string 见解的标题/摘要
content string 原始反馈内容
category string 洞察类别（Bug、功能请求等）
severity string 严重性级别（严重、高、中、低）
status string 处理状态
source_timestamp string 收到反馈时
customer_name string 提供反馈的客户
reporter_name string 报告见解的人
pain_point string 已识别的客户痛点
is_deal_blocker boolean 这是否会阻止交易
relevance_score number 业务相关性得分
source_name string 集成源名称
created_at string 创建洞察力时

响应示例：

{
  "insights": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "signal_title": "Mobile app crashes on startup",
      "content": "The app keeps crashing whenever I try to open it...",
      "category": "Bug",
      "severity": "high",
      "status": "processed",
      "source_timestamp": "2024-01-15T10:30:00Z",
      "customer_name": "Acme Corp",
      "reporter_name": "John Smith",
      "pain_point": "Cannot access mobile features",
      "is_deal_blocker": true,
      "relevance_score": 0.85,
      "source_name": "Intercom",
      "created_at": "2024-01-15T10:35:00Z"
    }
  ],
  "pagination": {
    "total_count": 142,
    "page": 1,
    "limit": 20,
    "total_pages": 8
  }
}

get_insights_detail

获取特定洞察项目的详细信息。

参数：

参数 类型 必填 说明
insight_id string 是 洞察项的UUID

响应字段：

字段 类型 描述
id string 唯一洞察标识符（UUID）
signal_title string 见解的标题/摘要
content string 原始反馈内容
category string 洞察类别
severity string 严重性级别
status string 处理状态
summary string 人工智能生成的摘要
outcome_categories array 业务影响类别
customer_name string 提供反馈的客户
customer_email string 客户电子邮件地址
reporter_name string 报告见解的人
source_name string 集成源名称
pain_point string 已识别的客户痛点
workaround string 客户当前的解决方法
use_case string 用例描述
feature_area string 相关功能区域
competitor_gap string 竞争分析说明
willingness_to_pay string 支付意愿信息
source_timestamp string 收到反馈时
created_at string 创建洞察力时

响应示例：

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "signal_title": "Mobile app crashes on startup",
  "content": "The app keeps crashing whenever I try to open it on my iPhone...",
  "category": "Bug",
  "severity": "high",
  "status": "processed",
  "summary": "Critical mobile stability issue affecting iOS users on app launch",
  "outcome_categories": ["Product Quality", "User Experience", "Retention Risk"],
  "customer_name": "Acme Corp",
  "customer_email": "john@acme.com",
  "reporter_name": "John Smith",
  "source_name": "Intercom",
  "pain_point": "Cannot access mobile features, forced to use desktop",
  "workaround": "Using the web version on mobile browser",
  "use_case": "Field sales team needs mobile access for client meetings",
  "feature_area": "Mobile App",
  "competitor_gap": "Competitor X has stable mobile app",
  "willingness_to_pay": "Would pay extra for reliable mobile experience",
  "source_timestamp": "2024-01-15T10:30:00Z",
  "created_at": "2024-01-15T10:35:00Z"
}

搜索_景点

通过相关性排名和全面过滤，对客户洞察进行高级全文搜索。

主要特点：

  • 全文搜索 跨越8+个洞察领域
  • 相关性排名 -最相关的结果首先出现
  • 短语搜索 模糊匹配
  • 特定字段搜索 -搜索特定字段或所有字段
  • 高级过滤 -类别、严重性、日期范围、来源
  • 语言不可知论 -适用于任何语言

参数：

参数 类型 必填 说明
query string 是 搜索查询文本
fields array 否 要搜索的特定字段
category string 否 按洞察类别筛选
severity string 否 按严重级别筛选
date_from string 否 开始日期筛选器（YYYY-MM-DD）
date_to string 否 结束日期筛选器（YYYY-MM-DD）
source string 否 按数据源筛选
page integer 否 页码（默认值：1）
limit integer 否 每页项目数（默认值：20，最大值：100）

可搜索字段：

  • signal_title -见解标题
  • content -原始反馈内容
  • pain_point -客户痛点
  • workaround -客户解决方法
  • use_case -用例描述
  • feature_area -特征分类
  • competitor_gap -竞争分析
  • willingness_to_pay -支付意愿信息

响应字段：

字段 类型 描述
id string 唯一洞察标识符（UUID）
signal_title string 见解的标题/摘要
content string 原始反馈内容
category string 洞察类别
severity string 严重性级别
search_rank number 搜索相关性得分（越高=相关性越高）
summary string 人工智能生成的摘要
outcome_categories array 业务影响类别
is_deal_blocker boolean 这是否会阻止交易
relevance_score number 业务相关性得分
customer_name string 提供反馈的客户
source_name string 集成源名称
source_timestamp string 收到反馈时

响应示例：

{
  "insights": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "signal_title": "Mobile app crashes on startup",
      "content": "The app keeps crashing whenever I try to open it...",
      "category": "Bug",
      "severity": "high",
      "search_rank": 0.92,
      "summary": "Critical mobile stability issue affecting iOS users",
      "outcome_categories": ["Product Quality", "User Experience"],
      "is_deal_blocker": true,
      "relevance_score": 0.85,
      "customer_name": "Acme Corp",
      "source_name": "Intercom",
      "source_timestamp": "2024-01-15T10:30:00Z"
    }
  ],
  "pagination": {
    "total_count": 23,
    "page": 1,
    "limit": 20,
    "total_pages": 2
  },
  "query": "mobile crash"
}

示例用法

配置后，您可以向Claude提出以下问题：

基本见解

  • “向我展示上周的所有负面见解”
  • “本月最重要的客户洞察是什么？”

高级搜索

  • “搜索移动应用程序性能问题”
  • “在性能问题类别中查找有关加载时间缓慢的见解”
  • “在痛点和支付意愿领域搜索定价问题”
  • “查找本月所有严重性较高的错误”
  • “使用Typeform搜索集成问题”

搜索示例

  • 短语搜索：“查找有关'移动应用程序启动'的见解”
  • 特定领域：“搜索‘令人沮丧的经历’的痛点”
  • 类别筛选器：“查找有关‘实时协作’的所有Feature Request见解”
  • 严重性筛选器：“搜索与‘安全’相关的关键问题”
  • 日期范围：“查找2024年1月以来的性能问题”

许可证

麻省理工学院

相关 MCP