OpenCode용 Odoo MCP 서버

이 워스페이스에는 자체 호스틸 Odoo 프로젝트의 작업, 채터(chatter), 타임시트를 에이전트가 출출할 수 있는 타입이 지정된 여級 개의 도구로 노출하는 로컬 clo CP 서버 (odoo_mcp)가 들어 있습니다. Aff아 저장소에 есть 원본 odoo_tasks.py CLI이 그대로 유지되어 있으며, 동작은 바지 않았고 MCP 서버와 서비스 층을 박합니다.

사전 준비 사항

• Python 3.10+ (워크스페이스는 3.12를 기주으로 개발됨)

• uv on PATH (없Il시 pip install uv)

단, install following:

uv sync

Related MCP server: MCP Server for Odoo

자력 증명(환경 변수)

ODOO_URL는 자격 증명 정보가 평문 HTTP를 통해 전송되지 않도록 절대 HTTPS URL이어야 합니다.

API 키 테스트 (Odoo: Preferences → Account Security → New API Key): it is 등록에, 해지 가능 하고 웹 로그인에는 사렇지 못합니다. .env.example를 .env로 복사한 후 작성고 여기에 env 파일들을 자동 로드합니다. OpenCode나 는 이미 설한 환경 변수가 우 순입니다. .env은 절대 커밋하지 마세요.

보간 주의 사항: opencode.json은 {env:VAR} 자리표시자를 사용합니다. 어떤 변수가 없어 OpenCode가 시작할 경우에 빌(обстр), 모든 도구 호出是성인 in zero. (Missing required environment variables: ODOO_USERNAME, ...). Values는 never echo에 logs or results.

OpenCode에 등록

이 워스페이스의 opencode.json에는 이미 다음 내용이 포함되어 있습니다:

{
  "mcp": {
    "odoo": {
      "type": "local",
      "command": ["uv", "run", "python", "-m", "odoo_mcp"],
      "environment": { "...": "{env:ODOO_*} placeholders" },
      "enabled": true
    }
  }
}

OpenCode는 시작 시 구성을 로드합니다. 자격 증명 또는 이 파일을 변환한 후에는 변경 사항이 적용되도록 OpenCode를 종류 고 다시 시작해 주세요. 서버는 세성당 stdio로 한 번만 생성되며, network 포트를 리슨하지 않습니다.

도구

변형 도구는 기본적으로 즉시 실행됩니다**. 각 도구에는 아무 것도 기록하지 않고 미리 보기를 받는 dry_run=true 플래가 있습니다.

State code varies by Odoo build — don't guess it: get_task_states first; inuvalid one is rejected with the valid list.

설치 확인

uv sync                                              # deps resolve
uv run pytest tests -q                               # protocol + service suites
uv run python -m unittest discover -s tests -v       # CLI characterization suite
uv run python odoo_tasks.py --help                   # legacy CLI still intact

stdio handshake itself is covered by tests/test_stdio_smoke.py.