QoreNext CRM MCP

Qorenext CRM MCP

MCP を介した企業階層分析と住所確認

Qorenext CRM MCP は、Model Context Protocol サーバーです。Claude やその他の AI クライアントを使って、チャット上で直接、企業階層の分析と住所確認を行えます。

---

前提条件：

• Node.js と npm がインストールされていること（npm はコネクターパッケージのインストールに使用します）。
• QoreNext CRM の API キー。
• Qore MCP を使用するには、有効な製品サブスクリプションが必要です。
• ユーザープロファイル内のファイルを編集するための管理者権限、または標準アクセス権があること。

API キーを取得する

https://qorenext-app.azurewebsites.net/signup でサインアップして、QORENEXT_API_KEY を取得してください。

API キーの取得手順

1. https://qorenext-app.azurewebsites.net/signup でサインアップします。
2. CRM On-Demand Data Quality & Enrichment 製品を選択します。
3. プランを購入します。Qore MCP を使用するには、有効な製品サブスクリプションが必要です。
4. プロフィール → API を開きます。
5. ［Generate API Key］をクリックします。
6. API キーに名前を付けて、［Create］をクリックします。
7. Claude で使用する API キーをコピーします。

---

接続方法：

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

前提条件：

• Claude Desktop が Windows にインストールされていること。
• Node.js と npm がインストールされていること（npm はコネクターパッケージのインストールに使用します）。
• QoreNext CRM の 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-crm": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.qorenext.com/crm",
        "--header",
        "X-API-Key:qore_xxxxx"
      ]
    }
  }
}

JSON の構文に注意してください JSON の括弧とカンマが正確に一致していることを確認してください。カンマが 1 つ欠けているだけでも、ファイルが正しく動作しなくなります。

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 ウィンドウの上部にある New Chat アイコンの上に、モードのドロップダウンメニューがあります。
3. モードを Codex に変更します。

手順 2：設定を開く

1. ChatGPT ウィンドウの左下隅にあるプロフィールアイコンをクリックします。
2. 設定を選択します。

手順 3：プラグインを開く

次の場所に移動します：

Integrations → Plugins

手順 4：MCP サーバーを追加する

1. プラグインウィンドウで、Add ドロップダウンをクリックします。
2. Add MCP Server を選択します。

手順 5：QoreNext MCP サーバーを設定する

名前

QoreNext MCP Server

起動コマンド

npx

引数

以下の引数を1つずつ追加します。

-y
mcp-remote
https://mcp.qorenext.com/crm
--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-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 - ZIP コード／郵便番号
• 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 重複排除の送信

You：重複排除ファイル CRM_Dedupe_TestSet.csv を送信

Claude：[submit_duplicates を呼び出す] ✅ 送信に成功しました

     ファイル：CRM_Dedupe_TestSet.csv
     リクエスト ID：203
     送信されたレコード数：500

You：リクエスト 203 のステータスを取得

Claude：[get_request_status を呼び出す]

     ステータス：COMPLETE
     受け付けられたレコード数：✅ 500
     拒否されたレコード数：0

出力ファイル

CRM データの処理後、ツールは2つの出力ファイルを生成します。

1. 詳細な照合結果ファイル

このファイルには、入力ファイルで送信されたすべての CRM レコードの結果が含まれています。

会社名と住所に基づいて、各レコードが別のレコードと照合されたかどうかを示します。

列	意味
Group No	同じ重複候補グループに属するレコードに割り当てられた番号です。
Parent ID	そのグループのメインまたは選択済みの CRM レコード ID です。
Matched CRM ID	照合対象の CRM レコード ID です。
CRM Account Name	CRM に登録されている会社名です。
Address	CRM アカウントの住所です。
Verdict	照合結果です：Strong Match、Partial Match、または No Match。
Score	会社名と住所の類似度スコアです。スコアが高いほど、より一致しています。

判定の意味

• Strong Match - レコードが重複している可能性が非常に高いです。
• Partial Match - レコードは類似しており、確認が必要な場合があります。
• No Match - そのレコードに重複は見つかりませんでした。

例

Group No	Parent ID	Matched CRM ID	CRM Account Name	Address	Verdict	Score
1	CRM3001B	CRM3001B	MetroVale Tech Partners Ltd.	143 E Indl Pkwy	No Match	0
2	CRM3002B	CRM3002B	Northstar Logic Information Sys. Limited	180 Mt Pleasant Rd	No Match	0
3	CRM3002A	CRM3002A	Northstar Logic Information Systems Limited	180 Mt Pleasant Rd	Strong Match	95
3	CRM3002A	CRM3002B	Northstar Logic Information Sys. Limited	180 Mt Pleasant Rd	Strong Match	95

---

2. 一意レコードファイル

このファイルには、保持するレコードの整理済みリストが含まれています。

重複グループごとに、選択された CRM レコードを1 件のみ含みます。グループ内に強い一致または部分一致の重複がある場合、そのグループの残りのレコードはこのファイルには重複して記載されません。

No Match 判定のレコードもすべて含まれています。これらはすでに一意だからです。

たとえば、あるグループに部分一致が 2 件、強い一致が 1 件含まれている場合、このファイルにはそのグループから選択されたレコードが 1 件だけ表示されます。

列	意味
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

---

概要

• すべての照合判定を確認するには、詳細な照合結果ファイルを使用してください。
• 重複グループごとに 1 件のレコードと、ほかのレコードと一致しなかったすべてのレコードが必要な場合は、一意レコードファイルを使用してください。

サポート

• 問題報告：https://github.com/QoreNext/qorenext-crm-mcp/issues
• メール：[email protected]
• ドキュメント：https://qorenext.com

---

ライセンス

MIT