qod-ppm-odoo-mcp

QOD PPM Odooプラグイン用のMCPサーバーです。

プラグインのボタン、ウィザード、およびワークフロー遷移をMCPツールとして公開します。これらは汎用的なOdoo CRUDサーバーでは表現できない機能です。

設計

このサーバーは意図的に軽量に設計されています。OdooのCRUD機能を再実装するものではありません。汎用的なOdoo MCP（例: ivnvxd/mcp-server-odoo）と組み合わせて実行してください：

簡単に言えば、Odoo UI上にクリックすると複雑な処理を行うボタンがある場合、それはここでのツールになります。 CRUDがフィールドをラップするのに対し、これはボタンをラップします。

Related MCP server: mcp-server-odoo

インストール

pip install qod-ppm-odoo-mcp

またはソースから：

git clone https://github.com/wethti/qod-ppm-odoo-mcp
cd qod-ppm-odoo-mcp
pip install -e .

設定

Odooでサービスユーザーを作成し、必要なPPMグループ（group_ppm_adminまたはスコープ付きの代替グループ）を付与します。ユーザーの基本設定ページからAPIキーを生成します。その後、以下を設定します：

export ODOO_URL="https://your-odoo.example.com"
export ODOO_DB="your_db_name"
export ODOO_USERNAME="ppm-service@example.com"
export ODOO_API_KEY="…"   # preferred
# or ODOO_PASSWORD="…"

.env.example が含まれています。

実行

stdio (デフォルト) — Claude Desktop / Claude Code / MCPサーバーをサブプロセスとして起動するあらゆる環境用：

qod-ppm-mcp

Streamable HTTP — リモートアクセス用（別のVPS、エージェントホストなど）：

export QOD_PPM_MCP_TRANSPORT=http
export QOD_PPM_MCP_HOST=0.0.0.0
export QOD_PPM_MCP_PORT=8765
qod-ppm-mcp

インターネットに公開する場合は、TLS + 認証を備えたリバースプロキシを前面に配置してください。

Claude Code / Claude Desktopの設定

~/.claude.json (Claude Code) または claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "qod-ppm": {
      "command": "qod-ppm-mcp",
      "env": {
        "ODOO_URL": "https://your-odoo.example.com",
        "ODOO_DB": "your_db_name",
        "ODOO_USERNAME": "ppm-service@example.com",
        "ODOO_API_KEY": "…"
      }
    },
    "odoo": {
      "command": "uvx",
      "args": ["mcp-server-odoo"],
      "env": {
        "ODOO_URL": "https://your-odoo.example.com",
        "ODOO_DB": "your_db_name",
        "ODOO_USERNAME": "ppm-service@example.com",
        "ODOO_API_KEY": "…"
      }
    }
  }
}

両方のサーバーは同じOdooを指します。Claudeはツールを mcp__qod-ppm__* (ワークフローアクション) および mcp__odoo__* (汎用CRUD) として名前空間化して認識します。

ツールリファレンス

実行時に現在のリストを取得するには ppm_list_action_tools を呼び出してください。グループ：

マイルストーン (ppm.milestone)

• ppm_milestone_start / achieve / miss / cancel / reopen

ステータスレポート (ppm.status.report + ウィザード)

• ppm_status_report_generate(project_id, period?, commentary?) — ウィザードを実行し、RAG/予算/リスク/マイルストーンを自動入力してレポートを作成します

• ppm_status_report_publish(report_id)

• ppm_status_report_reset_draft(report_id)

• ppm_status_report_print_url(report_id) — PDFアクションを返します

変更要求 (ppm.change.request + 却下ウィザード)

• ppm_change_request_submit / start_review / approve / reset_draft

• ppm_change_request_reject(cr_id, reason) — 却下ウィザードを実行します

リスク (ppm.risk)

• ワークフロー: ppm_risk_start_analysis / start_mitigation / start_monitoring / mark_occurred / close / reopen

• ppm_risk_move_in_matrix(risk_id, probability, impact) — 確率と影響度は1〜5の整数です。サーバーがスコアとレベルを再計算します

イシュー (issue_typeとしてフラグが立てられたリスク)

• ppm_issue_assign / start / resolve / escalate

ロール割り当て (ppm.role.assignment)

• ppm_role_activate / approve_and_activate / revoke / reset_draft (それぞれがOdooセキュリティグループを同期します)

エクスポート (ウィザード → XLSX)

• ppm_export_budget(project_id?, portfolio_id?, date_from?, date_to?, category_id?, include_closed?)

• ppm_export_risks(project_id?, portfolio_id?, risk_level?, include_closed?)

• ppm_export_resources(project_id?, employee_id?, department_id?, date_from?, date_to?, include_cancelled?)

これら3つはすべて /web/content/<id>?download=true を指す ir.actions.act_url を返します。

クライアントカードプロジェクト

• ppm_create_project_from_template(partner_id, template_id, project_name)

イントロスペクション

• ppm_ping() — 認証 + 基本的なカウント

• ppm_list_action_tools() — 自己記述的なツールリスト

互換性

• Odoo 18.0 Community / Enterprise

• QOD PPMモジュール: qod_ppm_core, qod_ppm_budget, qod_ppm_change_request, qod_ppm_client_card_projects, qod_ppm_dashboard, qod_ppm_resource, qod_ppm_risk, qod_ppm_roles, qod_ppm_roles_crm, qod_ppm_roles_mrp, qod_ppm_scoring, qod_ppm_status, qod_ppm_task_status

ライセンス

LGPL-3.0-or-later — QOD PPMモジュールに準拠します。