qorenext-mcp

QorenextMCP

MCP 経由で企業階層を分析し、住所を検証します

QorenextMCP は、Claude やその他の AI クライアントがチャット内で企業階層の分析と住所の検証を直接実行できる Model Context Protocol サーバーです。

---

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 ブック：

• 1 行目：列ヘッダー
• データ行：アカウントレコード
• 必須列：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