Settings
Complete reference for all MCP Server configuration options in Odoo Settings
Settings Reference
All MCP Server settings live in Settings → General Settings → MCP Server and are stored as ir.config_parameter key-value pairs. Changes take effect immediately (except the gateway flag, which is cached for 5 minutes).
[!NOTE] Screenshot — Settings → MCP Server section
Place a screenshot of the General Settings page with the MCP Server configuration block expanded here. Suggested filename:
settings-mcp-server-block.png
Gateway Settings
| Setting | ir.config_parameter Key | Default | Description |
|---|---|---|---|
| Active AI Assistant Gateway | ai_integration.enabled | False | Master switch. When off, all /mcp requests return HTTP 503. |
| Enable MCP Audit Logging | ai_integration.enable_logging | True | Log every tool call to ai_connector.audit_log. |
| MCP Log Retention (Days) | ai_integration.log_retention_days | 30 | Daily cron purges logs older than N days. Set to 0 to disable purge. |
| Enable MCP Rate Limiting | ai_integration.enable_rate_limiting | False | Enforce per-user request rate limits. |
| Requests per Minute | ai_integration.request_limit | 60 | Max requests per user per calendar minute when rate limiting is on. 0 = unlimited. |
| Enable OAuth 2.1 | ai_integration.oauth_enabled | True | Allow OAuth-based web client connections. |
| Advertise OAuth Discovery | ai_integration.oauth_advertise_discovery | True | Publish /.well-known/oauth-* metadata endpoints. |
| Access Token Lifetime (s) | ai_integration.oauth_token_ttl | 3600 | OAuth access token TTL in seconds. |
Resource Limits
These settings cap resource-heavy operations to protect server performance:
| Setting | Default | Description |
|---|---|---|
| Max Attachment Bytes | 5 MB | Maximum size for odoo_files upload/download. |
| Max Report Bytes | 10 MB | Maximum size for rendered QWeb PDF/HTML reports. |
| Max Export Rows | 5,000 | Maximum rows returned by odoo_transfer export. |
| Max Email Recipients | 20 | Maximum recipients per odoo_email send_email call. |
Reading Config Parameters Programmatically
# In Odoo shell or code
env['ir.config_parameter'].sudo().get_param('ai_integration.enabled')
# → 'True' or 'False' (string)
env['ir.config_parameter'].sudo().get_param('ai_integration.request_limit', '60')
# → '60'Gateway Cache Caveat
[!WARNING]
is_gateway_active()incontrollers/utils.pycaches theai_integration.enabledflag for 5 minutes. Toggling the gateway off in Settings may not immediately stop/mcptraffic — existing connections may succeed for up to 5 minutes after disable.