odoo-mcp-connector

Odoo MCP サーバー

Odoo 向けの Model Context Protocol サーバーです。Claude（または任意の MCP クライアント）をご自身の Odoo ERP に接続し、自然言語でデータを検索、レポート作成したり、必要に応じて変更したりできます。

あらゆる Odoo モデルで動作します。デフォルトでは安全のため読み取り専用で、書き込みは明示的に有効にした場合に限られます。認証情報はお使いのマシン内に保持されます。ご自身の Odoo インスタンス以外にデータが保存されたり、送信されたりすることはありません。

機能

• あらゆるモデルへの汎用アクセス：検索、読み取り、件数確認、フィールドのイントロスペクション、モデル一覧の取得
• すぐに使えるビジネスツール：期限超過の請求書、売上概要、在庫不足の商品、上位顧客
• デフォルトで読み取り専用：オプトインした場合のみ作成、更新、削除が可能です（ODOO_ENABLE_WRITES=true）
• ご自身のデータをご自身のマシンで：環境変数だけで設定できます

インストール

MCP クライアントの設定に追加してください（例：Claude Desktop または Claude Code）。

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

Odoo API キーの取得

Odoo で、設定、ユーザー、ご自身のユーザー、アカウントセキュリティ、新しい API キーを選択します。生成されたキーを ODOO_API_KEY に貼り付けてください。（パスワードも使用できますが、API キーのほうが安全で、失効させることもできます。）

書き込みの有効化

デフォルトは読み取り専用です。モデルによるレコードの作成、更新、削除を許可するには、次を追加してください。

"ODOO_ENABLE_WRITES": "true"

Odoo には実際のビジネスデータが保存されています。モデルがレコードを作成、変更、削除できることを了承した場合にのみ、書き込みを有効にしてください。操作は常に、Odoo ユーザー自身の権限の範囲内で行われます。

ツール

常に利用可能（読み取り専用）

ツール	用途
odoo_search_read	あらゆるモデルのレコードを検索して読み取ります
odoo_read	ID を指定してレコードを読み取ります
odoo_count	ドメインに一致するレコードの件数を確認します
odoo_fields	モデルのフィールドをイントロスペクションします（名前、型、ラベル）
odoo_list_models	利用可能なモデルを一覧表示します
odoo_overdue_invoices	支払期限を過ぎた未払いの顧客請求書を取得します
odoo_sales_summary	期間内の売上と注文数を集計します
odoo_low_stock	数量のしきい値以下の商品を取得します
odoo_top_customers	請求済み売上高で上位の顧客を取得します

ODOO_ENABLE_WRITES=true の場合のみ利用可能

ツール	用途
odoo_create	レコードを作成します
odoo_write	ID を指定してレコードを更新します
odoo_unlink	ID を指定してレコードを削除します（取り消し不可）
odoo_call	任意のモデルメソッドを呼び出します

設定リファレンス

変数	必須	デフォルト	説明
ODOO_URL	はい		Odoo のベース URL
ODOO_DB	はい		データベース名
ODOO_USERNAME	はい		ログイン名（メールアドレス）
ODOO_API_KEY	はい		API キー（またはパスワード）
ODOO_ENABLE_WRITES	いいえ	false	書き込みを許可するには "true" を設定します
ODOO_TIMEOUT_MS	いいえ	30000	リクエストごとのタイムアウト（ミリ秒）

開発

npm install
npm test       # vitest, fully mocked, no live Odoo needed
npm run build

ライセンス

MIT、Falak Sarhan Saade