qorenext-mcp

QorenextMCP

通过 MCP 进行公司层级分析和地址验证

QorenextMCP 是一个 Model Context Protocol 服务，可让 Claude 和其他 AI 客户端直接在聊天中执行公司层级分析和地址验证。

---

获取 API 密钥

前往 https://qorenext-app.azurewebsites.net/signup 注册，即可获取 QORENEXT_API_KEY。

---

连接

Claude Code

claude mcp add --transport http qorenext-mcp \
  "https://mcp.qorenext.com/crm" \
  --header "X-API-Key: YOUR_API_KEY"

Claude Desktop

编辑 %APPDATA%\Claude\claude_desktop_config.json（Windows） 或 ~/Library/Application Support/Claude/claude_desktop_config.json（Mac）：

{
  "mcpServers": {
    "qorenext-mcp": {
      "url": "https://mcp.qorenext.com/crm",
      "headers": {
        "X-API-Key": "YOUR_API_KEY",
        "Content-Type": "application/json",
        "Accept": "application/json"
      }
    }
  }
}

Cursor / Windsurf

添加到 .cursor/mcp.json 或 .windsurf/mcp.json：

{
  "mcpServers": {
    "qorenext-mcp": {
      "url": "https://mcp.qorenext.com/crm",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

---

工具

工具	身份验证	描述
health_check	❌ 公开	验证服务是否正在运行，并获取版本信息
submit_address_verification	✅ API 密钥	提交公司信息以进行地址验证和核验
submit_hierarchy_creation	✅ API 密钥	提交公司信息以进行组织层级分析
submit_duplicates	✅ API 密钥	从 JSON、CSV 或 Excel 文件中提交重复实体
get_request_status	✅ API 密钥	轮询状态并获取任何筛查请求的结果

---

health_check

验证服务是否正在运行。无需 API 密钥。

check if QorenextMCP 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 或 Excel）中的重复账户记录，以检测重复项。

必填： file_content、file_type

可选： file_name

支持的文件类型：

• json - JSON 数组格式
• csv - 带标题行的逗号分隔值
• excel 或 xlsx - Microsoft Excel 工作簿

必填字段（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

轮询筛查请求的状态和结果。

参数： request_id（int）

状态值： PENDING · PROCESSING · COMPLETE · FAILED

get status of request 1001
check if screening 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

层级创建：

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
        Hierarchy: Acme Corp → Acme Holdings (USA) → GlobalCorp (UK)

---

支持

• 问题反馈：https://github.com/QoreNext-IT/QoreNextMCP/issues
• 电子邮件：[email protected]
• 文档：https://qorenext.com

---

许可证

MIT