nexusflex-mcp

Servidor MCP (Model Context Protocol) de Nexus Flex. Deja que un asistente de IA (Claude Desktop / Claude Code) opere tu nodo o tu cuenta de vendedor con lenguaje natural: altas de clientes, consulta de stock disponible, rentabilidad por SKU, KPIs y precios. Nunca toca dinero (facturación, cobros, cuentas, liquidaciones están bloqueados por diseño).

Uso rápido

# 1) Autorizá una vez (se abre el navegador):
npx -y nexusflex-mcp@latest login

# 2) En claude_desktop_config.json:
#   "nexusflex": { "command": "npx", "args": ["-y", "nexusflex-mcp@latest"] }

Guía completa en español: INSTALAR.md.

Cómo funciona (seguridad)

• Login por device-flow (autorización web): el MCP pide un código, lo autorizás con un click desde la web (ya logueado), y recibe un token de vida larga, revocable guardado localmente. No se pega email/contraseña.
• Herencia de scope: el token es un puntero opaco a tu usuario; el backend re-lee tu rol/permisos/nodo frescos en cada request. El MCP no puede hacer nada que vos no puedas desde la web. Revocar un permiso (o el token) en la app corta el acceso al instante.
• Aislamiento en 3 capas: gating del backend (por rol + nodo/cliente) · tools por rol · denylist de dinero (en el cliente y en el backend).

Comandos

| Comando | Qué hace | |---|---| | npx nexusflex-mcp | Arranca el servidor MCP (stdio). Lo usa Claude Desktop. | | npx nexusflex-mcp login | Autoriza por device-flow y guarda el token. | | npx nexusflex-mcp logout | Borra el token local. |

Variables de entorno

| Var | Default | Descripción | |---|---|---| | NEXUSFLEX_API_URL | https://nexusflex.com.ar/api | Base de la API. | | NEXUSFLEX_MCP_ALLOW_WRITE | false | Habilita altas/ediciones (nunca dinero). | | NEXUSFLEX_MCP_ALLOW_PRECIOS | false | Habilita editar listas de precios. | | NEXUSFLEX_TOKEN | — | Token ya emitido (salta el device-flow). | | NEXUSFLEX_EMAIL / NEXUSFLEX_PASSWORD | — | Login legado por contraseña. |

Licencia

MIT.