🎯 Alegra MCP - Instalación Rápida

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

Ejecuta el instalador y sigue las instrucciones:

python setup.py

El 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.txt

Paso 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.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": "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.

Alegra MCP