隐私¶
最后更新:2026-10-29。适用于 odoo-tools Claude 插件(MCP 服务器、备用 CLI、skills、命令、智能体和 hooks)。
发布方:Transgenia(Centrum Transgenia SAS),dev@transgenia.org。公司隐私声明:https://transgenia.org/zh/legal-privacy.html。
完整政策位于仓库中:PRIVACY.md。
v1.5.1 新增
- 本地诊断: 你电脑上的两个小文件,只含元数据,让支持团队能在出现问题时了解发生了什么。除非你发送支持报告,否则它们从不离开你的电脑。参见 本地存储。
- 会话开始的 hook 不再读取任何插件选项,也不读取凭据或策略文件:只读取插件的数据文件夹以及启动会话的 Claude 应用的名称。
- MCP 服务器只读取插件选项传给它的凭据,并且只把它们发送到你配置的 Odoo URL。
v1.5.0 新增
概要¶
- 插件运行 在你的机器上。Transgenia 不为其运营任何服务器,不接收、不代理、也不保留 来自它的任何数据:不包括你的凭据、你的 Odoo 记录,也不包括你的提示词。
- 当你或你的智能体提出请求时,插件会 读取 存在于你 Odoo 中的个人数据(联系人姓名、邮箱、地址等)。它不会保留这些数据的副本。
- 它会在你的电脑上保存少量只含元数据的诊断信息,让支持团队能在出现问题时了解发生了什么。除非你自己发送,否则这些信息从不离开你的电脑。
处理哪些数据,以及数据去向¶
| 数据 | 去向 | 用途 |
|---|---|---|
| Odoo URL、数据库、登录名、API key / 密码 | 由 Claude Code 作为插件选项保存;API key 和密码是 sensitive 选项,保存在操作系统的安全凭据存储中。它们会传给本地的 MCP 服务器进程,该进程只把它们发送到你配置的 Odoo URL。Claude Code 还会把每个已保存的选项导出到插件 hook 进程的环境中;自 v1.5.1 起,插件的 hook 不读取其中任何一个。 |
用于向 你的 Odoo 实例进行身份验证。 |
| 你查询的 Odoo 记录(可能包含个人数据) | 从你的 Odoo 发送到本地 MCP 服务器,然后返回给你的 MCP 客户端,客户端会像对待任何工具一样把工具结果发送给你的模型提供方(例如 Claude 背后的 Anthropic)。 | 用于响应你的请求。受你的 Odoo 和你的模型提供方的条款约束,而非 Transgenia。 |
| 诊断与支持报告(只含元数据) | 只在你的电脑上,直到你决定发送报告(参见 本地存储)。 | 让支持团队能在出现问题时了解发生了什么。 |
| 无 | Transgenia | 不适用 |
插件会联系的服务¶
- 你的 Odoo 实例:你配置的 URL,通过 JSON-2 / JSON-RPC / XML-RPC,由 MCP 服务器(主要方式)或可选的备用 CLI 发起。
- npm 仓库,仅用于可选的备用 CLI:MCP 服务器 不下载任何东西(它没有第三方依赖;直接用
python3运行插件中随附的源代码)。只有可选的备用 CLI 会在你用/odoo-tools:odoo-setup-cli配置它时,针对 npm 仓库运行npm install。不会发送任何 Odoo 数据或凭据。 - 可选,默认关闭,由运维方配置: 你在
ODOO_OTEL_ENDPOINT中设置的 OTLP 收集器,以及本地的 Prometheus 端点(ODOO_METRICS)。遥测(ODOO_TELEMETRY=opt-in)本身从不发送任何内容:它只会生成一份不含个人身份信息的负载,供你审阅并手动分享。参见 安全。
本地存储¶
- MCP 服务器不会将凭据或记录写入磁盘。其模式缓存位于内存中。
- 审计日志(v1.5.0): MCP 服务器为每次工具调用(包括被拒绝的调用)写一行,写入插件数据文件夹中的每日文件(
~/.claude/plugins/data/…/audit,仅你的用户可访问)。一行保存工具、模型和操作的名称、计数、耗时和策略摘要;Odoo 的数据库和登录名只出现在服务器启动时写入的那一行中。它不保存记录数据、参数值、过滤条件、id、URL 或密钥。这些文件保留 90 天,并随插件的数据文件夹一起删除;在容器和独立运行中,ODOO_AUDIT_DIR=off不写入任何文件。 - 例外,可选的备用 CLI:
/odoo-tools:odoo-setup-cli会在~/.claude/tools/odoo-cli下创建一个仅你的用户可读、带占位符的.env;由你自己在自己的编辑器中把密钥粘贴进去(Claude 绝不会在聊天中向你索取它),因此该文件会保存你的凭据。停止使用 CLI 时请将其删除。 -
诊断(v1.5.1): 插件数据文件夹的
diagnostics文件夹(~/.claude/plugins/data/…/diagnostics,仅你的用户可访问,且从不通过符号链接写入)中的两个小文件,让支持团队能在 Odoo 工具无法工作时了解发生了什么:server.jsonl,由 MCP 服务器写入:它何时启动(插件、Python 和操作系统的版本;传输方式偏好、Read-only mode 和权限配置档;是否设置了 URL、数据库和登录名,从不记录它们的值;使用的是 API key 还是密码,从不记录它的值)、第一次连接的结果(Odoo 的版本、版本类型和部署方式,或者auth、network这样的错误类别及 HTTP 状态码)、一次意外崩溃(错误类型以及插件自身的代码行,从不记录消息内容),以及它何时停止(运行时长、工具调用次数、按类别统计的错误);hook.jsonl,由会话开始的 hook 写入:会话何时开始、它的会话 id、由哪个 Claude 应用启动、插件、Python 和操作系统的版本,以及 MCP 服务器的最后状态。
它们不保存 URL、主机、数据库、登录名、API key、密码、策略文件路径、记录数据、过滤条件、id、工具参数或错误消息文本。每个文件在 256 KiB 时轮换,并保留一个旧文件;它们会随插件的数据文件夹一起删除。在插件之外(容器和独立运行),只有设置了
ODOO_DIAG_DIR才会写入;设为off时不写入任何文件。插件从不把它们发送到任何地方:/odoo-tools:odoo-doctor会根据它们打印一份支持报告,由你决定是否发送。 -
SessionStarthook 会在插件的数据文件夹(~/.claude/plugins/data/…)中保存空的时间戳文件,让它的提示每天最多显示一次。自 v1.5.1 起,它只读取插件的数据文件夹以及启动会话的 Claude 应用的名称:不读取任何插件选项、凭据或策略文件,也不读取插件自身文件夹之外的任何内容。
保留¶
Transgenia 不保留 任何从 Claude 或本插件接收到的数据,因为根本没有数据发送给 Transgenia。
你的选择¶
- 使用最小权限的 Odoo 用户,并在探索时在插件选项中开启 Read-only mode。选项 Permission profile(默认
standard)和一个可选的策略文件会进一步限定工具读取的内容:策略文件可以屏蔽个人邮箱这样的字段(fields.withhold,参见 权限策略)。 - 在 Odoo 中撤销 API key(Preferences → Account Security)可立即切断访问。卸载插件(
/plugin)也会删除其数据目录(~/.claude/plugins/data/…)。 - 你随时可以删除该数据目录中的
diagnostics文件夹;插件会在下一次会话时创建新文件。
联系方式¶
隐私或安全问题:dev@transgenia.org。