Odoo Mcp Server

    

odoo-mcp-pro

Odoo ERP 向け AI コネクターです。自然な言葉でビジネスデータにアクセスできます。
レコードの検索、作成、更新、管理も、話しかけるだけです。

セットアップを省略できます。 ホスト版なら5分で利用を開始できます。自動更新、OAuth の管理、暗号化された API キーが含まれています。pantalytics.com から開始 →

---

アイデア

Odoo は強力です。AI も強力です。組み合わせれば、さらに便利になります。

odoo-mcp-pro は、MCP（Model Context Protocol）を使用して Odoo に接続する AI コネクターです。MCP は、AI アシスタントが外部システムとやり取りできるオープン標準です。AI アシスタントを Odoo ERP に接続することで、自然な言葉をビジネスデータへのインターフェースとして使えます。Odoo の UI を置き換えるのではなく、多くの作業をより速く行える第2のインターフェースを提供します。Claude、ChatGPT、Cursor、Windsurf、その他すべての MCP 対応 AI ツールで利用できます。

「第4四半期の未払い請求書のうち、5,000 EUR を超えるものをすべて表示して」 -- AI が Odoo インスタンスに直接問い合わせて、結果を返します。

作業に合ったインターフェースを使えます。 複雑な設定には Odoo の UI を使い、すばやいデータ検索、一括での質問、レコードの即時作成には AI に尋ねるだけです。

できること

• 「アムステルダムで、見積書が未確定の連絡先をすべて検索して」
• 「Acme Corp の見込み案件を作成して。予想売上は 50k EUR」
• 「先月の受注のうち、まだ納品されていないものはどれ？」
• 「sale.order モデルにはどんなフィールドがある？」
• 「商談 #42 の予想クロージング日を次の金曜日に更新して」

営業、請求書、連絡先、在庫、CRM、人事など、あらゆる Odoo モデルで利用できます。

今すぐ試してみませんか？ セットアップを省略できます。ホスト版なら5分以内に Odoo に接続できます。pantalytics.com から開始 →

はじめに

ホステッド版（推奨）

最も手軽で安全に利用を開始できる方法です。 サーバーはこちらで運用します。登録して、Odoo の URL と API キーを貼り付ければ完了です。

• 5 分で利用開始できます。 インストールも Docker もインフラも不要です。Claude、ChatGPT、Cursor、Windsurf、および MCP 対応のあらゆる AI ツールで動作します。
• 常に最新の状態です。 セキュリティパッチ、Odoo バージョンとの互換性、新しい MCP 機能は自動的に反映されるため、お客様側でアップグレード作業を行う必要はありません。
• デフォルトでより安全です。 API キーの暗号化（AES-128）、OAuth 2.1 の管理、継続的な監視、欧州のインフラを備えています。面倒でも重要な作業はすべてこちらで対応するため、お客様が行う必要はありません。

1. pantalytics.com で登録する
2. ログインして、Odoo の URL と API キーを入力します（生成方法）
3. MCP サーバーを AI ツール（Claude、ChatGPT、Cursor など）に追加します
4. 質問を始めます

データは Odoo に保持されます。サーバーはステートレスなプロキシです。API キーは保存時に暗号化されます。

pantalytics.com で開始する →

セルフホスト版

ご自身のマシンで実行します。シングルテナントのみ対応しています。環境変数で設定する 1 つの Odoo インスタンスを使用します。認証には Odoo API キーを使います。OAuth、ユーザー管理、管理 UI はありません。

# Install
pip install "mcp-server-odoo @ git+https://github.com/pantalytics/odoo-mcp-pro.git"

# Run (stdio mode, for Claude Desktop / Claude Code)
ODOO_URL=https://mycompany.odoo.com ODOO_API_KEY=your_key python -m mcp_server_odoo

# Run (HTTP mode, for remote access from one trusted network)
ODOO_URL=https://mycompany.odoo.com ODOO_API_KEY=your_key \
  python -m mcp_server_odoo --transport streamable-http --host 0.0.0.0 --port 8000

HTTP モードには組み込みの認証機能がありません。リバースプロキシの背後で公開するか、ネットワークレベルでアクセスを制限してください。

または、Claude Desktop の claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "odoo": {
      "command": "python",
      "args": ["-m", "mcp_server_odoo"],
      "env": {
        "ODOO_URL": "https://mycompany.odoo.com",
        "ODOO_API_KEY": "your_api_key_here"
      }
    }
  }
}

マルチテナント、ユーザーごとの接続、OAuth、または管理 UI が必要ですか？ それらは SaaS の領域です。ホステッド版なら、より短時間でセットアップでき、自動更新され、セキュリティパッチもこちらで対応します。セルフホストにかかる時間と比べても、費用を抑えられます。これらの機能は、このオープンコアサーバーを基盤とする別個の商用パッケージで提供されます。

仕組み

odoo-mcp-pro は、MCP（Model Context Protocol）を実装する Odoo コネクターです。MCP は、AI アシスタントが外部ツールを呼び出せるようにするオープン標準です。次のツールを公開しており、AI は質問に応じてこれらを呼び出せます。

ツール	説明
record_search	ドメインフィルター、並べ替え、ページネーションを指定して、任意のモデルを検索します
record_get	スマートなフィールド選択により、ID を指定して特定のレコードを取得します
record_aggregate	Odoo 内でグループ化した集計（read_group）を計算します。製品、月などごとの合計、平均、件数に対応します
record_export	多数のレコードをコンパクトな CSV 形式でエクスポートします（Odoo のエクスポート機能）。order_id/partner_id/city のような関連パスに対応します
model_list	利用可能な Odoo モデルを検出します
resource_template_list	利用可能なリソース URI テンプレートを検出します
record_create / records_create	1 件または複数のレコードを作成します
record_update / records_update	1 件または複数のレコードを更新します
record_delete / records_delete	1 件または複数のレコードを削除します
record_import	外部 ID を使った冪等なアップサートを行います（Odoo の CSV インポートと同じです）
server_info_get	サーバーのバージョンと接続状態を取得します

Odoo 14～20 に対応。Odoo 19 以降では JSON/2 API を、それ以前のバージョンでは XML-RPC を使用します。適切なプロトコルが自動的に選択されます。

セキュリティ

• Odoo がすべてを管理します。 すべてのデータ、権限、ビジネスロジックは Odoo にあります。各ユーザーの API キーによって、表示や操作が可能な範囲が決まり、ACL とレコードルールが通常どおり適用されます。
• ステートレスなプロキシです。 MCP サーバーはビジネスデータを保存したり、キャッシュしたりしません。
• API キーは AES-128（Fernet）で保存時に暗号化されます。 AI、ブラウザー、ログに公開されることはありません。
• いつでも管理できます。 Odoo で API キーを取り消せば、アクセスをすぐに遮断できます。
• 脆弱性を発見しましたか？ [email protected] にメールでご連絡ください。SECURITY.md もご覧ください。報告者は変更履歴に記載されます。

セキュリティ管理を任せたいですか？ ホスト版では、パッチ適用、OAuth トークンのローテーション、インシデント監視を行います。データは引き続き Odoo に保管され、プロキシの運用のみを当社が担います。

開発

uv venv --python 3.10
source .venv/bin/activate
uv pip install -e ".[dev]"
pytest tests/ -q
ruff check . && ruff format .

技術的な詳細については architecture.md、コーディング規約については CLAUDE.md をご覧ください。

コントリビューション

コントリビューションを歓迎します。リポジトリをフォークして、機能ブランチを作成し、pytest tests/ と ruff check . を実行してから、PR を作成してください。

FAQ

どのバージョンの Odoo に対応していますか？ Odoo 14～20 に対応しています。サーバーは JSON/2（Odoo 19 以降）と XML-RPC（14～18）のどちらを使用するか自動で判別します。設定は不要です。

スマートフォンで使えますか？ はい。ホスト版は Claude モバイル（iOS/Android）、任意のブラウザーからの Claude.ai、Claude Desktop、Claude Code、ChatGPT で利用できます。ローカルインストール（STDIO）は、インストールしたマシンでのみ動作します。

データは安全ですか？ データは Odoo に保管されます。MCP サーバーはステートレスなプロキシであり、ビジネスデータを保存したり、キャッシュしたりしません。API キーは AES-128（Fernet）で保存時に暗号化されます。各ユーザーには Odoo の権限が適用されるため、Odoo のロールで許可された範囲の情報のみを表示・操作できます。

すべてのモデルで「Access denied」と表示されます 通常、Odoo の API キーに適切な権限がありません。次のことを試してください。

1. Odoo（Settings > Users > API Keys）でAPI キーを再生成し、設定したすべての場所で更新してください（ホスト版：/admin/setup、セルフホスト版：ODOO_API_KEY 環境変数）。
2. Odoo ユーザーに、クエリしたいモデルへの読み取り権限が少なくともあることを確認してください。
3. Odoo.sh を使用している場合は、契約プランが JSON/2 API に対応していることを確認してください。

「Authentication required」または「invalid_token」と表示されます（ホスト版） AI ツールと MCP サーバー間の OAuth 接続に失敗しています。AI ツールの設定で MCP サーバーの接続を解除し、再接続してみてください。セルフホスト版では OAuth を使用せず、Odoo API キーで直接認証します。

ODOO_DB を設定する必要はありますか？ 複数のデータベースを使って Odoo をセルフホストしている場合にのみ必要です。Odoo.sh と Odoo Online では不要です。ホスト名からデータベースが判別されます。

ホスト版とセルフホスト版のどちらを使うべきですか？ 特別な理由がない限り、ホスト版をおすすめします。ホスト版は 5 分で稼働し、Odoo のリリースごとに自動更新され、OAuth 管理と API キーの暗号化も提供されます。セルフホスト版はシングルテナントのみ（Odoo インスタンスは 1 つ、API キー認証、管理 UI なし）で、パッチ適用とセキュリティ管理はご自身で行う必要があります。pantalytics.com でホスト版を始める →

ライセンス

このプロジェクトは、デュアルライセンスで提供されています。

• Andrey Ivanov による元の mcp-server-odoo から派生したファイルは、Mozilla Public License 2.0（LICENSE.MPL-2.0）のもとで引き続き提供されます。これらのファイルには SPDX-License-Identifier: MPL-2.0 ヘッダーがあり、対象ファイルは NOTICE に記載されています。
• それ以外のすべて、つまり Pantalytics が追加したコードは、Elastic License 2.0 のもとで提供されます。

Elastic ライセンス対象部分について、簡単に説明します。

• 許可されていること： このソフトウェアの使用、複製、改変、配布。自社内、自社の Odoo インスタンス、自社のプロジェクトでの利用など、自社の商用目的での利用も含まれます。
• 許可されていないこと： 第三者に機能の大部分へのアクセスを提供するホステッドサービスまたはマネージドサービスとして提供すること。これは Pantalytics が行っていることであり、ライセンスによって保護されています。
• 許可されていないこと： ライセンス表示の削除や、ライセンスキー機能の回避。

Elastic ライセンス対象部分はソースコードを入手できますが、OSI のオープンソースではありません。全容については、LICENSE、LICENSE.MPL-2.0、NOTICE をご覧ください。

Odoo 導入パートナーの皆様へ

AI を活用した Odoo をクライアントに提供したいとお考えですか？Elastic License 2.0 のもとでは、クライアント向けに odoo-mcp-pro の独自のホステッドバージョンを運用することは許可されていません。その代わりに、紹介手数料をお支払いするパートナープログラムを実施しています。エンドユーザーに odoo-mcp-pro をご紹介いただき、紹介リンクから登録してもらうと、継続的に手数料を獲得できます。お客様側でホスティングやメンテナンスを行う必要はありません。

ご興味がありましたら、詳細について [email protected] までお問い合わせください。

Pantalytics が開発

odoo-mcp-pro は、オランダのユトレヒトを拠点とする Odoo 導入パートナーである Pantalytics が開発・保守しています。

Andrey Ivanov による mcp-server-odoo からフォークしたものです。このプロジェクトから引き継いだファイルは、引き続き Mozilla Public License 2.0 のもとで提供されます。詳しくは NOTICE をご覧ください。

---

_{Odoo はOdoo S.A.の登録商標です。MCP ロゴはMIT Licenseのもとで使用しています。このプロジェクトは、Odoo S.A. または Anthropic との提携関係や、これらの企業による推奨を受けていません。}