logicwareperu/crm-mcp

Logicware CRM MCP - Guía de Instalación

📋 Requisitos Previos

Antes de comenzar, asegúrate de tener:

• ✅ Node.js 18 o superior instalado (Descargar aquí)
• ✅ Claude Desktop instalado
• ✅ Credenciales de Logicware CRM:
  • API Key (formato: lw_prod_...)
  • Subdomain (nombre de tu empresa en Logicware)

¿Cómo obtener las credenciales?

Contacta al administrador de Logicware de tu empresa o solicítalas directamente al equipo de soporte de Logicware.

🚀 Instalación (2 minutos)

Paso 1: Instalar el MCP Server

Abre una terminal (CMD o PowerShell) y ejecuta:

npm install -g @logicware-ai/crm-mcp

Esto instalará el servidor globalmente en tu sistema.

Paso 2: Configurar Claude Desktop

Windows

1. Presiona Win + R y escribe: %APPDATA%\Claude
2. Abre el archivo claude_desktop_config.json con el Bloc de notas
3. Si el archivo no existe, créalo

macOS

1. Abre Terminal
2. Ejecuta: nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

Linux

1. Abre Terminal
2. Ejecuta: nano ~/.config/Claude/claude_desktop_config.json

Paso 3: Agregar la Configuración

Copia y pega esto en el archivo claude_desktop_config.json:

{
  "mcpServers": {
    "logicware-mcp": {
      "command": "npx",
      "args": ["@logicware-ai/crm-mcp"],
      "env": {
        "LOGICWARE_API_KEY": "PEGA_TU_API_KEY_AQUI",
        "LOGICWARE_SUBDOMAIN": "PEGA_TU_SUBDOMAIN_AQUI"
      }
    }
  }
}

⚠️ IMPORTANTE:

• Reemplaza PEGA_TU_API_KEY_AQUI con tu API Key real
• Reemplaza PEGA_TU_SUBDOMAIN_AQUI con tu subdomain

Ejemplo:

{
  "mcpServers": {
    "logicware-mcp": {
      "command": "npx",
      "args": ["@logicware-ai/crm-mcp"],
      "env": {
        "LOGICWARE_API_KEY": "lw_prod_abc123xyz456",
        "LOGICWARE_SUBDOMAIN": "proveedor-demo"
      }
    }
  }
}

Guarda el archivo.

Paso 4: Reiniciar Claude Desktop

1. Cierra completamente Claude Desktop
2. Asegúrate de que no esté ejecutándose en segundo plano (revisa la bandeja del sistema)
3. Abre Claude Desktop nuevamente

✅ Verificar Instalación

1. Abre Claude Desktop
2. Ve a Configuración → Desarrollador → Servidores MCP locales
3. Deberías ver "logicware-mcp" en la lista con un indicador verde ✓

Si aparece en rojo o con error, revisa que las credenciales estén correctas.

🎯 ¿Cómo Usar?

Ahora puedes preguntarle a Claude cosas como:

Análisis de Leads

"Analiza el lead 12345 y dame un resumen completo"
"¿Qué tan activo está el cliente 19902?"
"Dame insights del lead 8869"

Recomendaciones

"¿Qué acciones debo tomar con el lead 12345?"
"Dame recomendaciones para el cliente con ID 8869"

Consultas de Stock

"¿Qué unidades están disponibles en el proyecto LOGICWARE etapa 1?"
"Muéstrame el stock del proyecto LOGICWARE"

Información del Lead

"Muéstrame todas las actividades del lead 12345"
"¿Qué citas tiene programadas el lead 19902?"
"Dame las notas del cliente 8869"

🔄 Actualizar a Nueva Versión

Cuando se publique una nueva versión, simplemente ejecuta:

npm update -g @logicware-ai/crm-mcp

Reinicia Claude Desktop y listo.

🔒 Seguridad

Protección de Credenciales

• ✅ Tus credenciales solo están en tu computadora
• ✅ Nunca se comparten ni se suben a ningún servidor
• ✅ El archivo de configuración es local y privado

Mejores Prácticas

1. No compartas tu claude_desktop_config.json
2. No publiques tus credenciales en ningún lado
3. Cambia tu API Key periódicamente
4. Contacta al administrador si crees que tus credenciales fueron comprometidas

❓ Solución de Problemas

"No se han agregado servidores" o aparece vacío

Solución:

1. Verifica que el archivo claude_desktop_config.json esté en la ubicación correcta
2. Revisa que el JSON esté bien formado (sin errores de sintaxis)
3. Asegúrate de haber guardado el archivo
4. Reinicia Claude Desktop completamente

"Error de autenticación" o error 401

Solución:

1. Verifica que tu API Key sea correcta (debe comenzar con lw_prod_)
2. Verifica que tu subdomain sea correcto
3. Contacta al administrador de Logicware para confirmar que tus credenciales estén activas

El servidor no responde

Solución:

1. Verifica que Node.js esté instalado: node --version
2. Reinstala el MCP: npm install -g @logicware/crm-mcp
3. Revisa los logs de Claude en %APPDATA%\Claude\logs\

Otros problemas

Ejecuta esto en la terminal para probar el servidor manualmente:

Windows:

set LOGICWARE_API_KEY=tu-api-key
set LOGICWARE_SUBDOMAIN=tu-subdomain
npx @logicware-ai/crm-mcp

macOS/Linux:

export LOGICWARE_API_KEY=tu-api-key
export LOGICWARE_SUBDOMAIN=tu-subdomain
npx @logicware/crm-mcp

Deberías ver: ✅ Credenciales configuradas correctamente

📞 Soporte

Si tienes problemas con la instalación o uso:

• Email: soporte@logicwareperu.com
• Teléfono: +51 953 448 476
• Documentación completa: https://docs.logicwareperu.com

Para problemas con Logicware CRM (credenciales, API):

• Soporte Logicware: +51 953 448 476

📝 Notas de Versión

v1.0.0 (Octubre 2025)

• ✨ Versión inicial
• 📊 Análisis de leads con IA
• 🎯 Recomendaciones priorizadas
• 💯 Health Score y Engagement Score
• 📦 13 herramientas disponibles
• 🔒 Configuración segura de credenciales

¿Necesitas ayuda? No dudes en contactarnos. ¡Estamos aquí para ayudarte!