内容
# yourcx-mcp
连接Claude Desktop到[YourCX](https://yourcx.io)客户体验平台的MCP服务器。
要求Claude浏览您的调查问卷，分析受访者答案，按细分市场过滤结果，并更新细分市场值 — 所有操作均以自然语言进行。
---
## 功能
- 浏览客户、调查问卷和调查问题
- 获取分页的调查结果，支持强大的基于分段的过滤器
- 检查个别受访者答案
- 更新结果的分段值（批量或单个）
---
## 要求
- Node.js v18 或更新版本
- [Claude Desktop](https://claude.ai/download)
- YourCX API 密钥（从您的 YourCX 面板中获取）
---
## 安装
```bash
git clone https://github.com/YOUR_USERNAME/yourcx-mcp.git
cd yourcx-mcp
npm install
```
---
## 配置
将服务器添加到您的Claude Desktop配置文件中。
**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
```json
{
"mcpServers": {
"yourcx": {
"command": "node",
"args": ["C:/path/to/yourcx-mcp/index.js"],
"env": {
"YOURCX_API_KEY": "your_api_key_here",
"YOURCX_CLIENT_ID": "1234",
"YOURCX_BASE_URL": "https://panel.yourcx.io/new/api/v1"
}
}
}
}
```
保存后重启Claude Desktop。
---
## 环境变量
| 变量 | 是否必需 | 描述 |
|---|---|---|
| `YOURCX_API_KEY` | 是 | 您的YourCX API密钥 |
| `YOURCX_CLIENT_ID` | 否 | 默认客户端ID — 如果设置，则在每次工具调用时省略 |
| `YOURCX_BASE_URL` | 否 | API基础URL（默认：`https://panel.yourcx.io/new/api/v1`） |
---
## 可用工具
| 工具 | 描述 |
|---|---|
| `list_clients` | 列出所有可使用API密钥访问的客户端 |
| `get_client` | 获取特定客户端的详细信息 |
| `list_surveys` | 列出客户端的所有调查问卷 |
| `get_survey` | 获取特定调查问卷的完整详细信息 |
| `list_questions` | 列出调查问卷的所有问题和答案选项 |
| `get_question` | 获取单个调查问题的详细信息 |
| `list_segments` | 列出调查问卷的所有可用分段 |
| `get_results` | 获取分页的调查结果，支持可选过滤器 |
| `get_result` | 获取单个调查结果的完整详细信息 |
| `update_results` | 批量更新多个结果的分段值 |
| `update_result` | 更新单个结果的分段值 |
---
## 示例提示
- "列出我所有的YourCX调查问卷"
- "显示调查问卷5432的20个最新结果"
- "调查问卷5432有哪些问题？"
- "获取调查问卷5432的结果，其中time_day介于2024-01-01和2024-06-30之间"
- "调查问卷5432有哪些分段？"
- "更新调查问卷5432的结果1234567 — 将客户端分段'priority'设置为'高'"
---
## 许可证
MIT
