Troubleshooting and FAQ

Question-form headings so you can find your case quickly.

Why does my API key stop working in Odoo 17 or higher?

Starting with Odoo 17, the /jsonrpc endpoint rejects API keys. The server detects it and automatically falls back to XML-RPC (it pins XML-RPC after the first fallback and warns once). You do not need to do anything; if you want to force it, set ODOO_TRANSPORT_PREF=xmlrpc.

I get "database not found"

The database name is incorrect. Check it in Settings → Database or in the login URL. ODOO_DB must match exactly.

A field appears in dropped_fields and not in the result

That field does not exist in the target version. This is the expected behavior: instead of failing the whole query, the server drops the unavailable field and reports it. Check the Compatibility table for the equivalent modern name (e.g. analytic_account_id → analytic_distribution in v16).

I get a CompatError about an Enterprise model

You are querying an Enterprise-exclusive model (e.g. helpdesk.ticket, sign.request) against an instance detected as Community. Runtime module probing is the authority: if the module is not installed, the model is not available.

Do I need an API key or can I use a password?

• Odoo ≥ 14: use an API key (recommended), variable ODOO_API_KEY.
• Odoo < 14: there are no API keys; use ODOO_PASSWORD.

Set one of the two.

uvx is not installed

Install uv (official guide) or use Python 3.11+ directly: cd server && pip install -e . && python -m odoo_mcp.

I don't have Python, only Node

Use the Fallback CLI: /odoo-tools:odoo-setup-cli (Node.js 18+).

How do I verify that everything is set up correctly?

Run /odoo-doctor or call odoo_version. A response with version, edition, deployment and transport confirms the end-to-end connection. See Connection and discovery.

Is my company's data sent to Anthropic?

No. The server runs on your infrastructure and talks directly to your Odoo. See Security.

Does it work with agents other than Claude?

Yes: with any client that implements the MCP protocol. Claude Code is the reference environment the plugin is packaged for.