odoo-pulse

odoo-pulse

Odoo ERP 向けの AI ビジネスアナリストです。 1 つ質問するだけで、数値、注目点、リスク、判定（順調／リスクあり／不調）をまとめた回答が得られます。Model Context Protocol を介して利用できます。Odoo との CRUD 連携機能はすでに存在しますが、これはその上に構築された分析レイヤーです。

アナリストツール

各ツールは、管理上の質問全体に 1 回の呼び出しで回答し、解釈が必要な生データではなく、判定を含む構造化レポートを返します。

ツール	回答内容
business_pulse ⭐	朝のブリーフィング：昨日の売上、新規リード、支払期限超過の請求書、遅延タスク、休暇中の従業員を集計し、全社的な判定を提示します
pipeline_review	ステージ別の CRM ファネル、停滞している商談、加重売上、直近の受注率
sales_snapshot	今期と前期の売上（Δ%）、上位顧客・製品、長期間更新されていない見積もり
receivables_health	売掛金／買掛金の経過期間別区分、支払期限超過率、上位債務者
inventory_risk	在庫不足（予測がマイナス）と滞留在庫
absence_overview	今週の休暇取得者、承認待ち、カバーが手薄な部門
procurement_watch	購買：納期遅れの入荷、長期間更新されていない見積依頼、仕入先ごとの未確定支出
production_health	製造：計画開始日を過ぎているオーダー、停滞している仕掛品
project_profitability	プロジェクト：記録時間と割当時間、コスト／売上／利益率、予算消化状況の判定
project_budget	プロジェクトごとの予算と実績を明細単位で比較し、予算超過の明細と予算に反映されていない支出を表示します
team_workload · project_status_report · standup_digest	プロジェクトの進捗状況：負荷過多のメンバー、リスクのあるプロジェクト、毎日のスタンドアップ用ダイジェスト

金額を報告する各ツールでは、任意の company= フィルターを指定できます。通貨が混在する合計は、黙って合算せずに警告します。また、判定のしきい値（停滞率、支払期限超過率、成長率）はパラメーターで指定できるため、ビジネスに合わせて調整できます。

タイムゾーンの扱い

すべてのレポートツールは timezone_offset（デフォルトは 7）を受け取ります。Odoo は日時フィールドを UTC で保存します。ツールは日付ごとに分類する前に timezone_offset 時間分ずらし、ドメインの日付範囲は UTC の日時境界で表します。日付のみのフィールド（例：project.milestone.deadline、invoice_date_due、project.task.date_deadline）は、そのまま比較します。

バージョンによって異なるフィールド

find_partner は、mobile がまだ存在するインスタンス（Odoo 19 で削除）でのみ mobile を検索します。また、list_timesheets は hr_timesheet がインストールされていない場合、対処方法がわかるエラーを報告します。

内部では標準の Odoo XML-RPC 外部 API を使用しているため、Odoo 内に何もインストールする必要はありません。Odoo Online、Odoo.sh、オンプレミスで動作します。Odoo 18 以降が必要です。汎用ツール（search_read、read_records など）は古いバージョンでも引き続き動作しますが、レポートツールの動作は保証されません。

プレイグラウンドを試す

Odoo アカウントがなくても、ストーリー性のあるデモデータ（停滞している商談、90 日の支払期限超過請求書、在庫不足、本日休暇中の従業員）を事前に登録したデモ用 Odoo を起動できます。

docker compose -f deploy/playground/compose.yml up -d

初回起動時には約 4 GB のイメージ（Odoo + Postgres）を取得し、デモデータを登録します。接続状況により、5〜10 分ほどかかります。その後、Claude を接続して run business_pulse と尋ねてください。詳しい手順はこちらをご覧ください：docs/guides/playground.md。

インストールと接続

Claude Code に追加します（インストール手順は不要です。uvx が取得します）。

claude mcp add odoo-pulse \
  --env ODOO_URL=https://acme.odoo.com \
  --env ODOO_DB=acme \
  --env [email protected] \
  --env ODOO_API_KEY=your-api-key \
  --env ODOO_READ_ONLY=true \
  -- uvx odoo-pulse

API キーは Odoo の Settings → Users → (your user) → Account Security → New API Key で生成します。Claude Desktop と Cursor の設定、pip および Docker を使う方法については、docs/guides/install.md をご覧ください。キーが 漏えいした可能性がある場合は、API キーが漏えいした可能性がある場合をご覧ください。

または、ワンクリックでインストールできます。

デフォルトでは読み取り専用。必要に応じて安全に書き込み

このサーバーは初期状態では読み取り専用です（ODOO_READ_ONLY=true）。書き込みには、4 つの独立した制御をすべて満たす必要があります。ODOO_READ_ONLY=false、 ODOO_WRITABLE_MODELS（カンマ区切りのモデル許可リスト）、削除する場合はさらに ODOO_ALLOW_DELETE=true、そして呼び出しごとの confirm=true です。これがない場合、すべての書き込みツールはドライランのプレビューを返します。システムモデルへの書き込みは常に禁止されています。詳細については、docs/reference/tools.md#write-operationsをご覧ください。

その他のツール

分析レポートに加えて、CRM、営業、在庫、会計、人事、プロジェクト、製造、PoS、Enterprise アプリに対応した、モデルを認識するクエリツールが約 60 種類あります。ODOO_TOOL_GROUPS で有効にできます。全カタログと設定については、 docs/reference/tools.mdをご覧ください。

テスト

テストスイートでは XML-RPC レイヤーをモックするため、実際の Odoo もネットワークも不要です。

pip install -e ".[dev]"
pytest

実際の Odoo に対するライブチェック（読み取り専用）については、 docs/reference/tools.md#live-smoke-test-against-a-real-odooをご覧ください。

ライセンス

MIT