Claude–Odoo 19 OAuth 読み取り専用 MCP コネクタ

OAuth対応版の読み取り専用Odoo 19 MCPコネクタです。

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

重要なアーキテクチャ

PythonサービスはOAuth リソースサーバーです。Microsoft Entra ID、Auth0、Okta、またはその他の互換性のあるIDプロバイダーなどの外部OAuth/OIDC認可サーバーによって発行されたベアラートークンを検証します。

Odoo APIキーはPythonコネクタサーバー上にのみ保持されます。

Related MCP server: Odoo MCP Server

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

次に、MCP Inspectorを使用して http://127.0.0.1:8000/mcp をテストします。

OAuth設定

クライアントのIDプロバイダーにAPI/リソースとOAuthクライアントを登録します。プロバイダーは以下を含むJWTアクセストークンを発行する必要があります：

• iss が AUTH_ISSUER_URL と一致

• aud が AUTH_AUDIENCE と一致

• exp

• 必要なスコープ（デフォルトは 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検出に使用する保護リソースメタデータを公開します。認可サーバー自体は外部のままです。

Claude

追加：

https://YOUR_PUBLIC_HOST/mcp

IDプロバイダーが動的クライアント登録をサポートしていない場合は、Claudeコネクタの詳細設定でOAuthクライアントIDとクライアントシークレットを追加します。

その後、認可された各Claudeユーザーは「接続」をクリックし、設定されたIDプロバイダーを通じてサインインします。

Dev Tunnel

パブリックなVS Code Dev Tunnelをステージング用に一時的に使用できます。そのURLが変更された場合は、AUTH_RESOURCE_SERVER_URLと通常はAUTH_AUDIENCEも更新してください。

公開アクセス可能な永続的なMCPデプロイメントでは、AUTH_ENABLED=falseのままにしないでください。

peltierpro-mcp