qod-ppm-odoo-mcp

QOD PPM Odoo 플러그인을 위한 MCP 서버입니다.

일반적인 Odoo CRUD 서버로는 표현할 수 없는 플러그인의 버튼, 마법사(wizard) 및 워크플로우 전환 기능을 MCP 도구로 노출합니다.

설계

이 서버는 의도적으로 가볍게(thin) 설계되었습니다. 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 작업 URL을 반환합니다.

변경 요청 (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?)

세 가지 모두 /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 모듈과 동일합니다.