Privacidad¶

Name: MCP-Odoo-Tools
Author: Transgenia (Centrum Transgenia SAS)

Última actualización: 2026-10-29. Aplica al plugin de Claude odoo-tools (servidor MCP, CLI de respaldo, skills, comandos, agentes y hooks).

Editor: Transgenia (Centrum Transgenia SAS), dev@transgenia.org. Aviso de privacidad corporativo: https://transgenia.org/legal-privacidad.html (versión en inglés).

La política completa vive en el repositorio: PRIVACY.md.

Novedades en v1.5.1

Diagnóstico local: dos archivos pequeños en tu equipo, solo metadatos, para que soporte pueda saber qué pasó cuando algo falla. Nunca salen de tu equipo salvo que tú envíes el reporte de soporte. Ver Almacenamiento local.
El hook de inicio de sesión ya no lee ninguna opción del plugin, ni credenciales ni el archivo de política: solo la carpeta de datos del plugin y el nombre de la app de Claude que inició la sesión.
El servidor MCP solo lee las credenciales que le pasan las opciones del plugin, y solo las envía a la URL de Odoo que configuraste.

Novedades en v1.5.0

Registro de auditoría local: una línea por llamada a herramienta, con nombres, conteos y tiempos, sin datos de registros ni secretos. Ver Almacenamiento local.
El hook de inicio de sesión revisa también las dos opciones de la política de permisos y guarda un segundo archivo de marca de tiempo.
La política de permisos puede retener campos personales (fields.withhold).

Resumen¶

El plugin corre en tu equipo. Transgenia no opera ningún servidor para él y no recibe, no hace de proxy ni retiene datos de él: ni tus credenciales, ni tus registros de Odoo, ni tus prompts.
El plugin lee datos personales que viven en tu Odoo (nombres de contactos, correos, direcciones, etc.) cuando tú o tu agente lo piden. No guarda su propia copia de esos datos.
Guarda en tu equipo un diagnóstico pequeño, solo metadatos, para que soporte pueda saber qué pasó cuando algo falla. Nunca sale de tu equipo salvo que tú lo envíes.

Qué datos se procesan y a dónde van¶

Dato	A dónde va	Para qué
URL, base de datos, login, API key / contraseña de Odoo	Claude Code los guarda como opciones del plugin; la API key y la contraseña son opciones `sensitive`, guardadas en el almacén seguro de credenciales del sistema operativo. Se pasan al proceso local del servidor MCP, que solo las envía a la URL de Odoo que configuraste. Claude Code también exporta cada opción guardada al entorno de los procesos de hook del plugin; desde la v1.5.1 el hook del plugin no lee ninguna.	Autenticarse contra tu instancia de Odoo.
Registros de Odoo que consultas (pueden incluir datos personales)	Van de tu Odoo al servidor MCP local y de ahí a tu cliente MCP, que envía los resultados de las herramientas a tu proveedor de modelo (p. ej. Anthropic, para Claude), como con cualquier herramienta.	Responder a tu solicitud. Se rigen por los términos de tu Odoo y de tu proveedor de modelo, no por Transgenia.
Diagnóstico y reporte de soporte (solo metadatos)	Solo tu equipo, hasta que decidas enviar el reporte (ver Almacenamiento local).	Que soporte pueda saber qué pasó cuando algo falla.
Nada	Transgenia	No aplica

Servicios que contacta el plugin¶

Tu instancia de Odoo: la URL que configuras, por JSON-2 / JSON-RPC / XML-RPC, desde el servidor MCP (principal) o desde la CLI de respaldo opcional.
Registro de npm, solo para la CLI de respaldo opcional: el servidor MCP no descarga nada (no tiene dependencias de terceros; corre con python3 desde el código incluido en el plugin). Solo la CLI de respaldo opcional corre npm install contra el registro de npm cuando la configuras con /odoo-tools:odoo-setup-cli. No se envían datos de Odoo ni credenciales.
Opcional, apagado por defecto, configurado por el operador: un colector OTLP que tú definas en ODOO_OTEL_ENDPOINT, y un endpoint local de Prometheus (ODOO_METRICS). La telemetría (ODOO_TELEMETRY=opt-in) nunca envía nada por sí sola: solo genera un payload sin datos personales para que lo revises y lo compartas manualmente. Ver Seguridad.

Almacenamiento local¶

El servidor MCP no escribe credenciales ni registros en disco. Su caché de esquema vive en memoria.
Registro de auditoría (v1.5.0): el servidor MCP escribe una línea por llamada a herramienta, rechazos incluidos, en archivos diarios dentro de la carpeta de datos del plugin (~/.claude/plugins/data/…/audit, solo para tu usuario). Una línea guarda nombres de herramienta, modelo y operación, conteos, tiempos y el digest de la política; la base de datos y el login de Odoo aparecen solo en la línea que se escribe al arrancar el servidor. No guarda datos de registros, valores de argumentos, filtros, ids, la URL ni secretos. Los archivos se conservan 90 días y se borran con la carpeta de datos del plugin; en contenedores y ejecuciones standalone, ODOO_AUDIT_DIR=off no escribe ninguno.
Excepción, CLI de respaldo opcional: /odoo-tools:odoo-setup-cli crea un .env en ~/.claude/tools/odoo-cli, legible solo por tu usuario y con marcadores de posición; tú pegas ahí el secreto en tu propio editor (Claude nunca te lo pide en el chat), así que ese archivo guarda tus credenciales. Bórralo cuando dejes de usar la CLI.
Diagnóstico (v1.5.1): dos archivos pequeños en la carpeta diagnostics de la carpeta de datos del plugin (~/.claude/plugins/data/…/diagnostics, solo para tu usuario y nunca a través de un enlace simbólico), para que soporte pueda saber qué pasó cuando las herramientas de Odoo no funcionan:
- server.jsonl, que escribe el servidor MCP: cuándo arranca (las versiones del plugin, de Python y del sistema operativo; la preferencia de transporte, Read-only mode y el perfil de permisos; si hay URL, base de datos y login, nunca sus valores; si se usa una API key o una contraseña, nunca su valor), el resultado de su primera conexión (la versión, edición y despliegue de Odoo, o una categoría de error como auth o network con el estado HTTP), un fallo inesperado (el tipo de error y las líneas del código propio del plugin, nunca el mensaje) y cuándo se detiene (tiempo activo, número de llamadas a herramientas, errores por categoría);
- hook.jsonl, que escribe el hook de inicio de sesión: cuándo empieza una sesión, su id de sesión, qué app de Claude la inició, las versiones del plugin, de Python y del sistema operativo, y el último estado del servidor MCP.
No guardan URL, host, base de datos, login, API key, contraseña, ruta del archivo de política, datos de registros, filtros, ids, argumentos de herramientas ni el texto de un mensaje de error. Cada archivo rota a los 256 KiB y conserva un archivo anterior, y se borran con la carpeta de datos del plugin. Fuera del plugin (contenedores y ejecuciones standalone) solo se escriben si defines ODOO_DIAG_DIR; con off no se escribe ninguno. El plugin nunca los envía a ningún lado: /odoo-tools:odoo-doctor imprime con ellos un reporte de soporte, y tú decides si lo envías.
El hook SessionStart guarda archivos vacíos de marca de tiempo en la carpeta de datos del plugin (~/.claude/plugins/data/…) para que sus avisos se muestren como máximo una vez al día. Desde la v1.5.1 solo lee la carpeta de datos del plugin y el nombre de la app de Claude que inició la sesión: ninguna opción del plugin, credencial ni archivo de política, y nada fuera de las carpetas propias del plugin.

Retención¶

Transgenia no retiene ningún dato recibido de Claude ni de este plugin, porque no se le envía ninguno.

Tus opciones¶

Usa un usuario de Odoo de mínimo privilegio y activa Read-only mode en las opciones del plugin para exploración. La opción Permission profile (standard por defecto) y un archivo de política opcional acotan aún más lo que leen las herramientas: un archivo de política puede retener campos como los correos personales (fields.withhold, ver Política de permisos).
Revoca la API key en Odoo (Preferencias → Account Security) para cortar el acceso de inmediato. Desinstalar el plugin (/plugin) también borra su directorio de datos (~/.claude/plugins/data/…).
Borra la carpeta diagnostics de ese directorio de datos cuando quieras; el plugin empieza archivos nuevos en la siguiente sesión.

Contacto¶

Dudas de privacidad o seguridad: dev@transgenia.org.