Configuration Compatibility Notice

Environment Variable Support

The Dolibarr MCP server now supports both naming conventions for the API URL:

DOLIBARR_URL (recommended)
DOLIBARR_BASE_URL (alternative, for backward compatibility)

Both will work correctly. The server automatically checks for both and uses whichever is set.

Claude Desktop Configuration

Your existing configuration is fully compatible with the updated code:

{
  "mcpServers": {
    "dolibarr-python": {
      "command": "C:\\Users\\gino\\GitHub\\dolibarr-mcp\\venv_dolibarr\\Scripts\\python.exe",
      "args": [
        "-m",
        "dolibarr_mcp.dolibarr_mcp_server"
      ],
      "cwd": "C:\\Users\\gino\\Github\\dolibarr-mcp",
      "env": {
        "DOLIBARR_BASE_URL": "https://db.ginos.cloud/api/index.php/",
        "DOLIBARR_API_KEY": "7cxAAO835BF7bXy6DsQ2j2a7nT6ectGY"
      }
    }
  }
}

Quick Validation

To ensure everything works correctly, run:

validate_claude_config.bat

This will:

Check your virtual environment
Install/update all dependencies
Test module imports
Validate environment variables
Test server startup

Installation Steps (if needed)

Navigate to project directory:
```
cd C:\Users\gino\GitHub\dolibarr-mcp
```
Run the validator:
```
validate_claude_config.bat
```
Restart Claude Desktop after any configuration changes

Troubleshooting

If you encounter issues:

Run diagnostic tool:
```
python diagnose_and_fix.py
```

Check module installation:

venv_dolibarr\Scripts\python.exe -m pip install -e .

Test server directly:

venv_dolibarr\Scripts\python.exe -m dolibarr_mcp.dolibarr_mcp_server

URL Format Notes

The server automatically handles various URL formats:

https://db.ginos.cloud → becomes https://db.ginos.cloud/api/index.php
https://db.ginos.cloud/api/index.php/ → trailing slash is removed
https://db.ginos.cloud/api/index.php → used as-is

Status

✅ Your configuration is ready to use without any changes needed.

2.1 KiB Raw Blame History