Claude Connector for Odoo

Odoo 的 Claude 连接器：具备权限感知能力的 MCP 服务

将 Claude（网页版、桌面版或移动版）和其他 MCP 客户端连接到你的 Odoo 18 或 19 数据库，无需交出管理员密钥。

此模块可将你的 Odoo 转变为远程 Model Context Protocol (MCP) 服务。Claude 通过 OAuth 2.1，只需两步即可连接。每个请求都以一名指定的 Odoo 用户身份运行，并遵循该用户的访问权限，因此 AI 看到的内容与该用户在 Odoo 中能看到的完全一致，不多不少。

有何不同

	典型的 “Odoo AI” 设置	Odoo 的 Claude 连接器
身份	所有人共用一个管理员 API 密钥	每个令牌或 OAuth 授权都代表一位用户（with_user）
AI 能看到的内容	所有内容	仅限该用户的群组和记录规则允许访问的内容
写入	直接写入	默认关闭。可按模型和字段启用；默认情况下，每次写入都会成为待用户在 Odoo 中批准的提案
审计	无	每次调用都会记录用户、令牌、客户端名称和来源
连接 Claude 网页版和移动版	在一台桌面设备上配置文件	OAuth 2.1（RFC 9728 / 8414 / 7591、PKCE S256）

功能

• 远程 MCP 端点（/mcp/v1，JSON-RPC 2.0）：initialize、tools/list、tools/call、ping
• 面向 Claude 的 OAuth 2.1：受保护资源和授权服务器元数据、动态客户端注册、仅支持授权码 + PKCE S256、轮换刷新令牌、由 Odoo 提供的批准页面
• 个人专属令牌，适用于桌面客户端：仅显示一次，仅存储 SHA-256 摘要，支持过期时间和一键撤销
• 按请求限定工具范围：tools/list 仅返回该用户可访问的工具
• 通过允许列表公开模型：管理员指定模型之前，不会公开任何内容
• 写入审批工作流：创建、更新和删除操作默认都是提案，除非管理员针对指定模型另行设置
• 完整审计记录：MCP 读取和写入操作会与在 Odoo 内执行的读取操作一同显示
• 支持 Odoo 18.0 和 19.0、Community 和 Enterprise、Odoo.sh 或可自托管

两步连接 Claude

1. 在你的 Odoo 上安装模块（必须使用 HTTPS）。
2. 在 Odoo 中打开 AI Assistant → Connections，选择要公开的模型。
3. 在 Claude 中，前往 Settings → Connectors → Add custom connector，粘贴你的 Odoo MCP URL （https://your-odoo.example.com/mcp/v1）。
4. 在打开的 Odoo 页面上批准连接。现在，Claude 就能像你一样根据 Odoo 数据作答。

使用配置文件的桌面客户端可通过令牌向导获取即用型 JSON 代码块。

获取模块

此模块已发布到官方 Odoo Apps Store：

• Odoo 19.0：https://apps.odoo.com/apps/modules/19.0/technovision_ai_mcp/
• Odoo 18.0：https://apps.odoo.com/apps/modules/18.0/technovision_ai_mcp/

它需要 AI Assistant for Odoo — Permission-Aware（technovision_ai_core），Odoo Apps Store 会一并安装该依赖。

产品页面和文档：https://technovision.dev/products/mcp-server

需要协助设置？

我们可以在你的数据库上安装和配置此模块，包括 Odoo.sh，也可以针对你的某个工作流构建自定义工具。请联系 [email protected]。

---

此仓库是该连接器的公开信息页面。模块本身采用 OPL-1 许可，并通过 Odoo Apps Store 分发。

TechnoVision · technovision.dev