diff --git a/CONFIG_COMPATIBILITY.md b/CONFIG_COMPATIBILITY.md
new file mode 100644
index 0000000..3031b97
--- /dev/null
+++ b/CONFIG_COMPATIBILITY.md
@@ -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.