Odoo MCP server für OpenCode

Dieses Workspace enthält einen lokalen stdio-MCP-Server (odoo_mcp), der die Aufgaben, den Chatter und die Zeiterfassung Ihres selbst gehosteten Odoo-Projekt als neun typisierte Tools bereitstellt, die ein Agent direkt aufrufen kann. Dasselbe Repositorio enthält weiterhin das ursprüngliche odoo_tasks.py- CLI — verhaltensmäßig unverändert —, das sich die Service-Schicht mit dem MCP-Server teilt.

Voraussetzungen

• Python 3.10+ (das Workspace wurde gegen 3.12 entwickelt)

• uv im PATH (pip install uv, falls fehlt)

Installeren Sie einmal alles:

uv sync

Related MCP server: MCP Server for Odoo

Zugangsdaten (Umgebungsvariablen)

ODOO_URL muss aine absolute HTTPS-URL sein, damit Zugangsdaten nie über ein unverschlüsseltes HTTP übertragen werden.

dringend empfohlen (Odoo: Einstellungen → Kontosicherheit → Neuer API-Schlüssel). Er ist widerrufbar und kann nicht für die Web-Anmeldung verwendet werden. Kopieren Sie .env.example in eine neue Datei .env, füllen Sie sie aus und laden Sie sie in Ihre Shell, oder setzen Sie die Variablenauch so, wie Sie Geheimnisse verwalten. Der MCP-Server und der CLI-helper laden automatisch eine .env im Workspace-Stammverzeichnis, falls vorhanden; bereits Umgebungsvariablen, die OpenCode oder die Shell gesetzt hat, haben Vorrang. Committen Sie .env niemals.

Hinweis zur Interpolation: opencode.json verwendet den Platzhalter {env:VAR}. Fehlt eine Variable wenn OpenCode startet, wirdsie zu einem leeren String, und jeder Tool-Aufruf schlägt fehl mit einem klaren Fehler, der die fehlende(n) Variable(n) benennt (Missing required environment variables: ODOO_USERNAME, ...), statt falsche Zugangsdaten zu senden. Werte werden nie in Logs oder Ergebnissen ausgegeben.

Registrierung bei OpenCode

opencode.json in diesem Workspace enthält bereits:

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

OpenCode lädt config beim Start — nach dem Ändern von Zugangsdaten oder dieser Datei beenden Sie OpenCode und starten Sie es neu, damit sie wirksam werden. Der Server wird pro Sitzung einmal über stdio gestartet; nichts lauscht auf einem Netzwerkport.

Tools

Tools, die schreiben, führen standardmäßig sofort aus; jedes akzeptiert zusätzlich ein dry_run=true-Flag und gibt dann eine Vorschau zurück, ohne zu schreiben.

Die Statecodes sind je nach Odoo-Build unterschiedlich — rufen Sie zuerst get_task_states auf, statt zu raten; ungültige Zustände werden abgelehnt und es wird zwaride Liste der gültigen mitgeliefert.

Prüfung der Installation

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

Der stdio-Handshake selbst wird durch tests/test_stio_smoke.py abgedeckt.