QoreNext MCP CRM

Inteligência de CRM em tempo real para Claude e outros clientes de IA — mapeie hierarquias de propriedade corporativa, verifique nomes de entidades e endereços registrados e detecte registros duplicados, diretamente no chat. Sem consultas manuais, sem planilhas, sem dados bagunçados.

GitHub

Documentação

Qorenext CRM MCP

Análise de hierarquia corporativa e verificação de endereços — via MCP

O Qorenext CRM MCP é um servidor Model Context Protocol que permite que o Claude e outros clientes de IA realizem análise de hierarquia corporativa e verificação de endereços diretamente no chat.

Pré-requisitos:

• Node.js e npm instalados (o npm é usado para instalar o pacote do conector).
• Uma chave de API do QoreNext CRM.
• Uma assinatura de produto ativa é necessária para usar o Qore MCP.
• Acesso de administrador ou padrão para editar arquivos no seu perfil de usuário.

Obtenha sua chave de API

Cadastre-se em https://qorenext-app.azurewebsites.net/signup para obter sua QORENEXT_API_KEY.

Etapas para obter sua chave de API

Cadastre-se em https://qorenext-app.azurewebsites.net/signup.
Selecione o produto CRM On-Demand Data Quality & Enrichment.
Compre seu plano - Uma assinatura de produto ativa é necessária para usar o Qore MCP.
Abra Perfil → APIs.
Clique em Gerar Chave de API.
Dê um nome à sua chave de API e clique em Criar.
Copie a chave de API para usar no Claude.

Como Conectar:

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

Pré-requisitos:

• Claude Desktop instalado no Windows.
• Node.js e npm instalados (o npm é usado para instalar o pacote do conector).
• Uma chave de API do QoreNext CRM.
• Uma assinatura de produto ativa é necessária para usar o Qore MCP.
• Acesso de administrador ou padrão para editar arquivos no seu perfil de usuário.

Instalar Node.js

Baixe e instale a versão LTS em nodejs.org.
A instalação inclui npm e npx.
Abra o Terminal (Mac) ou Prompt de Comando/PowerShell (Windows).
Verifique a instalação: `bash abaixo comandos
node -v
npx -v

Ambos os comandos devem exibir um número de versão.
Se você vir "command not found", reinicie o terminal e tente novamente.

## Etapas para Configurar o Claude Desktop

1. Abra o Claude Desktop

Inicie o aplicativo Claude Desktop no seu computador.

2. Abra as Configurações

Vá para: Menu → Arquivo → Configurações

3. Abra as Configurações do Desenvolvedor

Na janela de Configurações, selecione Desenvolvedor no menu lateral esquerdo.

4. Abra o Arquivo de Configuração

Clique em Editar Configuração para abrir o arquivo claude_desktop_config.json.
Remova o comando existente no arquivo e cole a configuração fornecida abaixo em JSON.

Localização padrão no Windows:
C:\Users\AppData\Roaming\Claude\claude_desktop_config.json ou ~/Library/Application Support/Claude/claude_desktop_config.json (Mac)

5. Adicione o Servidor MCP QoreNext

Adicione a seguinte configuração ao claude_desktop_config.json e substitua qore_xxxxx pela sua chave de API real.

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

Cuidado com a sintaxe do JSON Certifique-se de que as chaves e vírgulas do JSON correspondam exatamente — uma vírgula ausente quebrará o arquivo.

6. Salve o arquivo

Salve suas alterações (Ctrl+S) e feche o editor.

7. Reinicie o Claude Desktop

Feche completamente o Claude Desktop fechando-o, saindo pela bandeja do sistema/barra de tarefas e usando o Gerenciador de Tarefas para Encerrar Tarefa de quaisquer processos restantes do Claude em execução em segundo plano; depois reabra o Claude Desktop.

C) ChatGPT Desktop

Este guia explica como configurar o Servidor MCP QoreNext no aplicativo ChatGPT Desktop.

Pré-requisitos

ChatGPT Desktop instalado no seu computador.
Uma chave de API QoreNext válida.
Conectividade com a internet.

Etapa 1: Abra o ChatGPT Desktop

Inicie o aplicativo ChatGPT Desktop.
Na parte superior da janela do ChatGPT, localize o menu suspenso de modo acima do ícone Nova Conversa.
Altere o modo para Codex.

Etapa 2: Abra as Configurações

Clique no ícone do seu perfil no canto inferior esquerdo da janela do ChatGPT.
Selecione Configurações.

Etapa 3: Abra os Plugins

Navegue até:

Integrations → Plugins

Etapa 4: Adicione um Servidor MCP

Na janela de Plugins, clique no menu suspenso Adicionar.
Selecione Adicionar Servidor MCP.

Etapa 5: Configure o Servidor MCP QoreNext

Nome

QoreNext MCP Server

Comando para Iniciar

npx

Argumentos

Adicione os seguintes argumentos um por um:

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

**Substitua YOUR_API_KEY pela sua chave de API QoreNext real.

Etapa 6: Salve o Servidor MCP

Verifique todos os campos e argumentos.
Clique em Salvar.
Feche a janela de configuração.

Etapa 7: Reinicie o ChatGPT Desktop

Feche completamente o ChatGPT Desktop.
Abra o Gerenciador de Tarefas e encerre quaisquer processos restantes do ChatGPT.
Reabra o ChatGPT Desktop.
Após o ChatGPT Desktop abrir, alterne o modo de Codex para ChatGPT

D) Cursor / Windsurf

Adicione ao .cursor/mcp.json ou .windsurf/mcp.json:

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

Ferramentas

Ferramenta	Autenticação	Descrição
`health_check`	❌ Pública	Verificar se o servidor está em execução, obter informações de versão
`submit_address_verification`	✅ Chave de API	Enviar empresas para verificação e validação de endereços
`submit_hierarchy_creation`	✅ Chave de API	Enviar empresas para análise de hierarquia corporativa, incluindo relações de empresa-mãe e subsidiárias
`submit_duplicates`	✅ Chave de API	Enviar registros de contas CRM de arquivos JSON, CSV ou Excel para detecção de duplicatas
`get_request_status`	✅ Chave de API	Consultar o status e recuperar resultados para verificação de endereços, análise de hierarquia ou solicitações de detecção de duplicatas

`health_check`

Verifique se o servidor está em execução. Nenhuma chave de API é necessária.

check if Qorenext CRM MCP is running

`submit_address_verification`

Envie empresas para verificação de endereços e validação de legitimidade.

Obrigatório por entidade: 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`

Envie empresas para análise de hierarquia corporativa, incluindo relações de empresa-mãe e subsidiárias para identificar relações entre matriz e subsidiária.

Obrigatório por entidade: 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`

Envie registros de contas duplicadas de arquivos (JSON ou CSV) para detecção de deduplicação.

Obrigatório: file_content, file_type

Opcional: file_name

Tipos de Arquivo Suportados:

json - Formato de array JSON
csv - Valores separados por vírgula com cabeçalhos

Campos Obrigatórios (por registro em arquivos CSV e Excel):

crmAccountId - Identificador da conta
crmAccountName - Nome da conta/empresa
addressLine1 - Endereço (rua)
country - Nome do país

Campos Opcionais:

addressLine2 - Suite, apt, unidade, etc.
city - Nome da cidade
stateProvince - Estado ou Província
postalCode - CEP/Código postal
website - URL do site

Requisitos de Formato de Arquivo:

Array 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 com Cabeçalhos:

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

Pasta de Trabalho Excel:

Primeira linha: Cabeçalhos das colunas
Linhas de dados: Registros de contas
Colunas obrigatórias: crmAccountId, crmAccountName, addressLine1, country
Colunas opcionais: addressLine2, city, stateProvince, postalCode, website

Exemplos:

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

Retorna:

data: Número de pares de duplicatas detectados
message: Descrição dos resultados
details: Contagem de registros e contagem de pares de duplicatas

Exemplo de Resposta (Status 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`

Consulte uma solicitação de processamento CRM para obter status e resultados.

Parâmetro: request_id (int)

Valores de status: PENDING · PROCESSING · COMPLETE · FAILED

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

Exemplo de fluxo de trabalho

Verificação de Endereços:

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

Criação de Hierarquia:

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

Envio de Deduplicação CRM

Você: Enviar arquivo de deduplicação CRM_Dedupe_TestSet.csv

Claude: [chama submit_duplicates] ✅ Enviado com Sucesso

     Arquivo: CRM_Dedupe_TestSet.csv
     ID da Solicitação: 203
     Registros Enviados: 500

Você: Obter status da solicitação 203

Claude: [chama get_request_status]

     Status: COMPLETE
     Registros Aceitos: ✅ 500
     Registros Rejeitados: 0

Arquivos de Saída

Após o processamento dos dados CRM, a ferramenta gera dois arquivos de saída.

1. Arquivo de Resultados de Correspondência Detalhados

Este arquivo contém o resultado para cada registro CRM enviado no arquivo de entrada.

Ele mostra se cada registro foi correspondido com outro registro com base no nome da empresa e endereço.

Coluna	Significado
Nº do Grupo	Número atribuído a registros que pertencem ao mesmo possível grupo de duplicatas.
ID da Matriz	O ID do registro CRM principal ou selecionado para aquele grupo.
ID CRM Correspondido	O ID do registro CRM que está sendo verificado.
Nome da Conta CRM	Nome da empresa do CRM.
Endereço	Endereço da conta CRM.
Veredito	Resultado da correspondência: Correspondência Forte, Correspondência Parcial ou Sem Correspondência.
Pontuação	Pontuação de similaridade entre o nome da empresa e o endereço. Pontuações mais altas indicam uma correspondência mais próxima.

Significados dos Vereditos

Correspondência Forte - Registros com alta probabilidade de serem duplicatas.
Correspondência Parcial - Registros são semelhantes e podem precisar de revisão.
Sem Correspondência - Nenhuma correspondência de duplicata foi encontrada para aquele registro.

Exemplo

Nº do Grupo	ID da Matriz	ID CRM Correspondido	Nome da Conta CRM	Endereço	Veredito	Pontuação
1	CRM3001B	CRM3001B	MetroVale Tech Partners Ltd.	143 E Indl Pkwy	Sem Correspondência	0
2	CRM3002B	CRM3002B	Northstar Logic Information Sys. Limited	180 Mt Pleasant Rd	Sem Correspondência	0
3	CRM3002A	CRM3002A	Northstar Logic Information Systems Limited	180 Mt Pleasant Rd	Correspondência Forte	95
3	CRM3002A	CRM3002B	Northstar Logic Information Sys. Limited	180 Mt Pleasant Rd	Correspondência Forte	95

2. Arquivo de Registros Únicos

Este arquivo fornece uma lista limpa de registros a manter.

Para cada grupo de duplicatas, ele inclui apenas um registro CRM selecionado. Se um grupo tiver correspondências de duplicatas fortes ou parciais, os registros restantes desse grupo não são repetidos neste arquivo.

Todos os registros com veredito Sem Correspondência também são incluídos porque já são únicos.

Por exemplo, se um grupo contém duas correspondências parciais e uma correspondência forte, este arquivo mostrará apenas um registro selecionado desse grupo.

Coluna	Significado
Nº do Grupo	O número do grupo atribuído durante a correspondência.
ID CRM Correspondido	O ID do registro CRM único selecionado.
Nome da Conta CRM	Nome da empresa do registro selecionado.
Endereço	Endereço do registro selecionado.

Exemplo

Nº do Grupo	ID CRM Correspondido	Nome da Conta CRM	Endereço
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

Resumo

Use o Arquivo de Resultados de Correspondência Detalhados para revisar todas as decisões de correspondência.
Use o Arquivo de Registros Únicos quando precisar de um registro por grupo de duplicatas, juntamente com todos os registros que não corresponderam a nenhum outro registro.

Suporte

Problemas: https://github.com/QoreNext/qorenext-crm-mcp/issues
E-mail: support@qorenext.com
Documentação: https://qorenext.com

Licença

MIT