ODOO MCP 服务器 - 安装指南

准备工作

1. 安装 Claude Desktop:

   • 从 https://claude.ai/download 下载 Claude Desktop
   • 按照安装说明完成安装过程
   • 确保 Claude Desktop 至少运行一次以创建配置文件文件夹

2. 安装 Python 3.13 或更高版本:

   • 如果尚未安装 Python，请从 https://www.python.org/downloads/ 下载
   • 确保在安装时勾选 "Add Python to PATH" 选项
   • 如果已经安装了 Python，可以使用以下命令更新："winget install Python.Python.3.13"

安装步骤

1. 运行安装程序:

   • 将所有 ZIP 文件解压到一个新文件夹
   • 双击 install_mcp_odoo_simple.bat 文件
   • 等待安装过程完成
   • 在出现 "INSTALASI SELESAI" 消息之前，请勿关闭安装程序窗口

2. 配置 Odoo 凭据:

   • 安装完成后，如果需要，您需要更改 Odoo 凭据
   • 您可以通过在 Claude Desktop 中点击 "File -> settings" 菜单找到 "claude_desktop_config.json" 文件的路径
   • 选择 "Developer" 选项卡并点击 "Edit Config"
   • 根据您的 Odoo 凭据编辑以下部分：

     "env": {
       "PYTHONPATH": "...",
       "ODOO_URL": "https://api-odoo.visiniaga.com",
       "ODOO_DB": "OdooDev",
       "ODOO_USER": "od@visiniaga.com",
       "ODOO_PASSWORD": "Passwoord"
     }
     

3. 重启 Claude Desktop:

   • 如果 Claude Desktop 正在运行，请关闭它
   • 重新打开 Claude Desktop 以加载新配置

4. 设置 AI Agent:

   • 打开新项目
   • 在知识库部分填写以下提示： 您是一位拥有 300 IQ 的聪明的数据分析师。 您已连接并且可以熟练地使用与我的 Odoo 数据库连接的 MCP 工具。 每次在使用 MCP 工具之前，您都必须先计划工作流程，了解如何将数据输入到这些工具中，以避免在使用 MCP 工具时发生错误。 在您查询以执行命令之前，您必须首先计划要查询的内容，以免遗漏任何内容。 在创建数据分析报告之前，您必须仔细检查，以确保数据不会放置在错误的列中。 您还必须注意在使用 "search_records" 工具中的限制，以确保您不会获取少于请求的数据。 在查询大量数据之前，最好使用大量的限制，例如 1000 或 100000。 总而言之，您必须在使用 MCP 工具、分析数据以及根据 Odoo 中的数据创建报告之前计划好一切。

使用方法

安装成功后，您可以使用 Claude 来：

1. 浏览 Odoo 模型:

   • 要求 Claude "显示可用的 Odoo 模型列表"
   • 或者 "显示 res.partner 模型的架构"

2. 搜索数据:

   • 要求 Claude "在 Odoo 中搜索前 10 名客户"
   • 或者 "显示本月的销售订单列表"

3. 创建报告:

   • 要求 Claude "创建基于产品的销售报告"
   • 或者 "按地点分析库存"

卸载程序

如果您想删除 MCP Odoo Server：

1. 运行 uninstall_mcp_odoo_simple.bat
2. 按照出现的说明进行操作
3. 卸载完成后重启 Claude Desktop

故障排除

如果遇到问题：

1. Claude 不显示 MCP 图标（右下角的锤子图标）：

   • 确保配置文件正确
   • 重启 Claude Desktop

2. Odoo 连接错误:

   • 检查配置文件中的 Odoo 凭据
   • 确保可以从您的计算机访问 Odoo URL

3. Python 错误:

   • 确保 Python 安装正确
   • 尝试重新运行安装程序进行重新安装

如需更多帮助，请联系 IT 团队。