Claude Connector for Odoo

io.github.technovision-devv1.4.3更新于 Oct 9, 2026

Permission-aware MCP server for Odoo 18/19. OAuth 2.1; each call runs as one named Odoo user.

已验证Streamable HTTP可网页运行Security & MonitoringBusiness & Commerce

概览

AI 生成的概览

通过权限感知的远程 MCP 端点，以某个具名 Odoo 用户身份将 AI 助手连接到 Odoo 18/19 数据库。

功能
把 Odoo 18 或 19 数据库变成位于 /mcp/v1 的远程 MCP 服务器，使用 JSON-RPC 2.0，支持 initialize、tools/list、tools/call 和 ping。Claude 及其他 MCP 客户端通过带 PKCE 的 OAuth 2.1 连接，每个请求都以某个具名 Odoo 用户身份运行，并受该用户的群组和记录规则限制。模型仅由管理员加入允许列表后才暴露；默认情况下创建、更新和删除都是待批准的提案，除非管理员按模型和字段开启直接写入。读写操作都会记录用户、令牌、客户端名称和来源。
适用场景
当助手需要基于 Odoo 实时数据作答、又不愿共享管理员 API 密钥，并且访问权限必须遵循每个人现有的 Odoo 权限时，适合使用。它适合需要按用户区分身份、写入需审批、并保留 AI 访问审计记录的团队。
运行要求
需要可通过 HTTPS 访问的 Odoo 18.0 或 19.0 实例（社区版或企业版，Odoo.sh 或自托管），并从 Odoo 应用商店安装该连接器模块及其依赖 technovision_ai_core。管理员必须指定要暴露的模型，每个用户通过 OAuth 2.1 或个人令牌连接。
安装前请注意
该服务器可读取 Odoo 记录，并在管理员开启后创建、更新和删除记录；默认写入为待批准提案，除非确实需要直接写入，否则应保持默认。个人令牌只显示一次且仅以 SHA-256 摘要存储，应妥善保存并在不再需要时撤销。访问范围受连接用户的 Odoo 权限限制，上线前请检查暴露的模型和用户权限。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Claude Connector for Odoo，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "odoo-claude-connector": {
      "type": "http",
      "url": "https://{odoo_host}/mcp/v1"
    }
  }
}

README

Claude Connector for Odoo: a permission-aware MCP server

Connect Claude (web, desktop or mobile) and other MCP clients to your Odoo 18 or 19 database, without handing over an admin key.

[Claude Connector for Odoo]

This module turns your Odoo into a remote Model Context Protocol (MCP) server. Claude connects with OAuth 2.1 in two clicks. Every request runs as one named Odoo user, with that user's access rights, so the AI sees exactly what that person could see in Odoo. No more.

[Demo]

Why it's different

Typical "AI for Odoo" setupClaude Connector for Odoo
IdentityOne admin API key for everyoneEach token or OAuth grant acts as one person (with_user)
What the AI can seeEverythingOnly what that user's groups and record rules allow
WritesDirectOff by default. Enabled per model and per field, and by default each write is a proposal a person approves in Odoo
AuditNoneEvery call is logged with user, token, client name and source
Connecting Claude web and mobileConfig file on one desktopOAuth 2.1 (RFC 9728 / 8414 / 7591, PKCE S256)

Features

  • Remote MCP endpoint (/mcp/v1, JSON-RPC 2.0): initialize, tools/list, tools/call, ping
  • OAuth 2.1 for Claude: protected-resource and authorization-server metadata, dynamic client registration, authorization code + PKCE S256 only, rotating refresh tokens, an approval screen served by Odoo
  • Per-person tokens for desktop clients: shown once, stored only as a SHA-256 digest, with expiry and one-click revocation
  • Tools scoped per request: tools/list returns only what that person can reach
  • Models exposed by allow-list: nothing is exposed until an administrator names the models
  • Approval workflow for writes: create, update and delete are proposals unless an administrator decides otherwise for a named model
  • Full audit trail: MCP reads and writes appear next to reads made inside Odoo
  • Odoo 18.0 and 19.0, Community and Enterprise, Odoo.sh or self-hosted

Connect Claude in two clicks

  1. Install the module on your Odoo (HTTPS required).
  2. In Odoo, open AI Assistant → Connections and choose which models to expose.
  3. In Claude, go to Settings → Connectors → Add custom connector and paste your Odoo MCP URL (https://your-odoo.example.com/mcp/v1).
  4. Approve the connection on the Odoo screen that opens. Claude now answers from your Odoo data, as you.

Desktop clients that use a config file get a ready-made JSON block from the token wizard.

[Tokens] [Audit trail]

Get it

The module is published on the official Odoo Apps Store:

It requires AI Assistant for Odoo — Permission-Aware (technovision_ai_core), which the store installs with it.

Product page and documentation: https://technovision.dev/products/mcp-server

Need it set up?

We install and configure it on your database, including Odoo.sh, and can build a custom tool for one of your workflows. Contact [email protected].

This repository is the public information page for the connector. The module itself is licensed under OPL-1 and distributed through the Odoo Apps Store.

TechnoVision · technovision.dev

来源：README.md，提交 acd82f9

工具

0
工具元数据尚未被收录。

版本历史

1
  1. v1.4.3最新Oct 9, 2026