Odoo MCP
Самостоятельный MCP-сервер для Odoo: чтение и защищенная запись данных ERP через агента, любая редакция и версия
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Подключается к базе Odoo по учетным данным
- Может записывать изменения в данные ERP
- Работает с производственными системами
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/odoo-mcpОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Собрано автоматически, проверьте перед установкой.
У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.
Выполните в терминале
claude mcp add --transport stdio odoo-mcp -- uvx --setupИли добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"odoo-mcp": {
"command": "uvx",
"args": [
"--setup"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
ODOO_MCP_ELICIT_WRITESнеобязательная- Enable human-in-the-loop approval for writes
ODOO_MCP_AUDIT_LOGнеобязательная- Path to JSONL audit log file
ODOO_MCP_RATE_LIMIT_MODEнеобязательная- Rate limit mode: warn or block
ODOO_LOCALEнеобязательная- Locale for Odoo calls
MCP_CHATTER_DIRECTнеобязательная- Enable direct chatter posting bypassing approval gate
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"odoo-mcp": {
"command": "uvx",
"args": [
"--setup"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Ключи и настройки
ODOO_MCP_ELICIT_WRITESнеобязательная- Enable human-in-the-loop approval for writes
ODOO_MCP_AUDIT_LOGнеобязательная- Path to JSONL audit log file
ODOO_MCP_RATE_LIMIT_MODEнеобязательная- Rate limit mode: warn or block
ODOO_LOCALEнеобязательная- Locale for Odoo calls
MCP_CHATTER_DIRECTнеобязательная- Enable direct chatter posting bypassing approval gate
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
code --add-mcp '{"name":"odoo-mcp","type":"stdio","command":"uvx","args":["--setup"]}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"odoo-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"--setup"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Ключи и настройки
ODOO_MCP_ELICIT_WRITESнеобязательная- Enable human-in-the-loop approval for writes
ODOO_MCP_AUDIT_LOGнеобязательная- Path to JSONL audit log file
ODOO_MCP_RATE_LIMIT_MODEнеобязательная- Rate limit mode: warn or block
ODOO_LOCALEнеобязательная- Locale for Odoo calls
MCP_CHATTER_DIRECTнеобязательная- Enable direct chatter posting bypassing approval gate
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
codex mcp add odoo-mcp -- uvx --setupИли добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.odoo-mcp]
command = "uvx"
args = ["--setup"]Если файл уже есть, допишите блок в конец.
Ключи и настройки
ODOO_MCP_ELICIT_WRITESнеобязательная- Enable human-in-the-loop approval for writes
ODOO_MCP_AUDIT_LOGнеобязательная- Path to JSONL audit log file
ODOO_MCP_RATE_LIMIT_MODEнеобязательная- Rate limit mode: warn or block
ODOO_LOCALEнеобязательная- Locale for Odoo calls
MCP_CHATTER_DIRECTнеобязательная- Enable direct chatter posting bypassing approval gate
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"odoo-mcp": {
"command": "uvx",
"args": [
"--setup"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
ODOO_MCP_ELICIT_WRITESнеобязательная- Enable human-in-the-loop approval for writes
ODOO_MCP_AUDIT_LOGнеобязательная- Path to JSONL audit log file
ODOO_MCP_RATE_LIMIT_MODEнеобязательная- Rate limit mode: warn or block
ODOO_LOCALEнеобязательная- Locale for Odoo calls
MCP_CHATTER_DIRECTнеобязательная- Enable direct chatter posting bypassing approval gate
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"odoo-mcp": {
"command": "uvx",
"args": [
"--setup"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Ключи и настройки
ODOO_MCP_ELICIT_WRITESнеобязательная- Enable human-in-the-loop approval for writes
ODOO_MCP_AUDIT_LOGнеобязательная- Path to JSONL audit log file
ODOO_MCP_RATE_LIMIT_MODEнеобязательная- Rate limit mode: warn or block
ODOO_LOCALEнеобязательная- Locale for Odoo calls
MCP_CHATTER_DIRECTнеобязательная- Enable direct chatter posting bypassing approval gate
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"odoo-mcp": {
"command": "uvx",
"args": [
"--setup"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Ключи и настройки
ODOO_MCP_ELICIT_WRITESнеобязательная- Enable human-in-the-loop approval for writes
ODOO_MCP_AUDIT_LOGнеобязательная- Path to JSONL audit log file
ODOO_MCP_RATE_LIMIT_MODEнеобязательная- Rate limit mode: warn or block
ODOO_LOCALEнеобязательная- Locale for Odoo calls
MCP_CHATTER_DIRECTнеобязательная- Enable direct chatter posting bypassing approval gate
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"odoo-mcp": {
"command": "uvx",
"args": [
"--setup"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
ODOO_MCP_ELICIT_WRITESнеобязательная- Enable human-in-the-loop approval for writes
ODOO_MCP_AUDIT_LOGнеобязательная- Path to JSONL audit log file
ODOO_MCP_RATE_LIMIT_MODEнеобязательная- Rate limit mode: warn or block
ODOO_LOCALEнеобязательная- Locale for Odoo calls
MCP_CHATTER_DIRECTнеобязательная- Enable direct chatter posting bypassing approval gate
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"odoo-mcp": {
"type": "local",
"command": [
"uvx",
"--setup"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Ключи и настройки
ODOO_MCP_ELICIT_WRITESнеобязательная- Enable human-in-the-loop approval for writes
ODOO_MCP_AUDIT_LOGнеобязательная- Path to JSONL audit log file
ODOO_MCP_RATE_LIMIT_MODEнеобязательная- Rate limit mode: warn or block
ODOO_LOCALEнеобязательная- Locale for Odoo calls
MCP_CHATTER_DIRECTнеобязательная- Enable direct chatter posting bypassing approval gate
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"odoo-mcp": {
"command": "uvx",
"args": [
"--setup"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Ключи и настройки
ODOO_MCP_ELICIT_WRITESнеобязательная- Enable human-in-the-loop approval for writes
ODOO_MCP_AUDIT_LOGнеобязательная- Path to JSONL audit log file
ODOO_MCP_RATE_LIMIT_MODEнеобязательная- Rate limit mode: warn or block
ODOO_LOCALEнеобязательная- Locale for Odoo calls
MCP_CHATTER_DIRECTнеобязательная- Enable direct chatter posting bypassing approval gate
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"odoo-mcp": {
"command": "uvx",
"args": [
"--setup"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
ODOO_MCP_ELICIT_WRITESнеобязательная- Enable human-in-the-loop approval for writes
ODOO_MCP_AUDIT_LOGнеобязательная- Path to JSONL audit log file
ODOO_MCP_RATE_LIMIT_MODEнеобязательная- Rate limit mode: warn or block
ODOO_LOCALEнеобязательная- Locale for Odoo calls
MCP_CHATTER_DIRECTнеобязательная- Enable direct chatter posting bypassing approval gate
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Поставь MCP-сервер: pip install odoo-mcp. Пропиши в конфигурации MCP запуск python -m odoo_mcp и переменные ODOO_URL, ODOO_DB, ODOO_USERNAME, ODOO_PASSWORD.
Другие способы из описания автора
pip install odoo-mcpУстанавливает MCP-сервер из PyPI, запуск командой python -m odoo_mcp.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключает Odoo к агенту по протоколу MCP и дает инструменты для работы с моделями ERP: чтение записей, поиск, диагностика и запись с ограничениями. Записи проходят через защитный слой, поэтому агент не меняет данные бесконтрольно. Поддерживаются несколько экземпляров Odoo и редакции Community и Enterprise начиная с версии 16. Запускается локально по stdio, ставится из PyPI или через Docker, подключается к вашему серверу Odoo по XML-RPC или JSON-RPC. У того же автора есть отдельный размещенный продукт-шлюз, но этот репозиторий остается самостоятельным сервером для локального запуска.
Для кого. Для команд на Odoo, которым нужно, чтобы агент читал и аккуратно менял данные ERP.
Подходит, если
- Нужно спрашивать у агента данные из Odoo: заказы, товары, контакты
- Нужна защищенная запись изменений в Odoo через агента
- Нужно подключить несколько экземпляров Odoo к одному агенту
Не подходит, если
- У вас не Odoo, а другая ERP
- Нельзя давать агенту доступ к производственной базе даже с ограничениями
Пример запроса к агенту
Покажи из Odoo неоплаченные счета за прошлый месяц по этому клиентуОграничения
Сервер подключается к вашему экземпляру Odoo и требует URL, базу, пользователя и пароль или API-ключ, поэтому доступ надо давать осознанно. Даже с защитой записи агент работает с данными ERP, что для боевой базы это высокий риск. Размещенный шлюз ERPipe это отдельный платный продукт вне этого репозитория. Работа зависит от совместимости версии Odoo и транспорта XML-RPC или JSON-RPC.
Как отключить. Уберите сервер odoo из конфигурации MCP клиента и удалите пакет: pip uninstall odoo-mcp или остановите контейнер Docker.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| ODOO_URL обязательная | Адрес вашего экземпляра Odoo |
| ODOO_DB обязательная | Имя базы данных Odoo |
| ODOO_USERNAME обязательная | Пользователь Odoo |
| ODOO_PASSWORD обязательная, секрет | Пароль или API-ключ пользователя |
| ODOO_TRANSPORT | Транспорт подключения: xmlrpc или jsonrpc |
Проверка безопасности
- Подключается к базе Odoo по учетным данным
- Может записывать изменения в данные ERP
- Работает с производственными системами
Коротко о README
README представляет свободный слой ИИ для Odoo: сервер дает Community и Enterprise возможности, которые в самой Odoo доступны только в Enterprise. Установка занимает несколько минут, есть варианты pip install odoo-mcp, запуск через uvx и Docker, а также фрагмент конфигурации mcpServers с переменными подключения. Записи защищены, поддерживаются диагностика и несколько экземпляров. Репозиторий это локальный сервер на Python, а размещенный шлюз ERPipe вынесен в отдельный продукт. Лицензия MIT, пакет опубликован на PyPI.
Частые вопросы
Чем этот репозиторий отличается от ERPipe?
Здесь самостоятельный сервер для локального запуска по stdio с полным набором инструментов. ERPipe это отдельный размещенный шлюз того же автора с удаленным адресом.
Какие версии Odoo поддержаны?
Community и Enterprise начиная с версии 16, подключение по XML-RPC или JSON-RPC.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма