Claude–Odoo 19 OAuth Read-Only MCP Connector

OAuth-fähige Version des schreibgeschützten Odoo 19 MCP Connectors.

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

Wichtige Architektur

Der Python-Dienst fungiert als OAuth-Ressourcenserver. Er validiert Bearer-Token, die von einem externen OAuth/OIDC-Autorisierungsserver wie Microsoft Entra ID, Auth0, Okta oder einem anderen kompatiblen Identitätsanbieter ausgestellt wurden.

Der Odoo-API-Schlüssel verbleibt ausschließlich auf dem Python-Connector-Server.

Related MCP server: MCP Server for Odoo

Odoo-Werkzeuge

• test_odoo_connection

• search_crm_opportunities

• get_crm_opportunity

• search_sales_orders

• get_sales_order

• search_products

• get_stock_by_location

• search_inventory_transfers

Es sind keine Odoo-Werkzeuge zum Erstellen/Aktualisieren/Löschen/Bestätigen/Validieren/Stornieren enthalten.

Installation unter Windows

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

Erster lokaler Test

Behalten:

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

Ausführen:

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

Dann testen Sie http://127.0.0.1:8000/mcp mit dem MCP Inspector.

OAuth-Konfiguration

Registrieren Sie eine API/Ressource und einen OAuth-Client beim Identitätsanbieter des Clients. Der Anbieter muss JWT-Zugriffstoken ausstellen, die Folgendes enthalten:

• iss – muss AUTH_ISSUER_URL entsprechen

• aud – muss AUTH_AUDIENCE entsprechen

• exp

• erforderlicher Bereich, standardmäßig odoo.read

Konfigurieren Sie dann:

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

Neustart:

python -m app.server

Das MCP SDK veröffentlicht Metadaten der geschützten Ressource, die von Claude für die OAuth-Erkennung verwendet werden. Der Autorisierungsserver selbst bleibt extern.

Claude

Hinzufügen:

https://YOUR_PUBLIC_HOST/mcp

Wenn der Identitätsanbieter keine dynamische Client-Registrierung unterstützt, fügen Sie die OAuth-Client-ID und das OAuth-Client-Geheimnis in den erweiterten Einstellungen des Claude Connectors hinzu.

Jeder autorisierte Claude-Benutzer klickt dann auf „Verbinden“ und meldet sich über den konfigurierten Identitätsanbieter an.

Dev Tunnel

Ein öffentlicher VS Code Dev Tunnel kann vorübergehend für das Staging verwendet werden. Wenn sich seine URL ändert, aktualisieren Sie AUTH_RESOURCE_SERVER_URL und in der Regel auch AUTH_AUDIENCE.

Lassen Sie AUTH_ENABLED=false nicht auf einer öffentlich zugänglichen, dauerhaften MCP-Bereitstellung.

peltierpro-mcp