odoo-mcp — MCP-сервер для Claude Code: установка и функции
Подключает Claude Code и другие MCP-клиенты к Odoo 18 через stdio для работы с CRM, продажами, счетами, задачами и складом.
claude mcp add --env ODOO_URL=<ODOO_URL> --env ODOO_DB=<ODOO_DB> --env ODOO_USERNAME=<ODOO_USERNAME> --env ODOO_PASSWORD=<ODOO_PASSWORD> --env ODOO_MCP_DEFAULT_LIMIT=<ODOO_MCP_DEFAULT_LIMIT> --transport stdio odoo-mcp -- uvx odoo-18-mcp-serverЧто делает odoo-mcp
odoo-mcp подключает MCP-клиенты к Odoo 18 через stdio. Сервер умеет искать и изменять записи, создавать продажи, закупки, счета, задачи, обращения в поддержку и события календаря. Есть инструменты для партнёров, платежей, проектов, контрактов, складских остатков и схем моделей.
Доступ к Odoo задаётся переменными ODOO_URL, ODOO_DB, ODOO_USERNAME и ODOO_PASSWORD. Запуск выполняется через uvx odoo-18-mcp-server; клиент получает инструменты и ресурсы через MCP. Запросы проходят проверку Pydantic, модели ограничены списком разрешённых, чувствительные поля закрыты, а unlink заблокирован.
Аргументы инструмента нужно передавать внутри верхнего объекта payload, иначе проверка завершится ошибкой. Для части функций требуются соответствующие приложения или модули Odoo 18, поэтому набор доступных действий зависит от подключённого экземпляра.
Какие задачи решает
- искать клиентов и поставщиков по имени, VAT или email
- создавать и подтверждать заказы на продажу
- регистрировать платежи по счетам
- создавать задачи, активности и обращения в поддержку
- проверять схему модели и доступные возможности Odoo
Примеры запросов агенту
- Найди клиента по email в Odoo и покажи краткую сводку партнёра.
- Создай коммерческое предложение с товарами и подтверди его после моей проверки.
- Покажи незакрытые активности и создай задачу в нужном проекте.
Как установить odoo-mcp
Командой платформы
claude mcp add --env ODOO_URL=<ODOO_URL> --env ODOO_DB=<ODOO_DB> --env ODOO_USERNAME=<ODOO_USERNAME> --env ODOO_PASSWORD=<ODOO_PASSWORD> --env ODOO_MCP_DEFAULT_LIMIT=<ODOO_MCP_DEFAULT_LIMIT> --transport stdio odoo-mcp -- uvx odoo-18-mcp-serverВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from odoo-18-mcp-server <команда>
Командой платформы
codex mcp add odoo-mcp --env ODOO_URL=<ODOO_URL> --env ODOO_DB=<ODOO_DB> --env ODOO_USERNAME=<ODOO_USERNAME> --env ODOO_PASSWORD=<ODOO_PASSWORD> --env ODOO_MCP_DEFAULT_LIMIT=<ODOO_MCP_DEFAULT_LIMIT> -- uvx odoo-18-mcp-serverВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from odoo-18-mcp-server <команда>
Файл настроек
{
"mcpServers": {
"odoo-mcp": {
"command": "uvx",
"args": [
"odoo-18-mcp-server"
],
"env": {
"ODOO_URL": "<ODOO_URL>",
"ODOO_DB": "<ODOO_DB>",
"ODOO_USERNAME": "<ODOO_USERNAME>",
"ODOO_PASSWORD": "<ODOO_PASSWORD>",
"ODOO_MCP_DEFAULT_LIMIT": "<ODOO_MCP_DEFAULT_LIMIT>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from odoo-18-mcp-server <команда>
Файл настроек
{
"servers": {
"odoo-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"odoo-18-mcp-server"
],
"env": {
"ODOO_URL": "<ODOO_URL>",
"ODOO_DB": "<ODOO_DB>",
"ODOO_USERNAME": "<ODOO_USERNAME>",
"ODOO_PASSWORD": "<ODOO_PASSWORD>",
"ODOO_MCP_DEFAULT_LIMIT": "<ODOO_MCP_DEFAULT_LIMIT>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from odoo-18-mcp-server <команда>
Командой платформы
gemini mcp add -e ODOO_URL=<ODOO_URL> -e ODOO_DB=<ODOO_DB> -e ODOO_USERNAME=<ODOO_USERNAME> -e ODOO_PASSWORD=<ODOO_PASSWORD> -e ODOO_MCP_DEFAULT_LIMIT=<ODOO_MCP_DEFAULT_LIMIT> odoo-mcp uvx odoo-18-mcp-serverВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from odoo-18-mcp-server <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о odoo-mcp
Как установить odoo-mcp в Claude Code?
Выполните `claude mcp add odoo-mcp -e ODOO_URL=<ODOO_URL> -e ODOO_DB=<ODOO_DB> -e ODOO_USERNAME=<ODOO_USERNAME> -e ODOO_PASSWORD=<ODOO_PASSWORD> -- uvx odoo-18-mcp-server`.
Что делает odoo-mcp?
Сервер даёт агенту доступ к операциям Odoo 18: поиску и изменению записей, продажам, закупкам, счетам, задачам, поддержке и другим бизнес-сценариям.
Что нужно для работы odoo-mcp с Odoo?
Нужны адрес Odoo, имя базы, пользователь и пароль в ODOO_URL, ODOO_DB, ODOO_USERNAME и ODOO_PASSWORD. Для отдельных инструментов требуются соответствующие приложения или модули Odoo 18.
