Alegra

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

Ejecuta el instalador y sigue las instrucciones:

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

pip install -r requirements.txt

Paso 2: Configurar credenciales

Crea un archivo .env con:

[email protected]
ALEGRA_TOKEN=tu-token-api

Paso 3: Probar

python test_alegra_mcp.py

Paso 4: Configurar Claude Desktop

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

{
  "mcpServers": {
    "alegra": {
      "command": "python",
      "args": ["/RUTA/COMPLETA/alegra_mcp_server.py"],
      "env": {
        "ALEGRA_EMAIL": "[email protected]",
        "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"

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.