AI导哈

Odoo ERP连接服务

一个连接AI助手（如Claude）到Odoo ERP系统的MCP服务器，专注于通过Odoo的XML-RPC API处理发票、付款、合作伙伴和会计功能。

  • by ChristopheB-MB
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 ChristopheB-MB/odoo-mcp-server

使用说明

odoo mcp服务器

一个MCP（模型上下文协议）服务器，将Claude等人工智能助手连接到您的Odoo ERP系统。专注于 发票、付款、合作伙伴和会计 通过Odoo的XML-RPC API。

适用于Odoo Online（SaaS）和自托管Odoo实例（v14+）。

特性

工具 说明
search_invoices 按状态、客户、日期范围、付款状态搜索发票
get_invoice 获取完整的发票详细信息，包括行项目
create_invoice 创建新的发票草稿
post_invoice 确认/发布发票草稿
search_payments 按合作伙伴、日期、州搜索付款
register_payment 注册一张或多张发票的付款
search_partners 按姓名、电子邮件、增值税号搜索客户/供应商
create_partner 创建新客户或供应商
get_account_balances 查看带有余额的科目表
search_journal_entries 搜索日记条目/移动
search_products 搜索产品（发票行项目）
odoo_info 显示连接信息和Odoo版本

安装

克劳德代码/克劳德桌面

将此添加到MCP配置中：

{
  "mcpServers": {
    "odoo-accounting": {
      "command": "npx",
      "args": ["-y", "odoo-mcp-server"],
      "env": {
        "ODOO_URL": "https://your-company.odoo.com",
        "ODOO_DB": "your-company",
        "ODOO_USERNAME": "your-email@company.com",
        "ODOO_API_KEY": "your-api-key"
      }
    }
  }
}

配置

服务器需要四个环境变量：

变量 描述 示例
ODOO_URL 您的Odoo实例URL https://mycompany.odoo.com
ODOO_DB 数据库名称（通常是子域） mycompany
ODOO_USERNAME 您的odoo登录电子邮件 user@company.com
ODOO_API_KEY Odoo API密钥（推荐）或密码 abc123...

如何获取Odoo API密钥

  1. 登录您的Odoo实例
  2. 首选 设置>用户和公司>用户
  3. 点击您的用户
  4. 去 账户安全 标签
  5. 点击 新API密钥
  6. 为其命名（例如“Claude MCP”）并复制密钥

注： Odoo Online上的外部API访问需要 定制计划。它不适用于One App Free或Standard计划。

用法示例

配置后，您可以向Claude询问以下问题：

  • “显示本月所有未付发票”
  • “2025年客户X的总收入是多少？”
  • “为合作伙伴Y开具发票，咨询时间为10小时，每小时150欧元”
  • “登记发票INV/2025/001的付款”
  • “经常账户余额是多少？”
  • “搜索与咨询相关的所有产品”

发展

git clone https://github.com/ChristopheB-MB/odoo-mcp-server.git
cd odoo-mcp-server
npm install
npm run build

MCP检验员测试：

npx @modelcontextprotocol/inspector node ./build/index.js

许可证

麻省理工学院

相关 MCP