如何通过 MCP 将 Odoo (MCP server) 连接到 Claude

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Odoo (MCP server)、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

Odoo (MCP server) + Claude

通过 Odoo 自带的 MCP 服务器（Odoo AI，Odoo Online saas-19.4 及 Odoo 20）把 Claude、ChatGPT 或 Copilot 连接到 Odoo：搜索任意模型，对记录分组和汇总，列出模型和字段，并在管理员允许时创建和更新记录。权限由 Odoo 用户以及管理员开放的 AI Tools 决定。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

ODOO_URL, ODOO_MCP_API_KEY

步骤 1 — 获取凭证

设置大约需要 5 分钟。你需要一个带有 Odoo 自带 MCP 服务器的 Odoo 数据库：saas-19.4 及以上版本的 Odoo Online，或 Odoo 20，并且已安装 AI 应用。版本号显示在 Settings 页面底部；带 MCP 服务器的数据库在创建 API 密钥时会提供 MCP 范围。

1. 在 Odoo 中点击你的头像，打开 My Preferences（或 My Profile）→ Security → Add API Key。确认密码，并给密钥起个名字。
2. 把 Scope 设为 MCP，在 Expires 中选择有效期。Odoo 只显示一次密钥，请立即复制。建议用一个专用的 Odoo 用户创建密钥，其访问权限与助手可以看到的范围一致：密钥会以该用户的身份执行操作。
3. 把密钥粘贴到 ODOO_MCP_API_KEY。它由 40 个小写十六进制字符组成，不要加上 Bearer 一词。
4. 在 ODOO_URL 中填写你打开 Odoo 时的地址，只到主机名，例如 https://mycompany.odoo.com。不要带 /odoo、/web、/mcp 和结尾的斜杠：/mcp 由连接器自动添加。
5. 安装连接器并运行 odoo_mcp_ai_tool_mcp_retrieve_initial_context：它会显示当前登录用户、其时区、当前公司以及可以切换到的所有公司。

该用哪个 Odoo 连接器？ 这个连接器适用于带有 Odoo 自带 MCP 服务器的数据库，由你的 Odoo 管理员决定有哪些工具、允许哪些修改。对于 Odoo 19.0（没有 MCP 服务器）、没有 MCP 服务器的 Odoo.sh 或自建服务器，或者你想要针对合作伙伴、销售订单、发票和产品的固定工具，请使用 Odoo 连接器（JSON-2 API，Odoo 19 及以上）。Odoo 14 到 18 请使用 Odoo 14-18 (JSON-RPC)。

工具来自你的数据库：安装时，AnythingMCP 会询问 Odoo 的 MCP 服务器开放了哪些工具。默认是 Get Models、Get Fields、Search、Read group 和 MCP Retrieve initial context，全部只读，Odoo 会以密钥所属用户的权限执行它们。管理员可以在开发者模式下的 Settings → Technical → Server Actions 中，在工具的 Usage 选项卡勾选 Available in MCP，开放更多工具（Create Records、Update Records、菜单、网站和图像工具）。之后在这里打开连接器并点击 Discover tools。图像生成会消耗 Odoo AI 积分。

可读取的内容：Odoo 用户有权打开的任意模型，例如联系人、销售订单、发票或产品。odoo_mcp_ai_tool_get_models 找到合适的模型，odoo_mcp_ai_tool_get_fields 列出它的字段，odoo_mcp_ai_tool_search 用 Odoo 域条件查找记录，odoo_mcp_ai_tool_read_group 按日、周、月、季度或年分组汇总：每月销售额、每个客户的发票、每个阶段的线索。

每次修改前都会询问：安装时没有任何写入工具处于开启状态。管理员开启创建或更新记录后，AI 会先展示相关记录和具体的值，等你同意后才写入。

安装时关闭：odoo_mcp_ai_tool_create_records 和 odoo_mcp_ai_tool_update_records。在管理员把它们开放给 MCP 之前，Odoo 会隐藏它们；在这里它们也以关闭状态安装，因为它们会创建记录，或修改所有符合域条件的记录的字段值。只有当助手确实需要修改 Odoo 时，才按工具逐个开启。

限制：Search 默认返回 50 条记录，每次调用最多 200 条，因此 AI 会对较大的结果分页读取，或用 Read group 计算汇总，而不是拉取成千上万行。API 密钥会在你于 Expires 中选择的日期失效：届时请创建新密钥并粘贴进来。

常见错误：401 表示密钥错误、已过期，或创建时没有选择 MCP 范围。/mcp 返回 404 表示该数据库没有 MCP 服务器（版本早于 saas-19.4，或未安装 AI 应用）：请改用 Odoo 或 Odoo 14-18 (JSON-RPC) 连接器。Odoo 发布的 Get Fields 没有参数，但缺少 model_name 和 include_description 时该工具会失败，所以 AI 总是同时传入这两个参数。

该连接器不会添加你的 Odoo 未开放的工具，不会超出密钥背后 Odoo 用户的访问权限，也无法用于没有 Odoo MCP 服务器的数据库。

步骤 2 — 安装 adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

步骤 3 — 在 Claude 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

推荐路径：在 claude.ai web 上工作，无需触碰任何配置文件。

1. 在 Claude 中打开 Customize → Connectors。
2. 点击 +，然后点击 Add custom connector。
3. 输入名称（例如 Odoo (MCP server)）和远程 MCP 服务器 URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID，然后点击 Add。
4. 点击 Connect，登录 AnythingMCP（OAuth）并允许访问。

下面所有工具都会出现在你的聊天中，开始输入提示。

可用工具

示例提示

• “今年每个月已确认销售订单的销售额是多少？请给出每个月的合计。”
• “哪些客户有逾期未付的发票？每个客户分别欠我们多少？”
• “找到联系人上海华建，告诉我他们的邮箱、电话和负责的销售员。”
• “上个季度按数量计算，销量最高的十个产品是哪些？”
• “把联系人王丽的邮箱改成 [email protected]。更新前先把这条记录给我看。”

FAQ

Claude Code 和 Claude Desktop 一样工作吗? 是的，两者都指向 https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。

下一步

• 连接器主页
• 连接到 ChatGPT
• 连接到 Cursor
• 连接到 Gemini
• 连接到 Meta Muse