QoreNext CRM MCP

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

Documentación

QorenextMCP

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

QorenextMCP es un servidor de 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.


Obtén tu clave de API

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


Conectar

Claude Code

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

Claude Desktop

Edita %APPDATA%\Claude\claude_desktop_config.json (Windows) o ~/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

Añade a .cursor/mcp.json o .windsurf/mcp.json:

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

Herramientas

HerramientaAutenticaciónDescripción
health_check❌ PúblicaVerifica que el servidor esté en ejecución, obtén información de versión
submit_address_verification✅ Clave APIEnvía empresas para verificación y validación de direcciones
submit_hierarchy_creation✅ Clave APIEnvía empresas para análisis de jerarquía organizacional
submit_duplicates✅ Clave APIEnvía entidades duplicadas desde archivos JSON, CSV o Excel
get_request_status✅ Clave APIConsulta el estado y recupera resultados de cualquier solicitud de revisión

health_check

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

check if QorenextMCP 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 organizacional con el fin de 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, CSV o Excel) para detección de deduplicación.

Requerido: file_content, file_type

Opcional: file_name

Tipos de archivo admitidos:

  • json - Formato de arreglo JSON
  • csv - Valores separados por comas con encabezados
  • excel o xlsx - Libros de trabajo de Microsoft Excel

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

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

Campos opcionales:

  • addressLine2 - Suite, apt, 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 trabajo 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 revisión para obtener estado y resultados.

Parámetro: request_id (int)

Valores de estado: PENDING · PROCESSING · COMPLETE · FAILED

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

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

Soporte


Licencia

MIT