nexusflex-mcp 3.0.0 → 3.1.0

package/INSTALAR.md

@@ -1,97 +1,97 @@
-# MCP de Nexus Flex — Instalación (npx + autorización web)
-
-Este paquete deja que un asistente de IA (**Claude Desktop** o **Claude Code**) opere
-Nexus Flex **con tu cuenta**, en tu computadora, hablando con la API igual que la web.
-
-> **Seguridad (aislamiento en 3 capas):** el MCP no puede hacer nada que tu usuario no
-> pueda hacer desde la web. **1)** El backend gatea cada dato por rol y por nodo/cliente
-> (el token hereda tu rol/permisos frescos en cada pedido). **2)** El MCP muestra SOLO
-> los tools de tu rol. **3)** Nunca toca facturación/cobros/cuentas (bloqueado en el
-> cliente **y** en el backend). Cada usuario ve **solo lo suyo**.
-
----
-
-## 1. Requisitos
-- **Node.js 20+** — https://nodejs.org (LTS). Verificá con `node --version`.
-- **Claude Desktop** (https://claude.ai/download) o Claude Code.
-- Una cuenta de Nexus Flex (la misma de la web). **No** hace falta tu contraseña acá:
-  autorizás desde el navegador.
-
-## 2. Autorizar (una sola vez)
-En una terminal, corré:
-
-```bash
-npx -y nexusflex-mcp@latest login
-```
-
-Se abre el navegador (o te muestra un link + un código de 8 letras). Entrás a Nexus Flex
-—si no estás logueado, iniciás sesión— y hacés click en **Autorizar**. Listo: el token
-queda guardado en tu equipo (`~/.nexusflex-mcp/token.json`).
-
-## 3. Conectarlo a Claude Desktop
-Editá el config de Claude Desktop:
-- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
-- **Mac:** `~/Library/Application Support/Claude/claude_desktop_config.json`
-
-Pegá esto (¡sin email ni contraseña!):
-
-```json
-{
-  "mcpServers": {
-    "nexusflex": {
-      "command": "npx",
-      "args": ["-y", "nexusflex-mcp@latest"],
-      "env": {
-        "NEXUSFLEX_MCP_ALLOW_WRITE": "true",
-        "NEXUSFLEX_MCP_ALLOW_PRECIOS": "false"
-      }
-    }
-  }
-}
-```
-
-Guardá y **reiniciá Claude Desktop**. (Si nunca corriste el paso 2, la primera vez que
-arranque el MCP te va a mostrar el link + código en sus logs para que autorices.)
-
-- `NEXUSFLEX_MCP_ALLOW_WRITE` = `"true"` habilita **altas y ediciones** (clientes,
-  productos, y nodos si sos admin global). `"false"` = solo consulta.
-- `NEXUSFLEX_MCP_ALLOW_PRECIOS` = `"true"` habilita **actualizar listas de precios**.
-
-## 4. Qué ve cada usuario (según con qué cuenta autorices)
-
-**CLIENTE (vendedor):** `mis_datos`, `mis_envios`, `mis_kpis`, `mi_stock`,
-`mi_disponible` (disponible-para-vender por SKU), `mi_rentabilidad` (margen por SKU),
-`mis_productos`, `mis_top_productos`. **No** ve datos del nodo ni de otros clientes.
-
-**STAFF del nodo:** `clientes_del_nodo`, `precios_ver`, `kpi_nodo`, `stock_nodo`,
-`productos_nodo`, `top_productos`, y —con escritura— `cliente_crear`, `cliente_editar`,
-`producto_crear`, y —con precios— `precio_actualizar`. Todo scopeado a **su** nodo.
-
-**Admin GLOBAL:** además `nodos_listar`, `kpi_red`, `nodo_crear`.
-
-## 5. Ejemplos (lenguaje natural en Claude)
-- *"¿Qué usuario y alcance tengo?"* → `mis_datos`.
-- *"¿Cuánto tengo disponible para vender del SKU ABC?"* → `mi_disponible`.
-- *"¿Qué productos me dejan más margen este mes?"* → `mi_rentabilidad`.
-- *"Dame de alta a Distribuidora López con la lista B."* → `cliente_crear`.
-- *"Actualizá la lista B: cercana 3800, media 4200."* → `precio_actualizar` (necesita ALLOW_PRECIOS).
-
-## 6. Revocar el acceso
-En la web de Nexus Flex, sección **🔌 Conexiones**, revocás cualquier asistente cuando
-quieras. Local: `npx -y nexusflex-mcp@latest logout` borra el token de tu equipo.
-
-## 7. Qué NO puede hacer — nunca
-Facturar, registrar cobros/pagos, tocar cuentas corrientes, liquidaciones ni saldos.
-Está bloqueado en el cliente **y** en el backend; aunque se lo pidas, lo rechaza.
-
-## Alternativas de credenciales (avanzado / compatibilidad)
-- `NEXUSFLEX_TOKEN` = un token ya emitido (MCP o JWT) → salta el device-flow.
-- `NEXUSFLEX_EMAIL` + `NEXUSFLEX_PASSWORD` = login legado por contraseña.
-- `NEXUSFLEX_API_URL` = base de la API (default `https://nexusflex.com.ar/api`).
-- `NEXUSFLEX_MCP_NO_AUTH_PROMPT=true` = no abrir device-flow automáticamente (falla
-  pidiendo `login` explícito).
-
-## Problemas comunes
-- *"Sesión inválida"* (401) → corré `npx nexusflex-mcp login` de nuevo (te lo pudieron revocar).
-- *"No tenés permiso"* (403) → tu usuario no tiene ese permiso (es correcto: el backend aísla).
-- No aparecen las herramientas → cerrá Claude Desktop del todo y reabrí.
+# MCP de Nexus Flex — Instalación (npx + autorización web)
+
+Este paquete deja que un asistente de IA (**Claude Desktop** o **Claude Code**) opere
+Nexus Flex **con tu cuenta**, en tu computadora, hablando con la API igual que la web.
+
+> **Seguridad (aislamiento en 3 capas):** el MCP no puede hacer nada que tu usuario no
+> pueda hacer desde la web. **1)** El backend gatea cada dato por rol y por nodo/cliente
+> (el token hereda tu rol/permisos frescos en cada pedido). **2)** El MCP muestra SOLO
+> los tools de tu rol. **3)** Nunca toca facturación/cobros/cuentas (bloqueado en el
+> cliente **y** en el backend). Cada usuario ve **solo lo suyo**.
+
+---
+
+## 1. Requisitos
+- **Node.js 20+** — https://nodejs.org (LTS). Verificá con `node --version`.
+- **Claude Desktop** (https://claude.ai/download) o Claude Code.
+- Una cuenta de Nexus Flex (la misma de la web). **No** hace falta tu contraseña acá:
+  autorizás desde el navegador.
+
+## 2. Autorizar (una sola vez)
+En una terminal, corré:
+
+```bash
+npx -y nexusflex-mcp@latest login
+```
+
+Se abre el navegador (o te muestra un link + un código de 8 letras). Entrás a Nexus Flex
+—si no estás logueado, iniciás sesión— y hacés click en **Autorizar**. Listo: el token
+queda guardado en tu equipo (`~/.nexusflex-mcp/token.json`).
+
+## 3. Conectarlo a Claude Desktop
+Editá el config de Claude Desktop:
+- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+- **Mac:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+
+Pegá esto (¡sin email ni contraseña!):
+
+```json
+{
+  "mcpServers": {
+    "nexusflex": {
+      "command": "npx",
+      "args": ["-y", "nexusflex-mcp@latest"],
+      "env": {
+        "NEXUSFLEX_MCP_ALLOW_WRITE": "true",
+        "NEXUSFLEX_MCP_ALLOW_PRECIOS": "false"
+      }
+    }
+  }
+}
+```
+
+Guardá y **reiniciá Claude Desktop**. (Si nunca corriste el paso 2, la primera vez que
+arranque el MCP te va a mostrar el link + código en sus logs para que autorices.)
+
+- `NEXUSFLEX_MCP_ALLOW_WRITE` = `"true"` habilita **altas y ediciones** (clientes,
+  productos, y nodos si sos admin global). `"false"` = solo consulta.
+- `NEXUSFLEX_MCP_ALLOW_PRECIOS` = `"true"` habilita **actualizar listas de precios**.
+
+## 4. Qué ve cada usuario (según con qué cuenta autorices)
+
+**CLIENTE (vendedor):** `mis_datos`, `mis_envios`, `mis_kpis`, `mi_stock`,
+`mi_disponible` (disponible-para-vender por SKU), `mi_rentabilidad` (margen por SKU),
+`mis_productos`, `mis_top_productos`. **No** ve datos del nodo ni de otros clientes.
+
+**STAFF del nodo:** `clientes_del_nodo`, `precios_ver`, `kpi_nodo`, `stock_nodo`,
+`productos_nodo`, `top_productos`, y —con escritura— `cliente_crear`, `cliente_editar`,
+`producto_crear`, y —con precios— `precio_actualizar`. Todo scopeado a **su** nodo.
+
+**Admin GLOBAL:** además `nodos_listar`, `kpi_red`, `nodo_crear`.
+
+## 5. Ejemplos (lenguaje natural en Claude)
+- *"¿Qué usuario y alcance tengo?"* → `mis_datos`.
+- *"¿Cuánto tengo disponible para vender del SKU ABC?"* → `mi_disponible`.
+- *"¿Qué productos me dejan más margen este mes?"* → `mi_rentabilidad`.
+- *"Dame de alta a Distribuidora López con la lista B."* → `cliente_crear`.
+- *"Actualizá la lista B: cercana 3800, media 4200."* → `precio_actualizar` (necesita ALLOW_PRECIOS).
+
+## 6. Revocar el acceso
+En la web de Nexus Flex, sección **🔌 Conexiones**, revocás cualquier asistente cuando
+quieras. Local: `npx -y nexusflex-mcp@latest logout` borra el token de tu equipo.
+
+## 7. Qué NO puede hacer — nunca
+Facturar, registrar cobros/pagos, tocar cuentas corrientes, liquidaciones ni saldos.
+Está bloqueado en el cliente **y** en el backend; aunque se lo pidas, lo rechaza.
+
+## Alternativas de credenciales (avanzado / compatibilidad)
+- `NEXUSFLEX_TOKEN` = un token ya emitido (MCP o JWT) → salta el device-flow.
+- `NEXUSFLEX_EMAIL` + `NEXUSFLEX_PASSWORD` = login legado por contraseña.
+- `NEXUSFLEX_API_URL` = base de la API (default `https://nexusflex.com.ar/api`).
+- `NEXUSFLEX_MCP_NO_AUTH_PROMPT=true` = no abrir device-flow automáticamente (falla
+  pidiendo `login` explícito).
+
+## Problemas comunes
+- *"Sesión inválida"* (401) → corré `npx nexusflex-mcp login` de nuevo (te lo pudieron revocar).
+- *"No tenés permiso"* (403) → tu usuario no tiene ese permiso (es correcto: el backend aísla).
+- No aparecen las herramientas → cerrá Claude Desktop del todo y reabrí.

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Nexus Flex
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Nexus Flex
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,52 +1,52 @@
-# nexusflex-mcp
-
-Servidor **MCP** (Model Context Protocol) de [Nexus Flex](https://nexusflex.com.ar). 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
-
-```bash
-# 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](./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.
+# nexusflex-mcp
+
+Servidor **MCP** (Model Context Protocol) de [Nexus Flex](https://nexusflex.com.ar). 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
+
+```bash
+# 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](./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.

package/api.mjs

@@ -1,135 +1,135 @@
-// ============================================================================
-//  Cliente HTTP fino y autenticado contra la API REST de Nexus Flex.
-//
-//  PRINCIPIO DE SEGURIDAD (no romper): el MCP NO habla con la base de datos ni
-//  firma tokens propios. Usa un TOKEN REAL (device-flow, o el JWT del login) y
-//  TODA llamada pasa por el middleware de permisos del backend (requireAuth/
-//  requirePermiso + scope por nodo). El aislamiento entre nodos y por rol se
-//  hereda 100% del backend: el MCP no puede hacer nada que ese usuario no pueda.
-//
-//  Autenticación (en orden de preferencia):
-//    1) NEXUSFLEX_TOKEN            token explícito (MCP o JWT) por env
-//    2) token guardado             ~/.nexusflex-mcp/token.json (device-flow previo)
-//    3) NEXUSFLEX_EMAIL/PASSWORD   login legado (compatibilidad hacia atrás)
-//    4) device-flow interactivo    imprime URL + código, autorizás en el navegador
-// ============================================================================
-import { loadToken, saveToken, clearToken, runDeviceFlow } from "./device-auth.mjs";
-
-const API_URL = (process.env.NEXUSFLEX_API_URL ?? "https://nexusflex.com.ar/api").replace(/\/+$/, "");
-const EMAIL = process.env.NEXUSFLEX_EMAIL ?? "";
-const PASSWORD = process.env.NEXUSFLEX_PASSWORD ?? "";
-const NO_AUTH_PROMPT = /^(1|true|yes|si|sí)$/i.test(process.env.NEXUSFLEX_MCP_NO_AUTH_PROMPT ?? "");
-let TOKEN = process.env.NEXUSFLEX_TOKEN ?? "";
-let usandoDeviceFlow = false; // el token vino de un device-flow/guardado (no email/pass)
-
-export { API_URL };
-
-// Denylist de DEFENSA EN PROFUNDIDAD: aunque en el futuro alguien agregue un tool
-// por error, el cliente NUNCA llama a endpoints que muevan dinero o expongan datos
-// financieros. El backend además lo bloquea server-side para tokens de MCP (mcpMoneyGuard).
-const RUTAS_PROHIBIDAS = [
-  /^\/liquidaciones/i, /^\/cuentas/i, /^\/cobros/i, /^\/afip/i, /^\/personal/i,
-  /^\/balance/i, /^\/reportes/i, /^\/programacion/i, /^\/recuento/i, /^\/whatsapp/i,
-  /^\/logisticas\/[^/]*\/cargo/i, /^\/logisticas\/saldos/i, /^\/logisticas\/facturar/i,
-  /^\/logisticas\/costo/i, /\/facturacion/i,
-];
-
-/** Timeout de red por llamada (ms). Un backend colgado no debe colgar el tool. */
-const FETCH_TIMEOUT_MS = Number(process.env.NEXUSFLEX_MCP_TIMEOUT_MS) || 30000;
-
-/** SIEMPRE loguear a stderr: stdout es el canal del transporte MCP (stdio). */
-export function log(...args) {
-  console.error("[nexusflex-mcp]", ...args);
-}
-
-// Aviso si se van a mandar credenciales por HTTP sin cifrar (login legado).
-if (EMAIL && PASSWORD && !/^https:\/\//i.test(API_URL)) {
-  log("ADVERTENCIA: NEXUSFLEX_API_URL no es HTTPS y hay email/contraseña — viajarían sin cifrar.");
-}
-
-function guard(path) {
-  const clean = path.split("?")[0];
-  if (RUTAS_PROHIBIDAS.some((re) => re.test(clean))) {
-    throw new Error(`Ruta bloqueada por política del MCP (endpoints de dinero deshabilitados): ${clean}`);
-  }
-}
-
-async function login() {
-  const r = await fetch(`${API_URL}/auth/login`, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({ email: EMAIL, password: PASSWORD }),
-    signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
-  });
-  if (!r.ok) throw new Error(`Login falló (${r.status}). Revisá email/contraseña del nodo.`);
-  const data = await r.json();
-  if (!data?.token) throw new Error("Login sin token en la respuesta.");
-  TOKEN = data.token;
-  usandoDeviceFlow = false;
-  log(`Sesión iniciada como ${data.usuario?.email} (rol ${data.usuario?.rol}, nodo ${data.usuario?.logisticaId ?? "global"}).`);
-  return TOKEN;
-}
-
-/** Corre el device-flow, guarda el token y lo deja listo para usar. */
-async function autorizarPorDeviceFlow() {
-  const token = await runDeviceFlow(API_URL, { open: true, log });
-  saveToken(token, API_URL);
-  TOKEN = token;
-  usandoDeviceFlow = true;
-  return TOKEN;
-}
-
-/** Resuelve un token válido siguiendo el orden de preferencia. */
-async function ensureToken() {
-  if (TOKEN) return TOKEN;
-  // 2) token guardado de un device-flow anterior (atado a esta API).
-  const guardado = loadToken(API_URL);
-  if (guardado) { TOKEN = guardado; usandoDeviceFlow = true; return TOKEN; }
-  // 3) login legado por email/contraseña (compatibilidad).
-  if (EMAIL && PASSWORD) return login();
-  // 4) device-flow interactivo (a menos que se deshabilite explícitamente).
-  if (NO_AUTH_PROMPT) {
-    throw new Error("No hay token. Ejecutá `npx nexusflex-mcp login` para autorizar, o definí NEXUSFLEX_TOKEN.");
-  }
-  return autorizarPorDeviceFlow();
-}
-
-/** Llamada autenticada a la API. Reintenta UNA vez si el token venció/se revocó. */
-export async function api(method, path, body) {
-  guard(path);
-  let token = await ensureToken();
-  const doFetch = (t) =>
-    fetch(`${API_URL}${path}`, {
-      method,
-      headers: { "Content-Type": "application/json", Authorization: `Bearer ${t}` },
-      body: body != null ? JSON.stringify(body) : undefined,
-      signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
-    });
-
-  let r = await doFetch(token);
-  if (r.status === 401) {
-    if (EMAIL && PASSWORD && !usandoDeviceFlow) {
-      // Token JWT vencido: re-login por credenciales.
-      log("401: token vencido, reintentando login…");
-      token = await login();
-      r = await doFetch(token);
-    } else if (usandoDeviceFlow && !NO_AUTH_PROMPT) {
-      // Token de MCP inválido/revocado: limpiamos y re-autorizamos por device-flow.
-      log("401: el token de MCP no es válido (revocado/vencido). Re-autorizando…");
-      clearToken();
-      TOKEN = "";
-      token = await autorizarPorDeviceFlow();
-      r = await doFetch(token);
-    }
-  }
-
-  const text = await r.text();
-  let data = null;
-  try {
-    data = text ? JSON.parse(text) : null;
-  } catch {
-    data = text;
-  }
-  log(`${method} ${path.split("?")[0]} -> ${r.status}`);
-  return { ok: r.ok, status: r.status, data };
-}
+// ============================================================================
+//  Cliente HTTP fino y autenticado contra la API REST de Nexus Flex.
+//
+//  PRINCIPIO DE SEGURIDAD (no romper): el MCP NO habla con la base de datos ni
+//  firma tokens propios. Usa un TOKEN REAL (device-flow, o el JWT del login) y
+//  TODA llamada pasa por el middleware de permisos del backend (requireAuth/
+//  requirePermiso + scope por nodo). El aislamiento entre nodos y por rol se
+//  hereda 100% del backend: el MCP no puede hacer nada que ese usuario no pueda.
+//
+//  Autenticación (en orden de preferencia):
+//    1) NEXUSFLEX_TOKEN            token explícito (MCP o JWT) por env
+//    2) token guardado             ~/.nexusflex-mcp/token.json (device-flow previo)
+//    3) NEXUSFLEX_EMAIL/PASSWORD   login legado (compatibilidad hacia atrás)
+//    4) device-flow interactivo    imprime URL + código, autorizás en el navegador
+// ============================================================================
+import { loadToken, saveToken, clearToken, runDeviceFlow } from "./device-auth.mjs";
+
+const API_URL = (process.env.NEXUSFLEX_API_URL ?? "https://nexusflex.com.ar/api").replace(/\/+$/, "");
+const EMAIL = process.env.NEXUSFLEX_EMAIL ?? "";
+const PASSWORD = process.env.NEXUSFLEX_PASSWORD ?? "";
+const NO_AUTH_PROMPT = /^(1|true|yes|si|sí)$/i.test(process.env.NEXUSFLEX_MCP_NO_AUTH_PROMPT ?? "");
+let TOKEN = process.env.NEXUSFLEX_TOKEN ?? "";
+let usandoDeviceFlow = false; // el token vino de un device-flow/guardado (no email/pass)
+
+export { API_URL };
+
+// Denylist de DEFENSA EN PROFUNDIDAD: aunque en el futuro alguien agregue un tool
+// por error, el cliente NUNCA llama a endpoints que muevan dinero o expongan datos
+// financieros. El backend además lo bloquea server-side para tokens de MCP (mcpMoneyGuard).
+const RUTAS_PROHIBIDAS = [
+  /^\/liquidaciones/i, /^\/cuentas/i, /^\/cobros/i, /^\/afip/i, /^\/personal/i,
+  /^\/balance/i, /^\/reportes/i, /^\/programacion/i, /^\/recuento/i, /^\/whatsapp/i,
+  /^\/logisticas\/[^/]*\/cargo/i, /^\/logisticas\/saldos/i, /^\/logisticas\/facturar/i,
+  /^\/logisticas\/costo/i, /\/facturacion/i,
+];
+
+/** Timeout de red por llamada (ms). Un backend colgado no debe colgar el tool. */
+const FETCH_TIMEOUT_MS = Number(process.env.NEXUSFLEX_MCP_TIMEOUT_MS) || 30000;
+
+/** SIEMPRE loguear a stderr: stdout es el canal del transporte MCP (stdio). */
+export function log(...args) {
+  console.error("[nexusflex-mcp]", ...args);
+}
+
+// Aviso si se van a mandar credenciales por HTTP sin cifrar (login legado).
+if (EMAIL && PASSWORD && !/^https:\/\//i.test(API_URL)) {
+  log("ADVERTENCIA: NEXUSFLEX_API_URL no es HTTPS y hay email/contraseña — viajarían sin cifrar.");
+}
+
+function guard(path) {
+  const clean = path.split("?")[0];
+  if (RUTAS_PROHIBIDAS.some((re) => re.test(clean))) {
+    throw new Error(`Ruta bloqueada por política del MCP (endpoints de dinero deshabilitados): ${clean}`);
+  }
+}
+
+async function login() {
+  const r = await fetch(`${API_URL}/auth/login`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ email: EMAIL, password: PASSWORD }),
+    signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
+  });
+  if (!r.ok) throw new Error(`Login falló (${r.status}). Revisá email/contraseña del nodo.`);
+  const data = await r.json();
+  if (!data?.token) throw new Error("Login sin token en la respuesta.");
+  TOKEN = data.token;
+  usandoDeviceFlow = false;
+  log(`Sesión iniciada como ${data.usuario?.email} (rol ${data.usuario?.rol}, nodo ${data.usuario?.logisticaId ?? "global"}).`);
+  return TOKEN;
+}
+
+/** Corre el device-flow, guarda el token y lo deja listo para usar. */
+async function autorizarPorDeviceFlow() {
+  const token = await runDeviceFlow(API_URL, { open: true, log });
+  saveToken(token, API_URL);
+  TOKEN = token;
+  usandoDeviceFlow = true;
+  return TOKEN;
+}
+
+/** Resuelve un token válido siguiendo el orden de preferencia. */
+async function ensureToken() {
+  if (TOKEN) return TOKEN;
+  // 2) token guardado de un device-flow anterior (atado a esta API).
+  const guardado = loadToken(API_URL);
+  if (guardado) { TOKEN = guardado; usandoDeviceFlow = true; return TOKEN; }
+  // 3) login legado por email/contraseña (compatibilidad).
+  if (EMAIL && PASSWORD) return login();
+  // 4) device-flow interactivo (a menos que se deshabilite explícitamente).
+  if (NO_AUTH_PROMPT) {
+    throw new Error("No hay token. Ejecutá `npx nexusflex-mcp login` para autorizar, o definí NEXUSFLEX_TOKEN.");
+  }
+  return autorizarPorDeviceFlow();
+}
+
+/** Llamada autenticada a la API. Reintenta UNA vez si el token venció/se revocó. */
+export async function api(method, path, body) {
+  guard(path);
+  let token = await ensureToken();
+  const doFetch = (t) =>
+    fetch(`${API_URL}${path}`, {
+      method,
+      headers: { "Content-Type": "application/json", Authorization: `Bearer ${t}` },
+      body: body != null ? JSON.stringify(body) : undefined,
+      signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
+    });
+
+  let r = await doFetch(token);
+  if (r.status === 401) {
+    if (EMAIL && PASSWORD && !usandoDeviceFlow) {
+      // Token JWT vencido: re-login por credenciales.
+      log("401: token vencido, reintentando login…");
+      token = await login();
+      r = await doFetch(token);
+    } else if (usandoDeviceFlow && !NO_AUTH_PROMPT) {
+      // Token de MCP inválido/revocado: limpiamos y re-autorizamos por device-flow.
+      log("401: el token de MCP no es válido (revocado/vencido). Re-autorizando…");
+      clearToken();
+      TOKEN = "";
+      token = await autorizarPorDeviceFlow();
+      r = await doFetch(token);
+    }
+  }
+
+  const text = await r.text();
+  let data = null;
+  try {
+    data = text ? JSON.parse(text) : null;
+  } catch {
+    data = text;
+  }
+  log(`${method} ${path.split("?")[0]} -> ${r.status}`);
+  return { ok: r.ok, status: r.status, data };
+}