elentra-local-connector

Un conector MCP privado, local y de solo lectura que permite a Claude Desktop buscar tus propios datos de uOttawa Elentra — reutilizando tu sesión autenticada de Chrome en lugar de almacenar credencial alguna.

Especificación: PRD-FINAL.md es la fuente autoritativa. Estado: solo lectura. write_enabled = false es una constante de compilación.

Qué significa «live» aquí

Razonablemente actual mientras el conector está activo — nunca una garantía de envío. Elentra no expone webhooks, ni WebSocket, ni SSE, por lo que esto sondea. El token de autenticación dura 60 minutos, así que lo normal es que esté desactualizado; cada respuesta de herramienta incluye fetched_at, is_stale y staleness_seconds para que Claude diga «desde hace 3 horas» en lugar de dar a entender una verdad en tiempo real.

Arquitectura

Chrome MV3 extension   has the session · owns the allowlist · GET only
        │              no chrome.cookies · no chrome.scripting
        ▼  native messaging
relay                  thin, stateless, ~100 LOC
        │  unix socket (0600)
        ▼
daemon (launchd)       sole DB writer · parsers · ICS poller · audit
        │  direct SQLite read-only (WAL)
        ▼
mcp-server (stdio)     read-only tools → Claude Desktop

Cuatro procesos, deliberadamente. Chrome lanza un host de mensajería nativa como proceso hijo, por lo que un demonio que es ese host moriría con Chrome — matando el sondeo ICS desatendido — y se relanzaría en cada reinicio del service worker, produciendo dos escritores contra una base de datos WAL que solo permite uno. El relé cuesta ~100 líneas sin estado y elimina ambos problemas.

Configuración

La compilación está automatizada; el cableado no. Consulta docs/HANDOFF.md — unos 10 minutos de pasos de Chrome y macOS que no se pueden automatizar con scripts.

pnpm install
pnpm bootstrap  # build, keys, index, daemon, health — idempotent, re-runnable

pnpm bootstrap hace todo lo que se puede automatizar e informa de lo que queda. Los pasos individuales, si prefieres ejecutarlos tú mismo:

pnpm verify     # typecheck + lint + test + secret scan — the gate
pnpm build      # four bundles: mcp, daemon, relay, extension
pnpm build:mcpb # the Claude Desktop .mcpb — separate from pnpm build
pnpm health     # live diagnostics, after handoff

pnpm install && pnpm verify se ejecuta completamente sin conexión: los fixtures son sintéticos, y tests/no-network.setup.ts reemplaza fetch con un lanzador de errores, de modo que cualquier prueba que intente acceder a la red falla en lugar de tener éxito silenciosamente.

Garantías

• Nunca almacena tu contraseña; no existe ninguna ruta de código que maneje contraseñas.

• Nunca exporta cookies del navegador.

• Nunca automatiza el inicio de sesión, MFA ni la renovación de SSO — al caducar se detiene y te lo dice.

• Nunca expone una herramienta genérica request(method, url) al modelo.

• El repositorio contiene solo código; los fixtures son 100% sintéticos.

Consulta SECURITY.md para los invariantes y PRIVACY.md para lo que llega a Anthropic.

Licencia

MIT — consulta LICENSE.