安装¶

作为 Claude 插件（推荐）¶

/plugin marketplace add Transgenia/MCP-Odoo-Tools-CE-EE-and-online
/plugin install odoo-tools
/odoo-tools:odoo-setup-mcp

插件的 mcpServers 条目通过以下命令启动服务器：

uvx --from ${CLAUDE_PLUGIN_ROOT}/server odoo-mcp

这样，uv 会从源代码构建并运行打包好的服务器 ——不需要在 PyPI 上发布。

直接运行 MCP 服务器¶

# 使用 uv（推荐；自带 Python）
uvx --from ./server odoo-mcp

# 或从 checkout 使用你自己的 Python 3.11+
cd server && pip install -e . && python -m odoo_mcp

要求¶

MCP 服务器： uv/uvx（自带 Python），或使用 Python 3.11+ 从 server/ 运行 python -m odoo_mcp。
备用 CLI（可选）： Node.js 18+。

可选附加项¶

pip install -e "./server[cache]"    # 带 TTL 的模式缓存（cachetools）
pip install -e "./server[metrics]"  # /metrics 上的 Prometheus 指标
pip install -e "./server[otel]"     # OpenTelemetry 追踪（OTLP）

附加项永远不会阻塞启动：如果未安装，这些能力只会保持未激活状态（优雅降级）。

配置（环境变量）¶

变量	是否必需	说明
`ODOO_URL`	是	`https://host`（不带结尾路径）
`ODOO_DB`	是	数据库名称
`ODOO_LOGIN`	是	登录邮箱
`ODOO_API_KEY`	是*	Odoo ≥ 14；在 Account Security 中创建
`ODOO_PASSWORD`	是*	在 Odoo < 14 中使用（无 API keys）
`ODOO_TRANSPORT_PREF`	否	`auto`（默认）/ `jsonrpc` / `xmlrpc`
`ODOO_TIMEOUT`, `ODOO_CACHE_TTL`	否	整数（秒）
`ODOO_METRICS`, `ODOO_OTEL_ENDPOINT`	否	可选的可观测性

* 你必须定义 ODOO_API_KEY 或 ODOO_PASSWORD 其中一个。

凭据保留在你的环境中；没有任何内容会发送给 Anthropic，插件也不会将其持久化 到磁盘。

备用 CLI（可选）¶

/odoo-tools:odoo-setup-cli

需要 Node.js 18+。它会将 CLI 安装到 ~/.claude/tools/odoo-cli。命令详情见备用 CLI 页面。

Docker（HTTP 传输，可选）¶

仓库的 docker/ 目录包含一个多租户 HTTP 部署示例，其中客户端通过 X-Odoo-Url/Db/Login + Bearer 请求头传递信息。

验证¶

调用 odoo_version 工具（或运行 /odoo-tools:odoo-doctor）。一个成功的、报告了版本、版本类型、部署方式和传输方式的响应，即可确认端到端的安装。参见连接与发现。