🎯 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á:

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

Related MCP server: MCP VTEX Server

📝 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

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.