erpipe-org/mcp-odoo

해결하는 문제

Odoo MCP는 Odoo 16+ (커뮤니티 및 엔터프라이즈 버전 모두)에 무료 AI 계층을 제공하여, 고가의 엔터프라이즈 전용 AI 기능이나 복잡한 Odoo 측 모듈 설치 없이 LLM이 Odoo 데이터베이스와 상호작용할 수 있도록 합니다. AI 에이전트(Claude, GPT, Gemini 등)와 Odoo 데이터 간의 격차를 메우며, 안전하게 쿼리, 감사, 관리형 쓰기 작업을 수행할 수 있게 합니다.

작동 방식

이 프로젝트는 Odoo 16-18 버전에서는 XML-RPC, Odoo 19+ 버전에서는 External JSON-2를 통해 Odoo에 연결하는 Model Context Protocol (MCP) 서버로 작동합니다. AI 에이전트가 41개의 도구에 접근할 수 있도록 제공하여, 레코드 읽기, 스키마 검사, 진단 작업을 수행할 수 있게 합니다. 보안을 위해 기본적으로 직접 쓰기 접근은 차단되며, 쓰기 작업은 승인 토큰, 실시간 메타데이터 검증, 그리고 선택적 인간-중개 확인 양식을 포함한 게이트된 워크플로우를 필요로 합니다.

대상 사용자

• Odoo 사용자: 무료로 자신의 Odoo 인스턴스에 AI 기능을 추가하고 싶은 사용자
• AI 에이전트 사용자: Cursor나 Claude Code와 같은 IDE를 사용하며 실시간 Odoo 컨텍스트가 필요한 사용자
• Odoo 개발자/파트너: 마이그레이션 감사, 데이터 품질 검사, 여러 고객 데이터베이스 간 크로스 인스턴스 쿼리에 필요한 도구가 필요한 전문가

주요 특징

• Odoo 측 설정 없음: 기존 자격 증명만으로 작동. App Store 모듈이나 관리자 접근 권한이 필요 없음.
• 안전한 쓰기 워크플로우: 승인 토큰과 인간-중개 확인(HITL)을 포함한 게이트된 시스템으로 실수로 인한 데이터 손상 방지.
• 포괄적인 도구 세트: 레코드 읽기, 서버 사이드 집계, 채터 통합, 로컬 우선 BM25 지식 검색을 포함한 41개의 도구 제공.
• 다중 인스턴스 지원: 하나의 서버로 여러 명명된 Odoo 인스턴스를 동시에 관리하고 쿼리 가능.
• 고급 진단 기능: 업그레이드 리스크 보고서, 피트-갭 분석, Odoo 19 JSON-2 마이그레이션 도우미 전용 도구 제공.
• 필드 수준 ACL: 인스턴스 또는 모델 단위로 선택적으로 필드 허용/차단 목록을 설정하여 데이터 접근 제한 가능.