hub-mcp

Servidor MCP para interactuar con la plataforma HUB de Logica Mobile. Tu agente de IA puede buscar dispositivos GPS, vehículos, grupos, zonas, reportes de combustible y rendimiento, evidencias de carga, datos CAN bus, cuentas/usuarios y fallas diagnósticas.

Requisitos

• Node.js >= 18 y npm
• Una cuenta activa en HUB y un cliente OAuth registrado para hub-mcp (tu admin de HUB te da el client_id y client_secret)
• Un cliente compatible con MCP: opencode, Claude Code / Desktop, Codex o Cursor

Instalación

npm install -g @luis-logica/hub-mcp-v1

Para actualizar una versión previa: npm update -g @luis-logica/hub-mcp-v1.

Activación (una sola vez por máquina)

Corre hub-mcp en una terminal y sigue el menú (imprime un resumen ✓/✗ de lo que falta):

1. Dominio HUB — host de tu servidor HUB (o define HUB_DOMAIN).
2. Credenciales OAuth — client_id + client_secret (o HUB_OAUTH_CLIENT_ID / HUB_OAUTH_CLIENT_SECRET).
3. Identificarse — se imprime una URL + código de un solo uso; ábrelos y autoriza. La sesión se guarda en ~/.hub-mcp/ y se renueva sola.
4. Configurar cliente — elige tu cliente (opencode / Claude / Codex / Cursor) y el script escribe la entrada hub-mcp en su config (con backup). Reinicia el cliente.

Para scripts: hub-mcp --activate (no interactivo; requiere dominio y credenciales ya configurados).

Configurar el cliente MCP manualmente

opencode (opencode.json o opencode.jsonc, de proyecto o en ~/.config/opencode/):

{ "mcp": { "hub-mcp": { "type": "local", "command": ["hub-mcp"], "enabled": true } } }

Claude Desktop / Claude Code / Cursor:

{ "mcpServers": { "hub-mcp": { "command": "hub-mcp" } } }

Codex (~/.codex/config.toml):

[mcp_servers.hub-mcp]
command = "hub-mcp"

Si el binario no está en el PATH (p. ej. instalado con nvm), usa la ruta absoluta al binario o ["node", "/ruta/al/paquete/dist/index.js"].

Variables de entorno (todas opcionales)

| Variable | Descripción | | --- | --- | | HUB_DOMAIN | Dominio del servidor HUB (también configurable desde el menú). | | HUB_OAUTH_CLIENT_ID / HUB_OAUTH_CLIENT_SECRET | Credenciales OAuth (también configurables desde el menú). | | HUB_DEBUG | true o 1 para trazas de depuración (sin credenciales). | | HUB_STATE_DIR | Directorio de sesión y config. Por defecto ~/.hub-mcp. | | HUB_OAUTH_SCOPE | Scopes solicitados en la activación. Por defecto common fuel deviceIo manage diagnosis. | | HUB_SKIP_UPDATE_CHECK | Si está definida, desactiva la verificación de actualizaciones. |

Actualizar

npm update -g @luis-logica/hub-mcp-v1

La sesión y credenciales persisten: no hay que reactivar (salvo que roten las credenciales OAuth).

Aviso automático: hub-mcp verifica una vez al día (caché de 24 h) si hay una versión más nueva publicada en npmjs. Si la hay, imprime en el log [ACTUALIZACIÓN] Nueva versión disponible: hub-mcp vX.Y.Z… al arrancar o abrir el menú. Tu agente también puede consultarlo en vivo con el tool get-server-status. La verificación es silenciosa ante fallos de red y se desactiva con HUB_SKIP_UPDATE_CHECK.

Desinstalar

npm uninstall -g @luis-logica/hub-mcp-v1
rm -rf ~/.hub-mcp   # opcional: borra sesión y credenciales locales

Para revocar el acceso: HUB → Configuración → Aplicaciones conectadas → hub-mcp → Revocar.

FAQ

1. hub-mcp se queda "colgado" cuando lo corro a mano. Correcto: sin terminal actúa como servidor MCP (lo lanza tu cliente de IA); con terminal abre el menú interactivo.

2. Mi agente no ve el MCP. Falta declararlo en la config del cliente (menú → 4) Configurar cliente, o la sección manual de arriba). Reinicia el cliente después.

3. Los tools fallan con error de autorización. La sesión expiró o nunca se activó: hub-mcp → 3) Identificarse, o pídele a tu agente get-auth-status / get-activation-url.

Licencia

© 2026 Logica Mobile. Todos los derechos reservados. Este software no es de código abierto: su uso está sujeto a autorización expresa de Logica Mobile. Queda prohibida su reproducción, distribución, modificación o creación de obras derivadas sin consentimiento previo por escrito. Consulta el archivo LICENSE para el texto completo.