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 в конфиге.
Настройка клиентов
{
"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 и выполнение кода.
MCP BSL Platform Context
MCP-сервер со справкой по синтаксису и объектной модели платформы 1С, без доступа к базе.
Spree Commerce: открытая платформа электронной коммерции для B2B и маркетплейсов
Открытая платформа электронной коммерции Spree для B2B и маркетплейсов.
Spree Commerce: документация для ИИ-агентов
Документация Spree Commerce для агентов-программистов.