npm package: @logicware-ai/crm-mcp
Description: MCP Server oficial de Logicware para procesamiento y análisis inteligente de leads y ventas mediante IA
Author: Logicware Peru
Latest version: 1.0.3

# 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í](https://nodejs.org))
- ✅ **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:

```bash
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`:

```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:**
```json
{
  "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:

```bash
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:**
```cmd
set LOGICWARE_API_KEY=tu-api-key
set LOGICWARE_SUBDOMAIN=tu-subdomain
npx @logicware-ai/crm-mcp
```

**macOS/Linux:**
```bash
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!