Odoo Mcp Server

    

odoo-mcp-pro

面向 Odoo ERP 的 AI 连接器——使用自然语言与业务数据交互。
搜索、创建、更新和管理记录——只需开口提问。

跳过配置。 托管版本只需 5 分钟即可启动并运行——提供自动更新、托管 OAuth 和加密的 API 密钥。从 pantalytics.com 开始 →

---

核心理念

Odoo 功能强大，AI 也功能强大。两者结合更胜一筹。

odoo-mcp-pro 是一款面向 Odoo 的 AI 连接器，使用 MCP（模型上下文协议）——这是一种开放标准，可让 AI 助手与外部系统交互。它将 AI 助手连接到你的 Odoo ERP，让你可以通过自然语言访问业务数据。它不会取代 Odoo 的界面，而是提供第二种界面，让许多任务完成得更快。兼容 Claude、ChatGPT、Cursor、Windsurf 以及任何其他兼容 MCP 的 AI 工具。

“显示第四季度金额超过 5,000 EUR 的所有未付款发票”——AI 会直接查询你的 Odoo 实例并返回结果。

根据任务选择合适的界面。 复杂配置？使用 Odoo 界面。快速查询数据、批量提问或即时创建记录？直接问你的 AI。

你可以做什么

• “查找阿姆斯特丹所有有未完成报价单的联系人”
• “为 Acme Corp 创建一条销售线索，预期收入为 50k EUR”
• “上个月的哪些销售订单还没有交货？”
• “sale.order 模型有哪些字段？”
• “将商机 #42 的预计成交日期更新为下周五”

适用于任何 Odoo 模型——销售、发票、联系人、库存、CRM、人力资源等。

想立即试用？ 跳过配置——托管版本不到 5 分钟即可连接到你的 Odoo。从 pantalytics.com 开始 →

开始使用

托管版（推荐）

最快、最安全的入门方式。 我们为你运行服务——注册账号，粘贴 Odoo URL + API 密钥，完成。

• 5 分钟即可运行。 无需安装、无需 Docker、无需基础设施。可与 Claude、ChatGPT、Cursor、Windsurf 及任何兼容 MCP 的 AI 工具配合使用。
• 始终保持最新。 安全补丁、Odoo 版本兼容性和新的 MCP 功能都会自动上线——你无需进行升级。
• 默认更安全。 API 密钥加密（AES-128）、托管式 OAuth 2.1、持续监控、欧洲基础设施。那些枯燥却至关重要的工作由我们负责，你无需操心。

1. 在 pantalytics.com 注册
2. 登录并输入 Odoo URL + API 密钥（如何生成密钥）
3. 将 MCP 服务添加到你的 AI 工具中（Claude、ChatGPT、Cursor 等）
4. 开始提问

你的数据始终保留在 Odoo 中——该服务是无状态代理。API 密钥在静态存储时会加密。

从 pantalytics.com 开始 →

自托管

在你自己的机器上运行。仅支持单租户：一个 Odoo 实例，通过环境变量配置。身份验证使用你的 Odoo API 密钥——不支持 OAuth、用户管理或管理界面。

# Install
pip install "mcp-server-odoo @ git+https://github.com/pantalytics/odoo-mcp-pro.git"

# Run (stdio mode, for Claude Desktop / Claude Code)
ODOO_URL=https://mycompany.odoo.com ODOO_API_KEY=your_key python -m mcp_server_odoo

# Run (HTTP mode, for remote access from one trusted network)
ODOO_URL=https://mycompany.odoo.com ODOO_API_KEY=your_key \
  python -m mcp_server_odoo --transport streamable-http --host 0.0.0.0 --port 8000

HTTP 模式没有内置身份验证——请将其置于反向代理之后，或在网络层面限制访问。

或者添加到你的 Claude Desktop claude_desktop_config.json：

{
  "mcpServers": {
    "odoo": {
      "command": "python",
      "args": ["-m", "mcp_server_odoo"],
      "env": {
        "ODOO_URL": "https://mycompany.odoo.com",
        "ODOO_API_KEY": "your_api_key_here"
      }
    }
  }
}

需要多租户、按用户配置连接、OAuth 或管理界面？ 这属于 SaaS 范畴。托管版设置更快、自动更新，并会为你处理安全补丁——成本也低于你自行托管所耗费的时间。这些功能位于独立的商业软件包中，该软件包基于这个开放核心服务构建。

工作原理

odoo-mcp-pro 是一个 Odoo 连接器，实现了 MCP（Model Context Protocol）——这是一项开放标准，让 AI 助手能够调用外部工具。它提供以下工具，AI 可根据你的问题调用：

工具	功能
record_search	使用域筛选、排序和分页搜索任意模型
record_get	通过 ID 获取指定记录，并智能选择字段
record_aggregate	在 Odoo 中计算分组汇总（read_group）：按产品、月份等求和、平均值、计数
record_export	将大量记录导出为精简 CSV（Odoo 的导出功能），支持 order_id/partner_id/city 这类关联路径
model_list	发现可用的 Odoo 模型
resource_template_list	发现可用的资源 URI 模板
record_create / records_create	创建一条或多条记录
record_update / records_update	更新一条或多条记录
record_delete / records_delete	删除一条或多条记录
record_import	通过外部 ID 进行幂等式更新或插入（与 Odoo CSV 导入相同）
server_info_get	获取服务版本和连接状态

支持 Odoo 14-20——Odoo 19 及更高版本使用 JSON/2 API，较旧版本使用 XML-RPC。系统会自动选择合适的协议。

安全

• Odoo 才是主导者。 所有数据、权限和业务逻辑都保存在 Odoo 中。每位用户的 API key 决定其可以查看和执行的操作——ACL 和记录规则照常生效。
• 无状态代理。 MCP 服务不会存储或缓存你的业务数据。
• 静态加密 API key，使用 AES-128（Fernet）。绝不会向 AI、浏览器或日志公开。
• 由你掌控。 随时在 Odoo 中撤销 API key，即可立即切断访问。
• 发现漏洞？ 请发送邮件至 [email protected]，并参阅 SECURITY.md。报告者会在变更日志中获得署名。

倾向于托管安全服务？ 托管版本会负责补丁、OAuth 令牌轮换和事件监控——你的数据仍保留在 Odoo 中，我们只为你运行代理。

开发

uv venv --python 3.10
source .venv/bin/activate
uv pip install -e ".[dev]"
pytest tests/ -q
ruff check . && ruff format .

技术详情请参阅 architecture.md，编码规范请参阅 CLAUDE.md。

贡献

欢迎贡献。Fork 此仓库，创建功能分支，运行 pytest tests/ 和 ruff check .，然后提交 PR。

常见问题

支持哪些 Odoo 版本？ Odoo 14-20。服务会自动检测使用 JSON/2（Odoo 19+）还是 XML-RPC（14-18）。无需配置。

可以在手机上使用吗？ 可以——托管版本可用于 Claude 移动版（iOS/Android）、任何浏览器中的 Claude.ai、Claude Desktop、Claude Code 和 ChatGPT。本地安装（STDIO）只能在安装它的设备上使用。

我的数据安全吗？ 你的数据保留在 Odoo 中。MCP 服务是无状态代理——不会存储或缓存业务数据。API key 使用 AES-128（Fernet）进行静态加密。每位用户的 Odoo 权限都会生效：你只能查看和执行 Odoo 角色允许的操作。

所有模型都显示“拒绝访问” 这通常意味着你的 Odoo API key 没有相应权限。请尝试：

1. 在 Odoo 中重新生成 API key（Settings > Users > API Keys），并在配置它的位置更新（托管版：/admin/setup；自托管：ODOO_API_KEY 环境变量）
2. 确保你的 Odoo 用户至少拥有要查询模型的读取权限
3. 如果使用 Odoo.sh，请确认你的订阅套餐支持 JSON/2 API

托管版本提示“需要身份验证”或“invalid_token” 这表示 AI 工具与 MCP 服务之间的 OAuth 连接失败。请尝试在 AI 工具的设置中断开并重新连接 MCP 服务。自托管安装不会使用 OAuth，而是直接通过 Odoo API key 进行身份验证。

需要设置 ODOO_DB 吗？ 只有在自托管 Odoo 且使用多个数据库时才需要。Odoo.sh 和 Odoo Online 无需设置——主机名会决定数据库。

应该使用托管版还是自托管版？ 除非有充分理由，否则请使用托管版。托管版可在 5 分钟内运行，每次 Odoo 发布时都会自动更新，并提供托管 OAuth 和加密 API key。自托管仅支持单租户（一个 Odoo 实例、API key 身份验证、没有管理界面），补丁和安全维护则由你负责。从 pantalytics.com 上的托管版开始 →

许可证

本项目采用双重许可：

• 源自 Andrey Ivanov 的原始项目 mcp-server-odoo 的文件继续采用Mozilla Public License 2.0（LICENSE.MPL-2.0）。这些文件带有 SPDX-License-Identifier: MPL-2.0 标头，并在 NOTICE 中列出。
• 其他所有内容——即 Pantalytics 在此基础上添加的代码——均采用**Elastic License 2.0**。

对于采用 Elastic License 的部分，简单来说：

• 您可以使用、复制、修改和分发本软件——包括用于您自己的商业用途（在您自己的公司、Odoo 实例和项目中运行）。
• 您不得将其作为托管或管理服务提供给第三方，并让他们使用其大量功能——Pantalytics 提供的正是这种服务，许可证旨在对此加以保护。
• 您不得移除许可证声明或规避许可证密钥功能。

采用 Elastic License 的部分可获取源代码，但并非 OSI 认可的开源软件。完整信息请参阅 LICENSE、LICENSE.MPL-2.0 和 NOTICE。

面向 Odoo 实施合作伙伴

想为客户提供 AI 驱动的 Odoo？根据 Elastic License 2.0，不允许您为客户运行自己托管的 odoo-mcp-pro 版本。我们设有合作伙伴计划，并提供推荐佣金：您向终端用户推荐 odoo-mcp-pro，他们通过您的推荐链接注册，您即可获得持续佣金。您无需负责托管或维护。

感兴趣？请联系 [email protected] 了解详情。

由 Pantalytics 构建

odoo-mcp-pro 由位于荷兰乌得勒支的 Odoo 实施合作伙伴 Pantalytics 构建并维护。

本项目最初从 Andrey Ivanov 的 mcp-server-odoo 分叉而来。源自该项目的文件继续采用 Mozilla Public License 2.0；请参阅 NOTICE。

---

_{Odoo 是 Odoo S.A. 的注册商标。MCP 徽标依据 MIT License 使用。本项目与 Odoo S.A. 或 Anthropic 无关联，也未获其认可。}