qod-ppm-odoo-mcp

MCP-сервер для плагина QOD PPM для Odoo.

Предоставляет кнопки, мастера и переходы рабочих процессов плагина в качестве инструментов MCP — то, что обычный сервер Odoo CRUD не может реализовать.

Проектирование

Этот сервер намеренно сделан легковесным. Он не дублирует функционал Odoo CRUD. Запускайте его вместе с обычным MCP-сервером Odoo (например, ivnvxd/mcp-server-odoo):

Проще говоря: если в пользовательском интерфейсе Odoo есть кнопка, которая при нажатии выполняет что-то нетривиальное, это инструмент здесь. 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?)

Все три возвращают ir.actions.act_url, указывающий на /web/content/<id>?download=true.

Проекты на основе карточек клиентов

• 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.

Maintenance

Resources

• GitHub Repository
Need Help?Related Servers

Tools

• ppm_change_request_approveB
• ppm_change_request_rejectB
• ppm_change_request_reset_draftB
• ppm_change_request_start_reviewB
• ppm_change_request_submitB
• ppm_create_project_from_templateB
• ppm_export_budgetA
• ppm_export_resourcesB