跳转至

商业支持

MCP-Odoo-Tools 是一个 开源（MIT） 项目：你可以按照本手册自行安装、配置并运行它。

从这里开始

在 Claude Code 中运行 /odoo-tools:odoo-setup-mcp：涵盖配置、验证、培训、日常使用与部署的引导路线。没有可练习的 Odoo？/odoo-tools:deploy-local 会启动一个本地沙箱。/odoo-doctor 会检查现有的连接。

你在使用 Cowork 或 Claude chat？

Odoo 工具不会在那里运行：插件的 skills 和命令会加载，但这些应用不会启动它的 MCP 服务器，也没有填写连接选项的表单。你的账户、你的 Odoo 和你的 Python 都没有问题。如果 Claude 或应用把本插件的服务器显示为 not_started、原因为 user_config_unsupported，那就是这种情况，不是错误，任何更新都不会改变它。请打开 Claude Desktop 的 Code 标签页中的本地会话（或在终端、VS Code 或 JetBrains 中使用 Claude Code）：你安装在 Claude 账户上的插件，会在你用同一账户登录后作为同步插件出现在那里。Code 标签页的云端会话也不行，原因不同：你的连接选项留在你的电脑上。也可以请 Transgenia 提供协助配置（见下文）。参见 适用环境。

如果出现问题：支持报告

运行 /odoo-tools:odoo-doctor。它先检查 Odoo 工具是否在你所在的地方运行，再检查连接（在 Claude Code 中，还会检查是哪个 odoo-tools 副本作出响应，以及是否存在第二个副本或早于 1.5.0 的副本；参见 两个 odoo-tools 副本），最后给出一份可以发给 Transgenia 的支持报告。报告中不含 API key、密码、URL、登录名或记录数据。

  • 在 Claude Code 中，doctor 通过 python3 <插件文件夹>/server/run_stdio.py --diagnose 生成报告，它只读取插件本地的诊断和审计文件，不联系任何服务。
  • 在 Cowork 中，Claude 的命令运行在一台虚拟机里，而不是你的电脑上，因此 doctor 根据插件的会话开始 hook 留给 Claude 的那一行来写报告（Cowork 会在你自己的电脑上运行插件的 hooks）：环境、启动会话的应用、MCP 服务器的最后状态以及诊断文件所在的文件夹。
  • 在 Claude chat 中，插件的 hooks 不会运行，因此报告只写明所在的环境。
  • 在 Cowork、Claude chat 或云端会话中，如果应用为本插件的服务器显示了状态和原因（例如 not_started 和 user_config_unsupported），doctor 会把它们按原样、连同应用的版本加入报告：它们用来确认所在的环境，而不是需要修复的故障。

在 Claude Code 中，报告看起来是这样的（有删节）。它包含各个版本、诊断文件夹（你的主文件夹显示为 ~）、重新按允许清单检查过的服务器和 hook 的最近事件、最近 7 天按状态和拒绝规则统计的审计计数、服务器上次启动时加载的策略，以及根据该命令自身环境离线计算出的策略（该环境没有插件的选项，因此会单独标明）：

odoo-tools support report (no keys, URLs, logins or record data)
plugin: 1.6.0
python: 3.12.4
os: Darwin 24.6.0 arm64
diagnostics folder: ~/.claude/plugins/data/<plugin id>/diagnostics (exists)
last 5 server events (server.jsonl):
  {"v":1,"ts":"2026-10-30T15:02:11Z","event":"start","pid":4242,"plugin":"1.6.0",...,"settings":{"url":true,"db":true,"login":true},"credential":"api_key","audit":"file","entrypoint":"cli"}
  {"v":1,"ts":"2026-10-30T15:02:14Z","event":"connect","pid":4242,"ok":true,"transport":"json2","odoo_major":19,"edition":"enterprise","deployment":"saas"}
last 3 hook events (hook.jsonl):
  {"v":1,"ts":"2026-10-30T15:02:10Z","event":"session_start","source":"startup",...,"entrypoint":"cli","server_last":"ok","age_h":20,"container":false}
audit, last 7 days: 2 files, 41 calls; by status: ok 39, refused 2; refusals by rule: profile:standard 2
policy at the server's last start: profile standard, digest 21524d1933f3, locked no
policy computed offline from this command's environment (the plugin's options may differ; never contacts Odoo): profile standard, digest 21524d1933f3, locked no, policy file no, read-only no

报告背后的文件留在你的电脑上，位于插件数据文件夹的 diagnostics 文件夹中。在 Claude Code 中，它是 ~/.claude/plugins/data/<插件 ID>/diagnostics/（在 Windows 上为 %USERPROFILE%\.claude\plugins\data\<插件 ID>\diagnostics\）；在 Cowork 中，doctor 会按会话开始 hook 报告的位置告诉你这个文件夹。这些文件只保存元数据（启动了什么、在哪个环境、出现了哪类错误），从不保存值，插件也从不把它们发送到任何地方。如果支持团队需要，请把它们附在你的邮件中。参见 隐私。

Transgenia 的服务

如果你更希望有人陪伴实施，Transgenia 提供 AI 与 Odoo 的实施服务：

  • 诊断你的实例（版本、版本类型、模块、可用 AI 自动化的候选流程）。
  • 在触碰生产数据之前，进行连接与只读试点。
  • 写入治理（在创建/修改记录之前进行人工审查）。
  • Odoo、AI 智能体与你现有系统之间的定制集成。
  • 插件及你的 Odoo 连接的维护与支持。
  • 按角色（销售、会计、库存、管理层）为你的团队提供培训。
  • 协助部署到生产环境：托管、安全、Odoo 版本间迁移以及多用户上线。

Transgenia 是 Anthropic 注册合作伙伴（Registered 层级），并在其自有生产环境中运行受治理的 AI 智能体。我们在医疗健康与 B2B 领域拥有可验证的实施案例。

联系方式

官方渠道

请仅通过以下渠道联系 Transgenia：

Transgenia 绝不会通过聊天或邮件向你索要 Odoo API key 或密码。

插件在哪些时刻提示

自 v1.3.0 起，插件只在有帮助的时刻提及这些渠道，而不是在每个回答中：

  • Odoo 工具无法在你所在的地方运行时（Cowork 或 Claude chat）：会话开始 hook 和 /odoo-tools:odoo-doctor 会为你提供 Claude Desktop 的 Code 标签页中的本地会话，然后是 Transgenia 的协助配置；
  • 配置受阻时（凭据、认证或传输错误，以及 /odoo-doctor 检查失败时）；
  • 引导路线 的培训结束时；
  • 本地沙箱 与部署阶段结束时；
  • 当你请求维护、支持、培训、定制或部署帮助时。

错误与功能请求

请在 仓库 中提交一个 issue，附上插件版本、Odoo 的版本和版本类型，以及 /odoo-tools:odoo-doctor 的支持报告（其中不包含凭据）。对于安全漏洞，请按照 安全 中的说明操作。

项目资源

品牌诚信

Transgenia 是 Anthropic 的 注册 合作伙伴。本插件是一个独立的开源项目；它不是 Anthropic 的认证产品或第一方产品。它已在 Anthropic 的插件目录中上架；每个新版本须经 Anthropic 审核员批准后才会进入目录，因此目录提供的版本可能早于本手册所述的版本。