QoreNext MCP CRM

Inteligencia CRM en tiempo real para Claude y otros clientes de IA: mapea jerarquías de propiedad corporativa, verifica nombres de entidades y direcciones registradas, y detecta registros duplicados, directamente en el chat. Sin búsquedas manuales, sin hojas de cálculo, sin datos desordenados.

GitHub

Documentación

Qorenext CRM MCP

Análisis de jerarquía empresarial y verificación de direcciones — vía MCP

Qorenext CRM MCP es un servidor Model Context Protocol que permite a Claude y otros clientes de IA realizar análisis de jerarquía empresarial y verificación de direcciones directamente en el chat.

Requisitos previos:

• Node.js y npm instalados (npm se utiliza para instalar el paquete del conector).
• Una clave de API de QoreNext CRM.
• Se requiere una suscripción de producto activa para usar Qore MCP.
• Acceso de administrador o estándar para editar archivos en tu perfil de usuario.

Obtén tu clave de API

Regístrate en https://qorenext-app.azurewebsites.net/signup para obtener tu QORENEXT_API_KEY.

Pasos para obtener tu clave de API

Regístrate en https://qorenext-app.azurewebsites.net/signup.
Selecciona el producto CRM On-Demand Data Quality & Enrichment.
Compra tu plan: se requiere una suscripción de producto activa para usar Qore MCP.
Abre Perfil → APIs.
Haz clic en Generar clave de API.
Asigna un nombre a tu clave de API y haz clic en Crear.
Copia la clave de API para usarla en Claude.

Cómo conectarse:

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

Requisitos previos:

• Claude Desktop instalado en Windows.
• Node.js y npm instalados (npm se utiliza para instalar el paquete del conector).
• Una clave de API de QoreNext CRM.
• Se requiere una suscripción de producto activa para usar Qore MCP.
• Acceso de administrador o estándar para editar archivos en tu perfil de usuario.

Instalar Node.js

Descarga e instala la versión LTS desde nodejs.org.
La instalación incluye npm y npx.
Abre Terminal (Mac) o Símbolo del sistema/PowerShell (Windows).
Verifica la instalación: `bash con los siguientes comandos
node -v
npx -v

Ambos comandos deben mostrar un número de versión.
Si ves "command not found", reinicia tu terminal e inténtalo de nuevo.

## Pasos para configurar Claude Desktop

1. Abre Claude Desktop

Inicia la aplicación Claude Desktop en tu computadora.

2. Abre Configuración

Ve a: Menú → Archivo → Configuración

3. Abre Configuración de desarrollador

En la ventana de Configuración, selecciona Developer en el menú lateral izquierdo.

4. Abre el archivo de configuración

Haz clic en Editar configuración para abrir el archivo claude_desktop_config.json.
Elimina el comando existente en el archivo y pega la configuración proporcionada a continuación en JSON.

Ubicación predeterminada en Windows:
C:\Users\AppData\Roaming\Claude\claude_desktop_config.json o ~/Library/Application Support/Claude/claude_desktop_config.json (Mac)

5. Agrega el servidor MCP de QoreNext

Agrega la siguiente configuración a claude_desktop_config.json y reemplaza qore_xxxxx con tu clave de API real.

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

Cuida tu sintaxis JSON Asegúrate de que las llaves y comas del JSON coincidan exactamente: una coma faltante romperá el archivo.

6. Guarda el archivo

Guarda tus cambios (Ctrl+S) y cierra el editor.

7. Reinicia Claude Desktop

Cierra completamente Claude Desktop cerrándolo, saliendo desde la bandeja del sistema/barra de tareas y usando el Administrador de tareas para finalizar cualquier proceso restante de Claude que se ejecute en segundo plano; luego vuelve a abrir Claude Desktop.

C) ChatGPT Desktop

Esta guía explica cómo configurar el servidor MCP de QoreNext en la aplicación ChatGPT Desktop.

Requisitos previos

ChatGPT Desktop instalado en tu computadora.
Una clave de API de QoreNext válida.
Conectividad a Internet.

Paso 1: Abre ChatGPT Desktop

Inicia la aplicación ChatGPT Desktop.
En la parte superior de la ventana de ChatGPT, localiza el menú desplegable de modo sobre el ícono Nuevo chat.
Cambia el modo a Codex.

Paso 2: Abre Configuración

Haz clic en tu ícono de perfil en la esquina inferior izquierda de la ventana de ChatGPT.
Selecciona Configuración.

Paso 3: Abre Plugins

Navega a:

Integrations → Plugins

Paso 4: Agrega un servidor MCP

En la ventana de Plugins, haz clic en el menú desplegable Agregar.
Selecciona Agregar servidor MCP.

Paso 5: Configura el servidor MCP de QoreNext

Nombre

QoreNext MCP Server

Comando para iniciar

npx

Argumentos

Agrega los siguientes argumentos uno por uno:

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

**Reemplaza YOUR_API_KEY con tu clave de API real de QoreNext.

Paso 6: Guarda el servidor MCP

Verifica todos los campos y argumentos.
Haz clic en Guardar.
Cierra la ventana de configuración.

Paso 7: Reinicia ChatGPT Desktop

Cierra ChatGPT Desktop por completo.
Abre el Administrador de tareas y finaliza cualquier proceso restante de ChatGPT.
Vuelve a abrir ChatGPT Desktop.
Después de que se abra ChatGPT Desktop, cambia el modo de Codex a ChatGPT.

D) Cursor / Windsurf

Agrega a .cursor/mcp.json o .windsurf/mcp.json:

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

Herramientas

Herramienta	Autenticación	Descripción
`health_check`	❌ Pública	Verifica que el servidor esté en ejecución, obtén información de versión
`submit_address_verification`	✅ Clave de API	Envía empresas para verificación y validación de direcciones
`submit_hierarchy_creation`	✅ Clave de API	Envía empresas para análisis de jerarquía corporativa, incluidas relaciones de matriz principal y subsidiarias
`submit_duplicates`	✅ Clave de API	Envía registros de cuentas CRM desde archivos JSON, CSV o Excel para detección de duplicados
`get_request_status`	✅ Clave de API	Consulta el estado y obtén resultados para solicitudes de verificación de direcciones, análisis de jerarquía o detección de duplicados

`health_check`

Verifica que el servidor esté en ejecución. No se requiere clave de API.

check if Qorenext CRM MCP is running

`submit_address_verification`

Envía empresas para verificación de direcciones y validación de legitimidad.

Requerido por entidad: companyName, country, address

Opcional: 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`

Envía empresas para análisis de jerarquía corporativa, incluidas relaciones de matriz principal y subsidiarias para identificar relaciones matriz-subsidiaria.

Requerido por entidad: companyName, country

Opcional: 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`

Envía registros de cuentas duplicadas desde archivos (JSON o CSV) para detección de deduplicación.

Requerido: file_content, file_type

Opcional: file_name

Tipos de archivo compatibles:

json - Formato de arreglo JSON
csv - Valores separados por comas con encabezados

Campos requeridos (por registro en archivos CSV y Excel):

crmAccountId - Identificador de cuenta
crmAccountName - Nombre de cuenta/empresa
addressLine1 - Dirección
country - Nombre del país

Campos opcionales:

addressLine2 - Suite, depto, unidad, etc.
city - Nombre de la ciudad
stateProvince - Estado o provincia
postalCode - Código postal
website - URL del sitio web

Requisitos de formato de archivo:

Arreglo 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 con encabezados:

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

Libro de Excel:

Primera fila: Encabezados de columna
Filas de datos: Registros de cuentas
Columnas requeridas: crmAccountId, crmAccountName, addressLine1, country
Columnas opcionales: addressLine2, city, stateProvince, postalCode, website

Ejemplos:

submit deduplication for CSV file with 50 company records
detect duplicates from Excel file of CRM accounts
process JSON file to find similar companies

Devuelve:

data: Número de pares duplicados detectados
message: Descripción de los resultados
details: Conteo de registros y conteo de pares duplicados

Ejemplo de respuesta (Estado 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`

Consulta una solicitud de procesamiento CRM para obtener estado y resultados.

Parámetro: request_id (int)

Valores de estado: PENDING · PROCESSING · COMPLETE · FAILED

get status of request 1001
check if CRM request 5042 is complete

Flujo de trabajo de ejemplo

Verificación de direcciones:

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

Creación de jerarquía:

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

Envío de deduplicación CRM

Tú: Envía el archivo de deduplicación CRM_Dedupe_TestSet.csv

Claude: [llama a submit_duplicates] ✅ Enviado exitosamente

     Archivo: CRM_Dedupe_TestSet.csv
     ID de solicitud: 203
     Registros enviados: 500

Tú: Obtén el estado de la solicitud 203

Claude: [llama a get_request_status]

     Estado: COMPLETE
     Registros aceptados: ✅ 500
     Registros rechazados: 0

Archivos de salida

Después de procesar los datos CRM, la herramienta genera dos archivos de salida.

1. Archivo de resultados detallados de coincidencias

Este archivo contiene el resultado de cada registro CRM enviado en el archivo de entrada.

Muestra si cada registro coincidió con otro registro según el nombre de la empresa y la dirección.

Columna	Significado
Grupo N.º	Número asignado a los registros que pertenecen al mismo posible grupo de duplicados.
ID principal	El ID de registro CRM principal o seleccionado para ese grupo.
ID CRM coincidente	El ID de registro CRM que se está verificando.
Nombre de cuenta CRM	Nombre de la empresa desde el CRM.
Dirección	Dirección de la cuenta CRM.
Veredicto	Resultado de coincidencia: Coincidencia fuerte, Coincidencia parcial o Sin coincidencia.
Puntuación	Puntuación de similitud entre el nombre de la empresa y la dirección. Las puntuaciones más altas indican una coincidencia más cercana.

Significados de los veredictos

Coincidencia fuerte - Es muy probable que los registros sean duplicados.
Coincidencia parcial - Los registros son similares y pueden requerir revisión.
Sin coincidencia - No se encontró ninguna coincidencia duplicada para ese registro.

Ejemplo

Grupo N.º	ID principal	ID CRM coincidente	Nombre de cuenta CRM	Dirección	Veredicto	Puntuación
1	CRM3001B	CRM3001B	MetroVale Tech Partners Ltd.	143 E Indl Pkwy	Sin coincidencia	0
2	CRM3002B	CRM3002B	Northstar Logic Information Sys. Limited	180 Mt Pleasant Rd	Sin coincidencia	0
3	CRM3002A	CRM3002A	Northstar Logic Information Systems Limited	180 Mt Pleasant Rd	Coincidencia fuerte	95
3	CRM3002A	CRM3002B	Northstar Logic Information Sys. Limited	180 Mt Pleasant Rd	Coincidencia fuerte	95

2. Archivo de registros únicos

Este archivo proporciona una lista depurada de registros para conservar.

Para cada grupo de duplicados, incluye solo un registro CRM seleccionado. Si un grupo tiene coincidencias duplicadas fuertes o parciales, los registros restantes de ese grupo no se repiten en este archivo.

Todos los registros con veredicto Sin coincidencia también se incluyen porque ya son únicos.

Por ejemplo, si un grupo contiene dos coincidencias parciales y una coincidencia fuerte, este archivo mostrará solo un registro seleccionado de ese grupo.

Columna	Significado
Grupo N.º	El número de grupo asignado durante la coincidencia.
ID CRM coincidente	El ID de registro CRM único seleccionado.
Nombre de cuenta CRM	Nombre de la empresa del registro seleccionado.
Dirección	Dirección del registro seleccionado.

Ejemplo

Grupo N.º	ID CRM coincidente	Nombre de cuenta CRM	Dirección
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

Resumen

Usa el Archivo de resultados detallados de coincidencias para revisar todas las decisiones de coincidencia.
Usa el Archivo de registros únicos cuando necesites un registro por grupo de duplicados, junto con todos los registros que no coincidieron con ningún otro registro.

Soporte

Problemas: https://github.com/QoreNext/qorenext-crm-mcp/issues
Correo electrónico: support@qorenext.com
Documentación: https://qorenext.com

Licencia

MIT