mcp-odoo — MCP-сервер для Claude Code: что делает и установка
Подключает Odoo к ИИ-агенту через MCP: читает данные, проверяет схемы и проводит записи через защитный шлюз.
claude mcp add mcp-odoo -e ODOO_URL=<ODOO_URL> -e ODOO_DB=<ODOO_DB> -e ODOO_USERNAME=<ODOO_USERNAME> -e ODOO_PASSWORD=<ODOO_PASSWORD> -- uvx odoo-mcpЧто делает mcp-odoo
mcp-odoo превращает базу Odoo 16+ в MCP-сервер для Claude Code и других клиентов. Он работает с XML-RPC в Odoo 16–18 и с External JSON-2 в Odoo 19+, читает записи и вложения, проверяет схемы, диагностирует вызовы и помогает искать риски обновления модулей.
В локальную сборку входят 41 MCP-инструмент и 11 промптов для рабочих процессов, включая проверку качества данных и закрытие месяца. Сервер умеет обращаться к нескольким именованным экземплярам Odoo, выполнять поиск по индексированным данным и запускать долгие операции через фоновые задачи.
Для подключения нужны ODOO_URL, ODOO_DB, ODOO_USERNAME и ODOO_PASSWORD. Записи проходят через переменные окружения и токены подтверждения, поэтому без этих учётных данных сервер не сможет обратиться к Odoo.
Какие задачи решает
- читать записи и вложения из Odoo
- проверять схему и права доступа
- искать данные по нескольким экземплярам
- проверять аддоны перед обновлением Odoo
- проводить записи через подтверждение
Примеры запросов агенту
- Покажи клиентов из Испании с неоплаченными счетами в Odoo.
- Найди товары, у которых запас ниже 10 единиц на главном складе.
- Проверь аддон
custom_billingна риски перед переходом на Odoo 19.
Как установить mcp-odoo
Командой платформы
claude mcp add mcp-odoo -e ODOO_URL=<ODOO_URL> -e ODOO_DB=<ODOO_DB> -e ODOO_USERNAME=<ODOO_USERNAME> -e ODOO_PASSWORD=<ODOO_PASSWORD> -- uvx odoo-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from odoo-mcp <команда>
Командой платформы
codex mcp add mcp-odoo --env ODOO_URL=<ODOO_URL> --env ODOO_DB=<ODOO_DB> --env ODOO_USERNAME=<ODOO_USERNAME> --env ODOO_PASSWORD=<ODOO_PASSWORD> -- uvx odoo-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from odoo-mcp <команда>
Файл настроек
{
"mcpServers": {
"mcp-odoo": {
"command": "uvx",
"args": [
"odoo-mcp"
],
"env": {
"ODOO_URL": "<ODOO_URL>",
"ODOO_DB": "<ODOO_DB>",
"ODOO_USERNAME": "<ODOO_USERNAME>",
"ODOO_PASSWORD": "<ODOO_PASSWORD>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from odoo-mcp <команда>
Файл настроек
{
"servers": {
"mcp-odoo": {
"type": "stdio",
"command": "uvx",
"args": [
"odoo-mcp"
],
"env": {
"ODOO_URL": "<ODOO_URL>",
"ODOO_DB": "<ODOO_DB>",
"ODOO_USERNAME": "<ODOO_USERNAME>",
"ODOO_PASSWORD": "<ODOO_PASSWORD>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from odoo-mcp <команда>
Командой платформы
gemini mcp add -e ODOO_URL=<ODOO_URL> -e ODOO_DB=<ODOO_DB> -e ODOO_USERNAME=<ODOO_USERNAME> -e ODOO_PASSWORD=<ODOO_PASSWORD> mcp-odoo uvx odoo-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from odoo-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-odoo
Как установить mcp-odoo в Claude Code?
Выполните `claude mcp add mcp-odoo -e ODOO_URL=<ODOO_URL> -e ODOO_DB=<ODOO_DB> -e ODOO_USERNAME=<ODOO_USERNAME> -e ODOO_PASSWORD=<ODOO_PASSWORD> -- uvx odoo-mcp`. Команда добавит локальный MCP-сервер с учётными данными Odoo.
Что делает mcp-odoo?
Он подключает Odoo к MCP-клиенту, даёт инструменты для чтения данных, диагностики, поиска по схеме и проверки аддонов. Запись выполняется через защитный шлюз с подтверждением.
Какие версии Odoo поддерживает mcp-odoo?
Сервер рассчитан на Odoo 16 и новее: для Odoo 16–18 используется XML-RPC, а для Odoo 19 и новее — External JSON-2.
