🎯 Alegra MCP - Instalación Rápida
🚀 Opción 1: Instalación Automática (Recomendada)
Ejecuta el instalador y sigue las instrucciones:
python setup.pyEl instalador hará:
- ✅ Verificar Python y dependencias
- ✅ Instalar paquetes necesarios
- ✅ Configurar tus credenciales de Alegra
- ✅ Probar la conexión
- ✅ Configurar Claude Desktop automáticamente
---
📝 Opción 2: Instalación Manual
Paso 1: Instalar dependencias
pip install -r requirements.txtPaso 2: Configurar credenciales
Crea un archivo .env con: `` ALEGRA_EMAIL=tu-email@alegra.com ALEGRA_TOKEN=tu-token-api ``
Paso 3: Probar
python test_alegra_mcp.pyPaso 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": "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
- Ve a https://app.alegra.com
- Configuración → API - Integraciones
- 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.
