mirror of
https://github.com/latinogino/dolibarr-mcp.git
synced 2026-05-01 05:45:35 +02:00
Add configuration compatibility documentation
This commit is contained in:
92
CONFIG_COMPATIBILITY.md
Normal file
92
CONFIG_COMPATIBILITY.md
Normal file
@@ -0,0 +1,92 @@
|
|||||||
|
# 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:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"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:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
validate_claude_config.bat
|
||||||
|
```
|
||||||
|
|
||||||
|
This will:
|
||||||
|
1. Check your virtual environment
|
||||||
|
2. Install/update all dependencies
|
||||||
|
3. Test module imports
|
||||||
|
4. Validate environment variables
|
||||||
|
5. Test server startup
|
||||||
|
|
||||||
|
## Installation Steps (if needed)
|
||||||
|
|
||||||
|
1. **Navigate to project directory:**
|
||||||
|
```bash
|
||||||
|
cd C:\Users\gino\GitHub\dolibarr-mcp
|
||||||
|
```
|
||||||
|
|
||||||
|
2. **Run the validator:**
|
||||||
|
```bash
|
||||||
|
validate_claude_config.bat
|
||||||
|
```
|
||||||
|
|
||||||
|
3. **Restart Claude Desktop** after any configuration changes
|
||||||
|
|
||||||
|
## Troubleshooting
|
||||||
|
|
||||||
|
If you encounter issues:
|
||||||
|
|
||||||
|
1. **Run diagnostic tool:**
|
||||||
|
```bash
|
||||||
|
python diagnose_and_fix.py
|
||||||
|
```
|
||||||
|
|
||||||
|
2. **Check module installation:**
|
||||||
|
```bash
|
||||||
|
venv_dolibarr\Scripts\python.exe -m pip install -e .
|
||||||
|
```
|
||||||
|
|
||||||
|
3. **Test server directly:**
|
||||||
|
```bash
|
||||||
|
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.
|
||||||
Reference in New Issue
Block a user