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 권한 부여 서버에서 발급한 Bearer 토큰을 검증합니다.

Odoo API 키는 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

그런 다음 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 사용자가 Connect를 클릭하고 구성된 ID 공급자를 통해 로그인합니다.

Dev Tunnel

퍼블릭 VS Code Dev Tunnel을 스테이징 용도로 일시적으로 사용할 수 있습니다. URL이 변경되면 AUTH_RESOURCE_SERVER_URL과 일반적으로 AUTH_AUDIENCE도 업데이트합니다.

공개적으로 접근 가능한 영구 MCP 배포에서 AUTH_ENABLED=false로 두지 마십시오.

peltierpro-mcp