qod-ppm-odoo-mcp

MCP-Server für das QOD PPM Odoo-Plugin.

Stellt die Schaltflächen, Assistenten und Workflow-Übergänge des Plugins als MCP-Tools bereit – also genau die Dinge, die ein generischer Odoo-CRUD-Server nicht abbilden kann.

Design

Dieser Server ist bewusst schlank gehalten. Er implementiert kein Odoo-CRUD neu. Betreiben Sie ihn parallel zu einem generischen Odoo-MCP (z. B. ivnvxd/mcp-server-odoo):

Einfach ausgedrückt: Wenn es eine Schaltfläche in der Odoo-Benutzeroberfläche gibt, die beim Klicken etwas Nicht-Triviales bewirkt, ist sie hier ein Tool. CRUD kapselt Felder; dies kapselt Schaltflächen.

Related MCP server: mcp-server-odoo

Installation

pip install qod-ppm-odoo-mcp

Oder aus dem Quellcode:

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

Konfiguration

Erstellen Sie einen Service-Benutzer in Odoo und weisen Sie ihm die benötigten PPM-Gruppen zu (group_ppm_admin oder bereichsspezifische Alternativen). Generieren Sie einen API-Schlüssel auf der Einstellungsseite des Benutzers. Legen Sie dann Folgendes fest:

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="…"

Eine .env.example ist enthalten.

Ausführung

stdio (Standard) — für Claude Desktop / Claude Code / alles, was einen MCP-Server als Unterprozess startet:

qod-ppm-mcp

Streamable HTTP — für den Fernzugriff (ein anderer VPS, ein Agent-Host usw.):

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

Schalten Sie einen Reverse-Proxy mit TLS + Authentifizierung davor, falls der Zugriff über das Internet erfolgt.

Konfiguration für Claude Code / Claude Desktop

Fügen Sie dies zu ~/.claude.json (Claude Code) oder claude_desktop_config.json hinzu:

{
  "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": "…"
      }
    }
  }
}

Beide Server verweisen auf dasselbe Odoo. Claude sieht Tools, die als mcp__qod-ppm__* (Workflow-Aktionen) und mcp__odoo__* (generisches CRUD) benannt sind.

Tool-Referenz

Rufen Sie ppm_list_action_tools auf, um die aktuelle Liste zur Laufzeit abzurufen. Gruppen:

Meilensteine (ppm.milestone)

• ppm_milestone_start / achieve / miss / cancel / reopen

Statusberichte (ppm.status.report + Assistent)

• ppm_status_report_generate(project_id, period?, commentary?) — führt den Assistenten aus, füllt RAG/Budget/Risiken/Meilensteine automatisch aus und erstellt einen Bericht

• ppm_status_report_publish(report_id)

• ppm_status_report_reset_draft(report_id)

• ppm_status_report_print_url(report_id) — gibt die PDF-Aktion zurück

Änderungsanfragen (ppm.change.request + Ablehnungs-Assistent)

• ppm_change_request_submit / start_review / approve / reset_draft

• ppm_change_request_reject(cr_id, reason) — führt den Ablehnungs-Assistenten aus

Risiken (ppm.risk)

• Workflow: ppm_risk_start_analysis / start_mitigation / start_monitoring / mark_occurred / close / reopen

• ppm_risk_move_in_matrix(risk_id, probability, impact) — Wahrscheinlichkeit und Auswirkung sind Ganzzahlen von 1–5; der Server berechnet Score und Stufe neu

Probleme (Risiken, die als issue_type markiert sind)

• ppm_issue_assign / start / resolve / escalate

Rollenzuweisungen (ppm.role.assignment)

• ppm_role_activate / approve_and_activate / revoke / reset_draft (jeweils mit Synchronisierung der Odoo-Sicherheitsgruppe)

Exporte (Assistenten → 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?)

Alle drei geben eine ir.actions.act_url zurück, die auf /web/content/<id>?download=true verweist.

Projekte aus Kundenkarten

• ppm_create_project_from_template(partner_id, template_id, project_name)

Introspektion

• ppm_ping() — Authentifizierung + grundlegende Zählungen

• ppm_list_action_tools() — selbsterklärende Tool-Liste

Kompatibilität

• Odoo 18.0 Community / Enterprise

• QOD PPM-Module: 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

Lizenz

LGPL-3.0-or-later — passend zu den QOD PPM-Modulen.