关于 QoreNext CRM MCP
QoreNext CRM MCP 服务让 Claude 等 AI 客户端在对话中执行企业层级分析、地址验证和 CRM 账户去重。它通过请求提交与状态查询处理这些数据质量任务。
主要功能
- 01验证公司地址与合法性
- 02分析母公司及子公司关系
- 03从文件检测重复 CRM 账户
- 04查询处理请求状态
适用场景
- 01验证 CRM 公司名称和地址
- 02梳理企业母子公司层级
- 03从 CRM 文件识别重复账户
MCP 相关
该服务将地址验证、企业层级分析、重复记录检测和请求状态查询作为 MCP 工具提供。客户端通过远程 HTTP 服务连接,并使用 QoreNext API 密钥进行认证。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
Qorenext CRM MCP
通过 MCP 进行公司层级分析和地址验证
Qorenext CRM MCP 是一个 Model Context Protocol 服务,可让 Claude 和其他 AI 客户端直接在聊天中执行公司层级分析和地址验证。
前提条件:
• 已安装 Node.js 和 npm(npm 用于安装连接器包)。
• 拥有 QoreNext CRM api key。
• 使用 Qore MCP 需要订阅有效的产品。
• 拥有管理员权限或标准权限,以便编辑用户配置文件中的文件。
获取 API key
访问 https://qorenext-app.azurewebsites.net/signup 注册,以获取 QORENEXT_API_KEY。
获取 API Key 的步骤
- 访问 https://qorenext-app.azurewebsites.net/signup 注册。
- 选择 CRM On-Demand Data Quality & Enrichment 产品。
- 购买套餐——使用 Qore MCP 需要订阅有效的产品。
- 打开 Profile → APIs。
- 点击 Generate API Key。
- 为 API key 命名,然后点击 Create。
- 复制 API key,以便在 Claude 中使用。
如何连接:
A)Claude Code
claude mcp add --transport http qorenext-mcp \
"https://mcp.qorenext.com/crm" \
--header "X-API-Key: YOUR_API_KEY"
B)Claude Desktop
前提条件:
• 已在 Windows 上安装 Claude Desktop。
• 已安装 Node.js 和 npm(npm 用于安装连接器包)。
• 拥有 QoreNext CRM api key。
• 使用 Qore MCP 需要订阅有效的产品。
• 拥有管理员权限或标准权限,以便编辑用户配置文件中的文件。
安装 Node.js
- 从 nodejs.org 下载并安装 LTS 版本。
- 安装程序会同时安装 npm 和 npx。
- 打开 Terminal(Mac)或 Command Prompt/PowerShell(Windows)。
- 验证安装:`bash below commands
node -v
npx -v
两个命令都应显示版本号。
如果看到“command not found”,请重启终端后重试。
## Claude Desktop 设置步骤
1. 打开 Claude Desktop
在电脑上启动 Claude Desktop 应用程序。
2. 打开设置
转到: Menu → File → Settings
3. 打开开发者设置
在设置窗口中,从左侧菜单选择 Developer。
4. 打开配置文件
点击 Edit Config,打开 claude_desktop_config.json 文件。
删除文件中现有的命令,然后将下方提供的配置粘贴进去,格式为 Json。
Windows 默认位置:
C:\Users<YourUsername>\AppData\Roaming\Claude\claude_desktop_config.json 或 ~/Library/Application Support/Claude/claude_desktop_config.json(Mac)
5. 添加 QoreNext MCP 服务
将以下配置添加到 claude_desktop_config.json,并将 qore_xxxxx 替换为你的真实 API key。
{
"mcpServers": {
"qorenext-mcp-crm": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.qorenext.com/crm",
"--header",
"X-API-Key:qore_xxxxx"
]
}
}
}
注意 JSON 语法 确保 JSON 的大括号和逗号完全匹配——缺少一个逗号就会导致文件无法使用。
6. 保存文件
保存更改(Ctrl+S)并关闭编辑器。
7. 重启 Claude Desktop
完全退出 Claude Desktop:关闭应用,从系统托盘/任务栏退出,并使用任务管理器结束所有仍在后台运行的 Claude 进程;然后重新打开 Claude Desktop。
C)ChatGPT Desktop
本指南介绍如何在 ChatGPT Desktop 应用程序中配置 QoreNext MCP 服务。
前提条件
- 电脑上已安装 ChatGPT Desktop。
- 拥有有效的 QoreNext API key。
- 可连接互联网。
步骤 1:打开 ChatGPT Desktop
- 启动 ChatGPT Desktop 应用程序。
- 在 ChatGPT 窗口顶部,找到 New Chat 图标上方的模式下拉菜单。
- 将模式切换为 Codex。
步骤 2:打开设置
- 点击 ChatGPT 窗口左下角的个人资料图标。
- 选择 Settings。
步骤 3:打开插件
导航至:
Integrations → Plugins
步骤 4:添加 MCP 服务
- 在插件窗口中,点击 Add 下拉菜单。
- 选择 Add MCP Server。
步骤 5:配置 QoreNext MCP 服务
名称
QoreNext MCP Server
启动命令
npx
参数
逐个添加以下参数:
-y
mcp-remote
https://mcp.qorenext.com/crm
--header
X-API-Key: YOUR_API_KEY
**将 YOUR_API_KEY 替换为你实际的 QoreNext API 密钥。
第 6 步:保存 MCP 服务
- 检查所有字段和参数。
- 点击 Save。
- 关闭配置窗口。
第 7 步:重启 ChatGPT Desktop
- 完全关闭 ChatGPT Desktop。
- 打开任务管理器,并结束所有仍在运行的 ChatGPT 进程。
- 重新打开 ChatGPT Desktop。
- ChatGPT Desktop 打开后,将模式从 Codex 切换为 ChatGPT
D) Cursor / Windsurf
添加到 .cursor/mcp.json 或 .windsurf/mcp.json:
{
"mcpServers": {
"qorenext-mcp-crm": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.qorenext.com/crm",
"--header",
"X-API-Key:qore_xxxxx"
]
}
}
}
工具
| 工具 | 身份验证 | 描述 |
|---|---|---|
health_check | ❌ 公开 | 验证服务是否正在运行,并获取版本信息 |
submit_address_verification | ✅ API 密钥 | 提交公司信息以进行地址验证和核验 |
submit_hierarchy_creation | ✅ API 密钥 | 提交公司信息以进行企业层级分析,包括最上层母公司与子公司的关系 |
submit_duplicates | ✅ API 密钥 | 提交 JSON、CSV 或 Excel 文件中的 CRM 账户记录,以检测重复项 |
get_request_status | ✅ API 密钥 | 查询地址验证、层级分析或重复项检测请求的状态并获取结果 |
health_check
验证服务是否正在运行。无需 API 密钥。
check if Qorenext CRM MCP is running
submit_address_verification
提交公司信息以进行地址验证和合法性核验。
每个实体必填: companyName、country、address
可选: crmid、website
verify Acme Corp at 123 Main Street, New York, USA
validate Apple Inc at 1 Apple Park Way, Cupertino, USA
check Samsung at Samsung Tower, Seoul, South Korea
submit_hierarchy_creation
提交公司信息以进行企业层级分析,包括最上层母公司与子公司的关系,从而识别母子公司关系。
每个实体必填: companyName、country
可选: crmid、address、website
create hierarchy for Acme Corp from USA
analyze organizational structure for Apple Inc from USA
map corporate relationships for Samsung from South Korea
submit_duplicates
提交文件(JSON 或 CSV)中的重复账户记录,以检测重复项。
必填: file_content、file_type
可选: file_name
支持的文件类型:
json- JSON 数组格式csv- 带标题行的逗号分隔值
必填字段(CSV 和 Excel 文件中的每条记录):
crmAccountId- 账户标识符crmAccountName- 账户/公司名称addressLine1- 街道地址country- 国家/地区名称
可选字段:
addressLine2- 套房、公寓、单元等信息city- 城市名称stateProvince- 州或省postalCode- 邮政编码website- 网站 URL
文件格式要求:
JSON 数组:
[
{
"crmAccountId": "CRM-00001",
"crmAccountName": "Acme Technologies",
"addressLine1": "123 Main Street",
"addressLine2": "Suite 100",
"city": "New York",
"stateProvince": "NY",
"country": "United States",
"postalCode": "10001",
"website": "www.acmetech.com"
},
{
"crmAccountId": "CRM-00002",
"crmAccountName": "Blue Ridge Software",
"addressLine1": "456 Oak Avenue",
"country": "United States"
}
]
带标题行的 CSV:
crmAccountId,crmAccountName,addressLine1,city,stateProvince,country,postalCode,website
CRM-00001,Acme Technologies,123 Main Street,New York,NY,United States,10001,www.acmetech.com
CRM-00002,Blue Ridge Software,456 Oak Avenue,Los Angeles,CA,United States,90001,www.blueridgesoftware.com
Excel 工作簿:
- 第一行:列标题
- 数据行:账户记录
- 必填列:crmAccountId、crmAccountName、addressLine1、country
- 可选列:addressLine2、city、stateProvince、postalCode、website
示例:
submit deduplication for CSV file with 50 company records
detect duplicates from Excel file of CRM accounts
process JSON file to find similar companies
返回值:
data:检测到的重复项对数message:结果说明details:记录数和重复项对数
响应示例(状态 200):
{
"success": true,
"status_code": 200,
"data": 66,
"message": "Successfully detected 66 duplicate pairs from 8 records",
"details": {
"records_submitted": 8,
"duplicate_pairs_found": 66,
"file_name": "accounts.csv",
"file_type": "csv"
}
}
get_request_status
查询 CRM 处理请求的状态并获取结果。
参数: request_id(int)
状态值: PENDING · PROCESSING · COMPLETE · FAILED
get status of request 1001
check if CRM request 5042 is complete
示例工作流
地址验证:
You: Verify Apple Inc at 1 Apple Park Way, Cupertino, USA.
Claude: [calls submit_address_verification]
✅ Submitted. Entity ID: 1042
You: Get status of request 1042
Claude: [calls get_request_status]
Status: COMPLETE
Address Verified: ✅ Yes
Business Status: ACTIVE
# ✅ Address Verification Result
## Apple Inc.
**Submitted**ddress:** 1 Apple Park Way, Cupertino, USA
| Field | Submitted | Verified |
|------------------------|------------------------------------|----------------------------------|
| Address | 1 Apple Park Way, Cupertino, USA | 1 Apple Park Way, Cupertino, USA |
| City | | Cupertino | Cupertino |
| State | California | California |
| Zip | 95014 | 95014 |
| Country | United States | United States |
## Verification Status
✅ **Address verified successfully.**
The submitted address matches the verified address.
**Status:** Confirmed
层级创建:
You: Create hierarchy for Acme Corp from USA.
Claude: [calls submit_hierarchy_creation]
✅ Submitted. Entity ID: 1043
You: Get status of request 1043
Claude: [calls get_request_status]
Status: COMPLETE
# Output Files
# 🌍 Corporate Hierarchy Report
## Acme Corp
### Top Parent
| Role/Level | Entity Name | Parent ID | Country | City | State/Province | Address Line 1 | Postal Code | SIC | NAICS |
|------------|-------------|-----------|---------|------|----------------|----------------|-------------|-----|-------|
| Top Parent | Acme Corp | 101 | United States | Milwaukee | Wisconsin | 5445 N 27th St | 53209 | 3421 | 332215 |
### Subsidiaries
| Entity Name | Country | City | State/Province | Address |
|-------------|---------|------|----------------|---------|
| Acme United (Asia Pacific) Limited | Hong Kong | Kwun Tong | - | 57 Hung To Road Nanyang Plaza, Unit 2101 21/F |
| Acme United China Limited | China | Guangzhou | Guangdong | Zhongshanliu Rd, Unit 1206-1207 12/F Newpoly Tower #2 |
| Acme United Europe GmbH | Germany | Solingen | - | Junkerstraße 13-15 |
| Acme United Limited | United States | Shelton | Connecticut | 1 Waterview Drive, Suite 200 |
| Acme United (APAC) Pte. Ltd. | Singapore | Singapore | - | 9 Raffles Place Republic Plaza, #26-01 |
| Acme United Netherlands Cooperatie U.A. | Netherlands | Maastricht | Limburg | Kruisdonk 66 |
## Contact Information
| Entity Name | Phone Number |
|-------------|--------------|
| Acme United (Asia Pacific) Limited | 85231677878 |
| Acme United Europe GmbH | 49212232450 |
| Acme United Limited | 8008352263 |
## Summary
- **Top Parent:** Acme Corp
- **Parent ID:** 101
- **Total Entities:** 7
- **Subsidiaries:** 6
- **Countries Covered:** United States, Hong Kong, China, Germany, Singapore, Netherlands
- **SIC Code:** 3421
- **NAICS Code:** 332215
## Verification Status
✅ **Corporate hierarchy extracted successfully.**
The hierarchy contains one top parent entity and six subsidiary entities linked to Parent ID **101**.
**Status:** Confirmed
CRM 去重提交
你:提交去重文件 CRM_Dedupe_TestSet.csv
Claude:[调用 submit_duplicates] ✅ 提交成功
文件:CRM_Dedupe_TestSet.csv
请求 ID:203
已提交记录数:500
你:查询请求 203 的状态
Claude:[调用 get_request_status]
状态:COMPLETE
已接受记录数:✅ 500
已拒绝记录数:0
输出文件
处理 CRM 数据后,该工具会生成两个输出文件。
1. 详细匹配结果文件
此文件包含输入文件中每条 CRM 记录的匹配结果。
此文件显示每条记录是否根据公司名称和地址与另一条记录匹配。
| 列 | 含义 |
|---|---|
| Group No | 分配给同一潜在重复组中记录的编号。 |
| Parent ID | 该组的主要或选定 CRM 记录 ID。 |
| Matched CRM ID | 正在检查的 CRM 记录 ID。 |
| CRM Account Name | CRM 中的公司名称。 |
| Address | CRM 账户的地址。 |
| Verdict | 匹配结果:强匹配、部分匹配或不匹配。 |
| Score | 公司名称和地址的相似度得分。得分越高,表示匹配度越高。 |
判定结果含义
- 强匹配 - 这些记录极有可能是重复记录。
- 部分匹配 - 这些记录相似,可能需要审核。
- 不匹配 - 未发现该记录的重复匹配项。
示例
| Group No | Parent ID | Matched CRM ID | CRM Account Name | Address | Verdict | Score |
|---|---|---|---|---|---|---|
| 1 | CRM3001B | CRM3001B | MetroVale Tech Partners Ltd. | 143 E Indl Pkwy | 不匹配 | 0 |
| 2 | CRM3002B | CRM3002B | Northstar Logic Information Sys. Limited | 180 Mt Pleasant Rd | 不匹配 | 0 |
| 3 | CRM3002A | CRM3002A | Northstar Logic Information Systems Limited | 180 Mt Pleasant Rd | 强匹配 | 95 |
| 3 | CRM3002A | CRM3002B | Northstar Logic Information Sys. Limited | 180 Mt Pleasant Rd | 强匹配 | 95 |
2. 唯一记录文件
此文件提供一份经过清理、需要保留的记录列表。
对于每个重复组,此文件仅包含一条选定的 CRM 记录。如果某组存在强匹配或部分匹配,其余记录不会在此文件中重复列出。
所有判定结果为不匹配的记录也会包含在内,因为它们本身就是唯一记录。
例如,如果某组包含两条部分匹配记录和一条强匹配记录,此文件只会显示该组中选定的一条记录。
| 列 | 含义 |
|---|---|
| Group No | 匹配过程中分配的组编号。 |
| Matched CRM ID | 选定的唯一 CRM 记录 ID。 |
| CRM Account Name | 选定记录的公司名称。 |
| Address | 选定记录的地址。 |
示例
| Group No | Matched CRM ID | CRM Account Name | Address |
|---|---|---|---|
| 1 | DD011 | Northstar Analytics Pvt Ltd | India 42 Park View Road, Sector 18, Noida, Dist. Gautam Buddha Nagar, UP 201301 |
| 2 | DD012 | BluePeak Technologies Inc | United States 1250 Market Street, Suite 400, San Francisco, CA 94102 |
| 3 | DD022 | GREENFIELD LOGISTICS LLC | United States 8800 Westheimer Road, Houston, Texas 77063 |
总结
- 使用详细匹配结果文件审核所有匹配判定。
- 当您需要每个重复组保留一条记录,并包含所有未与其他记录匹配的记录时,请使用唯一记录文件。
支持
- 问题反馈:https://github.com/QoreNext/qorenext-crm-mcp/issues
- 电子邮箱:[email protected]
- 文档:https://qorenext.com
许可证
MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。