mcp-odoo

mcp-odoo — MCP-сервер сообщества (автор — erpipe-org). Работа с Odoo с контролем записи и несколькими экземплярами. Ставится через uvx или через pip. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
erpipe-org
Лицензия
MIT
Транспорт
stdio
Авторизация
api_key
ОС
Не указана
Языки
python

Уровень риска: high

Запись в Odoo выключена по умолчанию, включается ODOO_MCP_ENABLE_WRITES=1 с цепочкой подтверждений; методы с побочными эффектами — по списку; пароль или API-ключ Odoo в конфиге.

Настройка клиентов

claude-code
{
    "code": "claude mcp add odoo --env ODOO_URL=https://mycompany.odoo.com --env ODOO_DB=mycompany \\\n  --env ODOO_USERNAME=agent@mycompany.com --env ODOO_PASSWORD=your-api-key -- uvx odoo-mcp",
    "lang": "bash",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

Odoo MCP превращает любую базу Odoo 16+ (Community и Enterprise) в MCP-сервер, используя только ваши существующие учётные данные. Модуль из App Store, настройка прав и доступ администратора не нужны. Для Odoo 16–18 сервер работает по XML-RPC, для Odoo 19+ — через External JSON-2. Это самостоятельно размещаемый сервер на Python под лицензией MIT: 41 инструмент и 11 подсказок. Проект ранее назывался tuanle96/mcp-odoo.

Группы инструментов по README:

  • чтение и поиск (11): модели и поля, ограниченный search_read, чтение записи, агрегирование на сервере, сотрудники и отпуска, профиль сервера, каталог схемы, построение доменов, чтение вложений (до 1 МиБ по умолчанию);
  • запись (5): preview_write, validate_write, execute_approved_write, вызов проверенных методов модели, сообщения в чаттер;
  • диагностика (3): разбор вызова без выполнения, видимость по правам доступа и правилам записей, связи моделей;
  • миграция (3): преобразование в JSON-2, отчёт о рисках обновления, история переименований моделей;
  • аудит и планирование (3): сканирование исходников аддонов без импорта, fit-gap-отчёт, бизнес-пакеты;
  • локальный поиск по знаниям (3): BM25-индекс по выборке записей, данные не покидают машину;
  • бухгалтерия (2): старение дебиторской и кредиторской задолженности, сводка по черновикам счетов;
  • фоновые задачи (4) и запросы сразу к нескольким экземплярам (3, только чтение);
  • health_check и list_instances (без учётных данных).

Кому подойдёт

  • Компаниям на Odoo, которые хотят спрашивать ассистента о клиентах, остатках и задолженности обычным языком.
  • Интеграторам и партнёрам Odoo: аудит аддонов перед обновлением, обзор нескольких клиентских баз.

Похожие серверы — в категории бизнес и 1С.

Установка

Быстрее всего запустить интерактивный мастер через uvx. Он спросит URL, базу и учётные данные, проверит подключение, запишет конфиг и выведет готовые фрагменты для Claude Code, Cursor и Claude Desktop:

uvx odoo-mcp --setup

Быстрая проверка — uvx odoo-mcp --health. Также можно установить пакет через pip install odoo-mcp или pipx install odoo-mcp либо запустить его в Docker (образ ghcr.io/erpipe-org/mcp-odoo:latest).

Подключение к клиентам

Конфиги приведены дословно из README; замените адрес, базу и учётные данные на свои. Подробнее — в инструкции как подключить MCP.

claude mcp add odoo --env ODOO_URL=https://mycompany.odoo.com --env ODOO_DB=mycompany \
  --env ODOO_USERNAME=agent@mycompany.com --env ODOO_PASSWORD=your-api-key -- uvx odoo-mcp

Для Claude Desktop укажите абсолютный путь к Python: приложения с графическим интерфейсом могут не видеть PATH из оболочки. Конфиги для Cursor, Codex, Windsurf, VS Code и других клиентов README выносит в отдельные файлы примеров.

Проверка

Выполните uvx odoo-mcp --health, затем попросите ассистента вызвать health_check и get_odoo_profile: они покажут версию Odoo, транспорт и состояние подключения.

Примеры задач

Покажи всех клиентов из Испании с неоплаченными счетами.
Проверь аддон custom_billing на риски перед переходом на Odoo 19.

Риски

  • Запись в ERP. Записи по умолчанию выключены. Создание, изменение и удаление проходят цепочку preview_write → validate_write → execute_approved_write и выполняются только с confirm=true и переменной ODOO_MCP_ENABLE_WRITES=1. Права доступа и правила записей Odoo продолжают действовать.
  • Методы с побочными эффектами (например, подтверждение заказа) включаются по одному через ODOO_MCP_ALLOWED_SIDE_EFFECT_METHODS. Режим ODOO_MCP_ALLOW_UNKNOWN_METHODS=1 разрешает всё, и health_check помечает его как широкий режим.
  • Учётные данные. Пароль или API-ключ Odoo хранится в конфиге клиента; создайте для агента отдельного пользователя с минимальными правами. Дополнительно можно включить разрешения и запреты на уровне полей (field-level ACL), журнал записей ODOO_MCP_AUDIT_LOG и подтверждение через форму ODOO_MCP_ELICIT_WRITES=1.
  • Локальные файлы. Загрузка вложений с диска работает только внутри папок из ODOO_MCP_ATTACHMENT_UPLOAD_ROOTS.

Частые вопросы

Какие версии Odoo поддерживаются?

Odoo 16 и новее, Community и Enterprise. Для 16–18 используется XML-RPC, для 19+ — JSON-2.

Нужно ли ставить модуль в Odoo?

Нет. Сервер работает через внешний API с вашими существующими учётными данными.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

1C MCP Toolkit

MCP и REST API сервер для баз 1С во внешней обработке: запросы, метаданные, журнал, справка BSL и выполнение кода.

Риск: high Лицензия: GPL-3.0 ★ 371

MCP BSL Platform Context

MCP-сервер со справкой по синтаксису и объектной модели платформы 1С, без доступа к базе.

Риск: medium Лицензия: MIT ★ 209

Источники