Claude–Odoo 19 OAuth Read-Only MCP Connector

OAuth-включенная версия коннектора MCP для Odoo 19 только для чтения.

Claude
  -> OAuth 2.1 access token
  -> Python MCP Resource Server
  -> Odoo JSON-2 API

Важная архитектура

Сервис Python является OAuth Resource Server. Он проверяет bearer токены, выпущенные внешним OAuth/OIDC Authorization Server, таким как Microsoft Entra ID, Auth0, Okta или другой совместимый провайдер идентификации.

Ключ API Odoo остается только на сервере коннектора Python.

Related MCP server: MCP Server for Odoo

Инструменты Odoo

• test_odoo_connection

• search_crm_opportunities

• get_crm_opportunity

• search_sales_orders

• get_sales_order

• search_products

• get_stock_by_location

• search_inventory_transfers

Никакие инструменты Odoo для создания/обновления/удаления/подтверждения/проверки/отмены не включены.

Установка на Windows

py -m venv .venv
.venv\Scripts\Activate.ps1
pip install -r requirements.txt
Copy-Item .env.example .env

Первый локальный тест

Сохраните:

AUTH_ENABLED=false
TRANSPORT=streamable-http
HOST=0.0.0.0
PORT=8000

Запустите:

python test_connection.py
python -m unittest discover -s tests
python -m app.server

Затем протестируйте http://127.0.0.1:8000/mcp с помощью MCP Inspector.

Конфигурация OAuth

Зарегистрируйте API/ресурс и OAuth-клиент у провайдера идентификации клиента. Провайдер должен выдавать JWT access токены, содержащие:

• iss, совпадающий с AUTH_ISSUER_URL

• aud, совпадающий с AUTH_AUDIENCE

• exp

• required scope, по умолчанию odoo.read

Затем настройте:

AUTH_ENABLED=true
AUTH_ISSUER_URL=https://auth.example.com
AUTH_RESOURCE_SERVER_URL=https://YOUR_PUBLIC_HOST/mcp
AUTH_JWKS_URL=https://auth.example.com/.well-known/jwks.json
AUTH_AUDIENCE=https://YOUR_PUBLIC_HOST/mcp
AUTH_REQUIRED_SCOPES=odoo.read
AUTH_ALGORITHMS=RS256

Перезапустите:

python -m app.server

MCP SDK будет публиковать метаданные защищенного ресурса, используемые Claude для обнаружения OAuth. Сам Authorization Server остается внешним.

Claude

Добавьте:

https://YOUR_PUBLIC_HOST/mcp

Если провайдер идентификации не поддерживает динамическую регистрацию клиента, добавьте OAuth Client ID и Client Secret в расширенные настройки коннектора Claude.

Затем каждый авторизованный пользователь Claude нажимает Connect и входит через настроенного провайдера идентификации.

Dev Tunnel

Публичный VS Code Dev Tunnel можно временно использовать для промежуточного тестирования. Если его URL изменится, обновите AUTH_RESOURCE_SERVER_URL и, как правило, также AUTH_AUDIENCE.

Не оставляйте AUTH_ENABLED=false на публично доступном постоянном развертывании MCP.

peltierpro-mcp