故障排查与常见问题¶
以问题形式呈现的标题，便于你快速找到自己的场景。
为什么我的 API key 在 Odoo 17 或更高版本中不再起作用？¶
从 Odoo 17 起，/jsonrpc 端点 会拒绝 API keys。服务器会检测到这一点，
并自动 回退 到 XML-RPC（在第一次回退后固定为 XML-RPC，并提示一次）。
你无需做任何事；如果你想强制它，请设置
ODOO_TRANSPORT_PREF=xmlrpc。
我收到 "database not found"¶
数据库名称不正确。请在 Settings → Database 或登录 URL 中核对它。
ODOO_DB 必须完全匹配。
某个字段出现在 dropped_fields 中，而不在结果里¶
该字段 在目标版本中不存在。这是预期行为：服务器不会让整个查询失败，
而是丢弃不可用的字段并将其报告出来。请查阅 兼容性 表格，
找到等价的现代名称（例如在 v16 中 analytic_account_id →
analytic_distribution）。
我得到一个关于某个 Enterprise 模型的 CompatError¶
你正在针对一个被检测为 Community 的实例查询一个 Enterprise 专属模型
（例如 helpdesk.ticket、sign.request）。运行时的模块探测是权威依据：
如果该模块未安装，则该模型不可用。
我需要 API key，还是可以使用密码？¶
- Odoo ≥ 14：使用 API key（推荐），变量
ODOO_API_KEY。 - Odoo < 14：没有 API keys；使用
ODOO_PASSWORD。
定义两者中的 一个。
uvx 未安装¶
安装 uv（官方指南）
或直接使用 Python 3.11+：cd server && pip install -e . && python -m odoo_mcp。
我没有 Python，只有 Node¶
使用 备用 CLI：/odoo-tools:odoo-setup-cli（Node.js 18+）。
我如何验证一切都没问题？¶
运行 /odoo-doctor 或调用 odoo_version。一个包含版本、版本类型、
部署方式和传输方式的响应即可确认端到端的连接。参见
连接与发现。
我公司的数据会发送给 Anthropic 吗？¶
不会。服务器运行在你的基础设施上，并直接与你的 Odoo 通信。 参见 安全。
除了 Claude，它能与其他智能体一起工作吗？¶
可以：能与任何实现了 MCP 协议的客户端一起工作。Claude Code 是本插件所打包 面向的参考环境。