odoo-rust-mcp/dotenv.example at main · milzamsz/odoo-rust-mcp · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
# Odoo Rust MCP Server - Environment Configuration
# Copy this file to .env and configure your settings
# DO NOT commit .env to version control!

# =============================================================================
# MULTI-INSTANCE CONFIGURATION (Recommended - Default Setup)
# =============================================================================
# Multi-instance mode allows you to connect to multiple Odoo instances.
# Each instance can be accessed by name in tool calls: {"instance": "production", ...}

# Option 1: JSON File Path (Recommended - easier to read and edit)
# Create a JSON file with your instances configuration (see instances.example.json)
ODOO_INSTANCES_JSON=/config/instances.json

# Option 2: Inline JSON (for simple setups or environment-only config)
# Must be a single line! Uncomment and configure:
# ODOO_INSTANCES={"production":{"url":"http://host.docker.internal:8069","db":"production","version":"18","username":"admin","password":"admin"},"staging":{"url":"http://staging.example.com:8069","db":"staging","apiKey":"YOUR_API_KEY"}}

# =============================================================================
# SINGLE INSTANCE CONFIGURATION (Simple Setup - Alternative)
# =============================================================================
# Use this only if you have a single Odoo instance.
# Comment out ODOO_INSTANCES_JSON above and uncomment these settings.
#
# # Odoo Server URL
# # - For Docker: use host.docker.internal for Odoo on host machine
# # - For Kubernetes: use the Odoo service name (e.g., odoo.namespace.svc.cluster.local)
# ODOO_URL=http://host.docker.internal:8069
# ODOO_DB=mydb
#
# # Odoo 19+ (JSON-2 API with API Key)
# # ODOO_API_KEY=YOUR_API_KEY
#
# # Odoo < 19 (JSON-RPC with Username/Password)
# ODOO_VERSION=18
# ODOO_USERNAME=admin
# ODOO_PASSWORD=admin

# =============================================================================
# CONFIG UI AUTHENTICATION
# =============================================================================
# Login credentials for the web-based configuration interface.
# IMPORTANT: Change these default credentials immediately after first install!
CONFIG_UI_USERNAME=admin
CONFIG_UI_PASSWORD=changeme

# =============================================================================
# MCP HTTP TRANSPORT AUTHENTICATION
# =============================================================================
# Enable/disable Bearer token authentication for HTTP transport.
# When enabled, clients must include "Authorization: Bearer <token>" header.
# STRONGLY RECOMMENDED for production deployments!
#
# Enable/disable MCP HTTP authentication (default: false)
MCP_AUTH_ENABLED=false
#
# The auth token - generate with: openssl rand -hex 32
# Or use the "Generate Token" button in Config UI Security tab.
# MCP_AUTH_TOKEN=your-secure-random-token-here

# =============================================================================
# MCP CONFIGURATION PATHS
# =============================================================================
# For Docker/Kubernetes, these are set automatically via environment.
# For local development with stdio transport, use absolute paths!
#
# MCP_TOOLS_JSON=/config/tools.json
# MCP_PROMPTS_JSON=/config/prompts.json
# MCP_SERVER_JSON=/config/server.json

# =============================================================================
# OPTIONAL SETTINGS
# =============================================================================
# Enable write tools (create, update, delete)
# ODOO_ENABLE_WRITE_TOOLS=true

# Enable destructive cleanup tools. Both this and ODOO_ENABLE_WRITE_TOOLS are required.
# ODOO_ENABLE_CLEANUP_TOOLS=true

# Controlled named-capability mode. This hides/rejects generic mutation tools and
# exposes only odoo_execute_capability. The registry must be normalized JSON from
# odoo-agent; the key must contain at least 32 bytes; state must be persistent.
# ODOO_CAPABILITY_CONTROLLED_MODE=true
# ODOO_CAPABILITY_REGISTRY=/config/odoo-agent-config.json
# ODOO_CAPABILITY_APPROVAL_HMAC_KEY=replace-with-at-least-32-random-bytes
# ODOO_CAPABILITY_STATE_DIR=/var/lib/odoo-rust-mcp/capability-state

# Enable odoo_execute only with a reviewed per-instance toolConfig.executeAllowlist.
# Unset denies it even when ODOO_ENABLE_WRITE_TOOLS=true.
# ODOO_ENABLE_EXECUTE_TOOL=true

# Request timeout in milliseconds
# ODOO_TIMEOUT_MS=30000

# Maximum retry attempts for failed requests
# ODOO_MAX_RETRIES=2

# Installed-module snapshot TTL in seconds. Set 0 to refresh on every instance-scoped list.
# ODOO_MODULE_SNAPSHOT_TTL_SECS=300

# =============================================================================
# EXAMPLES FOR DIFFERENT DEPLOYMENTS
# =============================================================================

# --- Docker Compose (Multi-instance from file) ---
# ODOO_INSTANCES_JSON=/config/instances.json

# --- Docker Compose (Inline multi-instance) ---
# ODOO_INSTANCES={"production":{"url":"http://host.docker.internal:8069","db":"prod","apiKey":"xxx"},"staging":{"url":"http://odoo:8069","db":"staging","apiKey":"yyy"}}

# --- Kubernetes (Multi-instance from ConfigMap) ---
# ODOO_INSTANCES_JSON=/config/instances.json

# --- Kubernetes (Odoo in same namespace - single instance fallback) ---
# ODOO_URL=http://odoo-service:8069
# ODOO_DB=mydb
# ODOO_API_KEY=your-api-key

# --- Kubernetes (Odoo in different namespace - single instance fallback) ---
# ODOO_URL=http://odoo-service.odoo-namespace.svc.cluster.local:8069
# ODOO_DB=mydb
# ODOO_API_KEY=your-api-key