# 🎯 Alegra MCP - Instalación Rápida

## 🚀 Opción 1: Instalación Automática (Recomendada)

Ejecuta el instalador y sigue las instrucciones:

```bash
python setup.py
```

El instalador hará:
1. ✅ Verificar Python y dependencias
2. ✅ Instalar paquetes necesarios
3. ✅ Configurar tus credenciales de Alegra
4. ✅ Probar la conexión
5. ✅ Configurar Claude Desktop automáticamente

---

## 📝 Opción 2: Instalación Manual

### Paso 1: Instalar dependencias
```bash
pip install -r requirements.txt
```

### Paso 2: Configurar credenciales

Crea un archivo `.env` con:
```
ALEGRA_EMAIL=tu-email@alegra.com
ALEGRA_TOKEN=tu-token-api
```

### Paso 3: Probar
```bash
python test_alegra_mcp.py
```

### Paso 4: Configurar Claude Desktop

Edita `claude_desktop_config.json` (ver ubicación abajo) y agrega:

```json
{
  "mcpServers": {
    "alegra": {
      "command": "python",
      "args": ["/RUTA/COMPLETA/alegra_mcp_server.py"],
      "env": {
        "ALEGRA_EMAIL": "tu-email@alegra.com",
        "ALEGRA_TOKEN": "tu-token-api"
      }
    }
  }
}
```

**Ubicación de claude_desktop_config.json:**
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
- Linux: `~/.config/Claude/claude_desktop_config.json`

---

## 🔐 Obtener Credenciales de Alegra

1. Ve a https://app.alegra.com
2. Configuración → API - Integraciones
3. Copia tu email y token API

---

## ✅ Verificar que funciona

Después de configurar, reinicia Claude Desktop y prueba:

- "Busca productos en Alegra"
- "¿Cuánto stock tengo del producto 123?"
- "Muéstrame productos con stock bajo"

---

## 📚 Documentación

- **INSTALACION.md**: Guía detallada paso a paso
- **QUICK_START.md**: Ejemplos y casos de uso
- **README_ALEGRA_MCP.md**: Documentación técnica completa

---

## 🆘 Problemas Comunes

### "Authentication failed"
- Verifica email y token en https://app.alegra.com
- Revisa que no haya espacios extras

### "Module not found"
```bash
pip install -r requirements.txt
```

### "No aparecen las herramientas en Claude"
- Verifica la ruta absoluta en la configuración
- Reinicia Claude Desktop completamente

---

## 🎉 ¡Listo!

Una vez instalado, podrás:
- ✅ Buscar productos con lenguaje natural
- ✅ Consultar inventario y stock
- ✅ Actualizar precios rápidamente
- ✅ Hacer consultas complejas sobre tu inventario

**¿Necesitas ayuda?** Lee INSTALACION.md para instrucciones detalladas.