Мост MCP Odoo ↔ Claude — руководство по развертыванию

Этот небольшой проект связывает ваш инстанс Odoo (via-italia.odoo.com) с Claude, чтобы я мог читать/писать напрямую в Odoo (склад, счета, клиенты, напоминания) без необходимости кликать в интерфейсе.

Он постоянно работает на облачном хостинге (Render, бесплатно для начала). Claude подключается к нему через полноценную аутентификацию (OAuth): при первом подключении страница входа запросит ваш секретный токен; после этого Claude остаётся подключённым автоматически, и секрет никогда не появляется в URL.

Никаких команд Git не требуется: всё делается в браузере.

Шаг 0 — что вам нужно перед началом

• Ключ API Odoo, созданный в via-italia.odoo.com (Мои настройки → Безопасность аккаунта → Новый ключ API). Держите его под рукой, вы вставите его на шаге 3.

• Секретный токен для защиты доступа. Сгенерируйте его сейчас (делитесь им только с Render, нигде больше):

  • На Mac: откройте Terminal и введите openssl rand -hex 24, скопируйте результат.

  • В противном случае: подойдёт любой генератор паролей, выдающий ~40 случайных символов.

Related MCP server: odoo-mcp-server

Шаг 1 — загрузить эти файлы на GitHub (без Git)

1. Перейдите на github.com и создайте бесплатную учётную запись, если у вас её нет.

2. Нажмите New repository. Имя: odoo-mcp-bridge (или какое хотите). Оставьте его Public (необходимо для развертывания Render без привязки аккаунта). Больше ничего не отмечайте. Create repository.

3. На странице нового пустого репозитория нажмите uploading an existing file.

4. Перетащите 6 файлов из этой папки (Dockerfile, proxy.py, oauth_provider.py, requirements.txt, start.sh, README.md) в область загрузки.

5. Commit changes.

Запишите URL репозитория, вида https://github.com/VOTRE-COMPTE/odoo-mcp-bridge.

Шаг 2 — создать сервис на Render

1. Перейдите на render.com и создайте бесплатную учётную запись.

2. New + → Web Service.

3. Выберите Public Git Repository и вставьте URL GitHub-репозитория из шага 1. Connect.

4. Имя сервиса: via-italia-odoo-mcp (или другое).

5. Render автоматически определяет Dockerfile — оставьте режим Docker.

6. Тип инстанса: Free для начала (достаточно для тестирования).

Шаг 3 — переменные окружения

На этой же странице создания разверните Advanced → Add Environment Variable и добавьте:

(ODOO_DB не нужен, Odoo определяет его автоматически.)

Нажмите Create Web Service. Первое развертывание занимает 2-3 минуты — вы увидите, как прокручиваются логи сборки.

Шаг 4 — проверить, что всё работает

Когда развертывание получит статус "Live", ваш сервис будет иметь адрес вида https://via-italia-odoo-mcp.onrender.com.

Сначала проверьте https://via-italia-odoo-mcp.onrender.com/healthz в браузере: вы должны увидеть ok.

Адрес вашего коннектора (тот, который нужно дать Claude) — просто:

https://via-italia-odoo-mcp.onrender.com/mcp

В этом URL нет токена — его можно безопасно передавать, защита происходит на следующем шаге.

Шаг 5 — подключение Claude

В Claude: Customize → Connectors → "+" → Add custom connector, вставьте URL из шага 4, Add, затем нажмите Подключить.

Откроется страница входа, которая запросит ваш BRIDGE_SECRET (токен, сгенерированный на шаге 0) — введите его и подтвердите. После этого Claude остаётся подключённым; вам не придётся делать это снова, если только вы не переразвернёте сервис (это стирает сессию из памяти).

Затем вернитесь в разговор с Claude и попросите его проверить подключение (например: «список моих последних коммерческих предложений Odoo»).

Шаг 6 — переход к чтению/записи

Когда чтение заработает и вы освоитесь, вернитесь в Render → ваш сервис → Environment, измените ODOO_YOLO с read на true и переразверните (Render сделает это автоматически после изменения переменной). Тогда Claude сможет также создавать счета, обновлять запасы и т. д. — активируйте это только тогда, когда вы готовы к тому, что он будет реально писать в Odoo.

Ограничения, которые стоит знать

• Бесплатный план Free Render переводит сервис в спящий режим после 15 минут без трафика: первый запрос после паузы занимает 30-60 секунд, пока он просыпается. Для более плавного повседневного использования платный план (~7 $/мес) отключает этот спящий режим.

• Сессии (выданные OAuth-токены) хранятся в памяти сервиса, а не на диске: переразвертывание или перезапуск стирает их, и придётся заново выполнить «Подключить» в Claude (просто заново ввести BRIDGE_SECRET, ничего больше).