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

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

Odoo (MCP server) + Microsoft Copilot

通过 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 — 在 Microsoft Copilot 中添加连接器

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

Microsoft Copilot 通过在 Copilot Studio 中构建的智能体使用 MCP 服务器：把 AnythingMCP 作为工具添加到智能体，然后把智能体发布到 Microsoft 365 Copilot 和 Teams。Copilot Studio 从 Microsoft 的云端通过 Streamable HTTP 连接，AnythingMCP 支持这种方式。

1. 在 Copilot Studio 中打开你的智能体（或新建一个），进入 Tools，选择 Add a tool → New tool → Model Context Protocol。
2. 填写 Server name（例如 AnythingMCP）、说明连接器用途的 Server description，以及 Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。Copilot Studio 根据描述决定何时调用该服务器。
3. 身份验证选择 API key，把 Type 设为 Header，请求头名称填 X-API-Key，然后选择 Create。
4. 在 Add tool 中选择 Create a new connection，粘贴 AnythingMCP 的 MCP API 密钥（MCP Servers → 你的服务器 → API keys），然后选择 Add to agent。
5. 在智能体的 Test 窗格中试一试：提出需要用到 Odoo (MCP server) 的工具的请求。
6. 选择 Publish，然后进入 Channels → Microsoft 365 and Microsoft Teams，保持勾选 Make agent available in Microsoft Copilot，再选择 Add channel。See agent in Teams 会为你安装该智能体；在 Microsoft 365 Copilot 中输入 @ 并选择该智能体。

希望每个用户各自登录？请选择 OAuth 2.0 → Dynamic discovery 代替 API 密钥：每个用户会在智能体首次调用时登录 AnythingMCP。

自托管？请用你实例的公网 HTTPS 地址替换 https://cloud.anythingmcp.com。Copilot Studio 从 Microsoft 的云端连接，因此 localhost 无法使用。

可用工具

示例提示

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

FAQ

这适用于哪个 Copilot？ 适用于工作中的 Microsoft 365 Copilot，通过 Copilot Studio 的智能体实现。面向个人账户的 Microsoft Copilot 应用无法添加自己的 MCP 服务器。

我需要什么？ 一个可以使用 Copilot Studio 的工作账户（许可证或试用版），用于构建智能体。在 Microsoft 365 Copilot 或 Teams 中使用它的人需要拥有该智能体的访问权限：把它共享给他们，或请管理员为整个组织发布。如果你的组织对 Power Platform 连接器设置了数据策略，这些策略同样适用于 MCP 服务器。

智能体不调用工具。 检查请求头名称是否正好是 X-API-Key，密钥是否属于与 URL 相同的 MCP 服务器，并把 Server description 写得具体：Copilot Studio 根据它决定何时调用服务器。每次修改后重新发布智能体；在已打开的对话中输入 "start over" 即可使用新版本。

下一步

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