Troubleshooting
What goes wrong with MCP Server for Odoo, how to recognise it, and what to do.
The client says it cannot connect
Check, in order:
- Is the URL right? It ends /mcp/v1, with no trailing slash.
- Is Odoo reachable from the machine running the client? A laptop on a different network cannot see an internal address.
- Is the token in the Authorization header as Bearer <token>? This is the commonest mistake.
401 Unauthorized
The token is wrong, revoked, expired, or belongs to an archived user. Issue a new one; there is no way to read the old one back.
The client connects but shows no tools
Nothing is exposed, or nothing exposed is readable by the token's person.
- Check AI Assistant > Configuration > Exposed Data is not empty.
- Check the person the token speaks for can actually read those models in Odoo.
tools/list deliberately returns only what that person can reach, so an empty list is usually a permission answer rather than a fault.
A tool call comes back as an error
Read the text: it is the module telling the model what was wrong, and the model is expected to correct itself and try again. Common ones:
- No tool named X is available to you - the model asked for something outside that person's scope.
- Filter fields must name a field on this model - a dotted path was used.
- Operator X is not allowed - only the safe operators are accepted.
Nothing appears in the audit trail
Check AI Assistant > Audit > What the assistant read and filter From an MCP client. If calls are answering but not being recorded, check the server log for "Could not record MCP tool call" - the audit write is deliberately non-fatal so a logging problem cannot stop the endpoint answering.
The client hangs on first connection
Some clients send initialize and wait. Check the Odoo log for a request to /mcp/v1; if there is none, the request is not arriving and the problem is network or URL, not Odoo.
Where do I look first?
The token list. Last used, request count and last client name will tell you immediately whether the client is reaching Odoo at all.