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.

GitHubExperimente este MCPPatrocinado

Documentação

Qorenext CRM MCP

Análise de hierarquia empresarial 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 empresarial e verificação de endereços diretamente no chat.

Obtenha sua chave de API

Cadastre-se em https://qorenext-app.azurewebsites.net/signup para obter sua 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

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

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

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

Ferramentas

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

`health_check`

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

check if Qorenext CRM MCP is running

`submit_address_verification`

Envia 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`

Envia 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árias.

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`

Envia registros de contas duplicadas de arquivos (JSON, CSV ou Excel) 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
excel ou xlsx - Pastas de trabalho do Microsoft Excel

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 - Código postal/CEP
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 duplicados detectados
message: Descrição dos resultados
details: Contagem de registros e contagem de pares duplicados

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`

Consulta 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

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

Suporte

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

Licença

MIT