Skip to content

Commit 5a023da

Browse files
committed
update README.md
1 parent 3c42147 commit 5a023da

File tree

1 file changed

+41
-4
lines changed

1 file changed

+41
-4
lines changed

README.md

Lines changed: 41 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -28,9 +28,9 @@ An MCP server that enables AI assistants like Claude to interact with Odoo ERP s
2828
### Prerequisites
2929

3030
- Python 3.10 or higher
31-
- Access to an Odoo instance (version 18.0)
31+
- Access to an Odoo instance (version 17.0+)
3232
- The [Odoo MCP module](https://apps.odoo.com/apps/modules/18.0/mcp_server) installed on your Odoo server
33-
- An API key generated in Odoo (Settings > Users > API Keys)
33+
- (optional) An API key generated in Odoo (Settings > Users > API Keys)
3434

3535
### Install UV First
3636

@@ -58,6 +58,21 @@ After installation, restart your terminal to ensure UV is in your PATH.
5858

5959
Add this configuration to your MCP settings:
6060

61+
```json
62+
{
63+
"mcpServers": {
64+
"odoo": {
65+
"command": "uvx",
66+
"args": ["mcp-server-odoo"],
67+
"env": {
68+
"ODOO_URL": "https://your-odoo-instance.com",
69+
"ODOO_API_KEY": "your-api-key-here"
70+
}
71+
}
72+
}
73+
}
74+
```
75+
6176
<details>
6277
<summary>Claude Desktop</summary>
6378

@@ -232,7 +247,8 @@ The HTTP endpoint will be available at: `http://localhost:8000/mcp/`
232247
| `ODOO_MCP_HOST` / `--host` | Host to bind for HTTP transports | `localhost` |
233248
| `ODOO_MCP_PORT` / `--port` | Port to bind for HTTP transports | `8000` |
234249

235-
**Example: Running streamable-http transport for remote access**
250+
<details>
251+
<summary>Running streamable-http transport for remote access</summary>
236252

237253
```json
238254
{
@@ -249,11 +265,12 @@ The HTTP endpoint will be available at: `http://localhost:8000/mcp/`
249265
}
250266
}
251267
```
268+
</details>
252269

253270
### Setting up Odoo
254271

255272
1. **Install the MCP module**:
256-
- Download the [mcp_server module](https://github.com/ivnvxd/mcp-server-odoo/tree/main/odoo-apps/mcp_server)
273+
- Download the [mcp_server](https://apps.odoo.com/apps/modules/18.0/mcp_server) module
257274
- Install it in your Odoo instance
258275
- Navigate to Settings > MCP Server
259276

@@ -469,6 +486,26 @@ Example configuration:
469486
Note: `ODOO_DB` is required if database listing is restricted on your server.
470487
</details>
471488

489+
<details>
490+
<summary>"SSL: CERTIFICATE_VERIFY_FAILED" Error</summary>
491+
492+
This error occurs when Python cannot verify SSL certificates, often on macOS or corporate networks.
493+
494+
**Solution**: Add SSL certificate path to your environment configuration:
495+
496+
```json
497+
{
498+
"env": {
499+
"ODOO_URL": "https://your-odoo.com",
500+
"ODOO_API_KEY": "your-key",
501+
"SSL_CERT_FILE": "/etc/ssl/cert.pem"
502+
}
503+
}
504+
```
505+
506+
This tells Python where to find the system's SSL certificate bundle for HTTPS connections. The path `/etc/ssl/cert.pem` is the standard location on most systems.
507+
</details>
508+
472509
<details>
473510
<summary>Debug Mode</summary>
474511

0 commit comments

Comments
 (0)