QoreNext Trade Screening MCP

Qorenext Trade 筛查 MCP

通过 MCP 进行制裁和贸易筛查尽职调查

Qorenext Trade screening MCP 是一款模型上下文协议服务，可让 Claude 和其他 AI 客户端直接在聊天中执行制裁筛查和贸易筛查尽职调查。

---

先决条件：

• 已安装 Node.js 和 npm（npm 用于安装连接器包）。
• 拥有 QoreNext Trade Screening API 密钥。
• 使用 Qore MCP 需要有效的产品订阅。
• 拥有管理员权限或标准权限，以编辑用户个人资料中的文件。

获取 API 密钥

在 https://qorenext-app.azurewebsites.net/signup 注册以获取 QORENEXT_API_KEY。

获取 API 密钥的步骤

1. 在 https://qorenext-app.azurewebsites.net/signup 注册。
2. 选择 Trade Screening。
3. 购买订阅方案。
4. 打开 Profile → APIs。
5. 点击 Generate API Key。
6. 为 API 密钥命名，然后点击 Create。
7. 复制 API 密钥，以便在 Claude 中使用。

---

连接方式：

A) Claude Code

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

B) Claude Desktop

先决条件：

• 已在 Windows 上安装 Claude Desktop。
• 已安装 Node.js 和 npm（npm 用于安装连接器包）。
• 拥有 QoreNext Trade Screening API 密钥。
• 使用 Qore MCP 需要有效的产品订阅。
• 拥有管理员权限或标准权限，以编辑用户个人资料中的文件。

安装 Node.js

• 从 nodejs.org 下载并安装 LTS 版本。
• 安装程序会一并安装 npm 和 npx。
• 打开 终端（Mac）或 命令提示符/PowerShell（Windows）。
• 验证安装：`bash below commands
  node -v
  npx -v

两个命令都应显示版本号。
如果看到“command not found”，请重启终端后重试。

## Claude Desktop 设置步骤

1. 打开 Claude Desktop

在电脑上启动 Claude Desktop 应用。

2. 打开设置

前往： 菜单 → 文件 → 设置

3. 打开开发者设置

在设置窗口中，从左侧菜单选择 开发者。

4. 打开配置文件

点击 编辑配置，打开 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 密钥。

{
  "mcpServers": {
    "qorenext-mcp-ts": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.qorenext.com/tradescreening",
        "--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 密钥。
• 可连接互联网。

步骤 1：打开 ChatGPT Desktop

1. 启动 ChatGPT Desktop 应用。
2. 在 ChatGPT 窗口顶部，找到 新建聊天 图标上方的模式下拉菜单。
3. 将模式切换为 Codex。

步骤 2：打开设置

1. 点击 ChatGPT 窗口左下角的个人资料图标。
2. 选择 设置。

步骤 3：打开插件

前往：

Integrations → Plugins

步骤 4：添加 MCP 服务

1. 在插件窗口中，点击 添加 下拉菜单。
2. 选择 添加 MCP 服务。

步骤 5：配置 QoreNext MCP 服务

名称

QoreNext MCP Server

启动命令

npx

参数

依次添加以下参数：

-y
mcp-remote
https://mcp.qorenext.com/tradescreening
--header
X-API-Key: YOUR_API_KEY

**将 YOUR_API_KEY 替换为你的实际 QoreNext API 密钥。

步骤 6：保存 MCP 服务

1. 检查所有字段和参数。
2. 点击 保存。
3. 关闭配置窗口。

步骤 7：重启 ChatGPT Desktop

1. 完全关闭 ChatGPT Desktop。
2. 打开任务管理器，并结束所有剩余的 ChatGPT 进程。
3. 重新打开 ChatGPT Desktop。
4. ChatGPT Desktop 打开后，将模式从 Codex 切换为 ChatGPT

D) Cursor / Windsurf

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

{
  "mcpServers": {
    "qorenext-mcp-ts": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.qorenext.com/tradescreening",
        "--header",
        "X-API-Key:qore_xxxxx"
      ]
    }
  }
}

---

工具

工具	身份验证	描述
health_check	❌ 公开	验证服务是否正在运行，并获取版本信息
submit_sanctions_screening	✅ API 密钥	根据美国制裁名单提交实体进行制裁筛查
submit_trade_screening	✅ API 密钥	提交公司进行贸易筛查尽职调查
get_trade_screening_status	✅ API 密钥	查询状态并获取完整的尽职调查报告

---

health_check

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

check if Qorenext Trade Screening MCP is running

---

submit_sanctions_screening

根据美国制裁名单（OFAC、MEU、EntityList 等）提交实体进行制裁筛查。

每个实体的必填项： entityEnglishName 或 entityNativeName（至少提供一个）

可选项： country、address

Screen Acme trading LLC أكمي للتجار at 123 Azadi Street, Tehran for sanctions 

返回： 每个提交的实体对应一个结果，其中包含 matchFound、bestMatchScore 和 matches。

示例响应（状态码 200）：

{
  "success": true,
  "status_code": 200,
  "data": [
    {
      "entityEnglishName": "Acme Trading LLC",
      "entityNativeName": "أكمي للتجارة",
      "country": "Iran",
      "address": "123 Azadi Street, Tehran",
      "matchFound": false,
      "bestMatchScore": 0,
      "matches": []
    }
  ],
  "message": ""
}

---

submit_trade_screening

提交公司进行贸易筛查尽职调查：检查被拒绝/受限方名单、分析风险标记关键词、评估风险并查找负面新闻。

必填项： address、website，以及 companyEnglishName 或 companyNativeName（至少提供一个）

可选项： parentEntityEnglishName、parentEntityWebsite

Qore 的 /trade-screening/add-company 端点在内部还要求提供若干额外字段（Labs、LabsWebsite、Department、DepartmentWebsite、Professors、Product、EndUse、ParentEntity、referenceNumber），但此工具不会要求填写这些字段——工具会自动将它们作为空字符串发送，调用方无需提供。

示例输入：

{
  "companyEnglishName": "Changchun New Industries Optoelectronics Tech. Co., Ltd.",
  "companyNativeName": "长春新产业光电技术有限公司",
  "address": "No.888 Jinhu Road High-tech Zone, Changchun 130103, P.R.China",
  "website": "https://test.com",
  "parentEntityEnglishName": "",
  "parentEntityWebsite": ""
}

如果提供了 companyEnglishName，则可省略 companyNativeName，反之亦然。parentEntityEnglishName/parentEntityWebsite 为可选项。

run trade screening on Acme Corp at 1 Main St, https://acme.com
due-diligence check for Changchun New Industries Optoelectronics, https://cnilaser.com

返回：

• data：跟踪 ID（NativeId），用于调用 get_trade_screening_status
• message：描述或错误消息

示例响应（状态码 200）：

{
  "success": true,
  "status_code": 200,
  "data": 424,
  "message": ""
}

已知问题（Qore 后端，并非此服务）： 当前新提交的请求会间歇性失败，并返回 "Object reference not set to an instance of an object."（status_code: 422）——这是 Qore 请求处理流程中的服务端空引用异常，而非客户端验证问题。重复提交已知公司不受影响。截至 2026-08-19，已通过直接测试实时 API 确认此问题；目前正等待 Qore API 团队修复。

---

get_trade_screening_status

查询贸易筛查请求的状态和完整尽职调查报告。

参数： request_id（int）——submit_trade_screening 返回的 NativeId

状态值： Pending · Processing · Completed · Failed

get status of trade screening request 424
check if screening 322 is complete

只有当 status 为 Completed 时，才会显示 output（风险评估、风险标记结果、受限方匹配结果和建议）。

---

示例工作流

制裁筛查：

You:    Screen Acme Trading LLC in Iran for sanctions.

Claude: [calls submit_sanctions_screening]
        ✅ Screened. No match found (score: 0)

For retrieving reports in a standard format, use the prompts given below.

Get the sanctions screening results for in this format. output only a table with these exact columns, in this order: 
| Entity Name | Country | Address | Match Found | Match Score | Matched Entity Name | Matched Country | Matched Address | Agency | Category | Rules: - Use only data returned by the tool. Copy values verbatim. Do not infer, add, or reword. - One row per match. If an entity has several matches, repeat its name, country and address on each row. - If an entity has no match, output one row with Match Found = "No" and "-" in all remaining columns. - Match Found = "Yes" or "No". Match Score exactly as returned. - Use "-" for any other missing value. - No text before or after the table. No summary or commentary.
 

贸易筛查：

You:    Run trade screening on Changchun New Industries Optoelectronics Tech. Co., Ltd, No.888 Jinhu Road High-tech Zone,Changchun 130103, P.R.China, https://www.cnilaser.com/C-profile.htm

Claude: [calls submit_trade_screening]
        ✅ Submitted. Tracking ID: 424

You:    Get status of trade screening request 424

Claude: [calls get_trade_screening_status]
        Status: Completed
        Risk Level: Medium
        Recommendation: Proceed with standard due diligence.

To download the full report in Word format, paste the following prompt into your MCP client (e.g., Claude Desktop) with your actual tracking ID.

Export and download the due diligence report for trade screening request {{tracking_id}} in Word format.
Provide the exact report from system generated output, do not add any extra information yourself.
 
Company Name (In Native):
Company Name (In English):
Company Address:
Homepage:
Country:
Company Overview: (default: No exact match found. Source: None)
Parent Entity (in Native): (default: No information found)
Parent Entity (In English): (default: No information found) 
Alias: (default: No information found)
Industry Type: (default: No information available. Sources: None)
Key Products:
Risk Level:
Red flag Keywords hits:
Risk Assessment: (full text incl. **Potential MEU Risk**, **Potential SEMI Risk**, **Potential DPL Risk**)
Verdict (Level 1 Reviewer/Level 2 Reviewer):
Positive Findings: (default: No information found)
Negative Findings: (default: No information found)
URL {{n}} : {{summary}}
Article Excerpt:
{{excerpt}}
This incident is also referenced in {{x}} other related articles: URL {{n}} (only if returned)
(repeat for every finding, in order)
Restricted Party List: (default: No hits found)
Artifacts URL:
1. URL {{n}}: {{link}}
(list all)
Recommendation:
Disclaimer
This report is based on publicly available information and is intended to provide a basis for assessment of trade worthiness of the company in question.

最终报告

风险评估摘要

长春新产业光电科技有限公司（CNI）

• **国家：**中国
• **行业：**光电子与激光系统制造
• **风险等级：**高

公司概况

长春新产业光电科技有限公司是一家中国制造商，生产激光器、激光系统、光谱分析仪和光学设备。该公司由中国科学院长春光学精密机械与物理研究所创立，产品销往全球。

负面发现

• 产品用于国防装备、航天、航空及卫星相关应用。
• 生产用于半导体相关应用的激光产品，包括半导体切割。
• 由中国科学院长春光学精密机械与物理研究所创立，该研究所列于受限方名单。
• 获得北京航空航天大学（BUAA）的采购项目，该校列于受限方名单。
• 参与了一项高功率半导体激光项目，项目涉及华为技术有限公司、清华大学、吉林大学和四川大学；报告将这些机构列为受限实体或高风险实体。

建议

高风险。请谨慎推进，并在合作前开展强化尽职调查。应特别关注该公司的国防、航天、卫星及半导体相关活动，以及其与受限实体或高风险实体的关联。

---

## Support

- Issues: https://github.com/QoreNext/qorenext-tradescreening-mcp/issues
- Email: [email protected]
- Docs: https://qorenext.com

---

## License

MIT