Issue with installation - created Documentation: Comprehensive Guide for Integrating Odoo MCP Server with Claude Desktop on macOS #8
Description
Hello,
I recently integrated the Odoo MCP server with Claude Desktop on macOS and encountered several challenges that weren't covered in the existing documentation. After resolving these issues, I've created a comprehensive guide that might help other users and could be valuable to include in the official documentation.
Issues Encountered
Python Path Resolution: When using pyenv or Homebrew on macOS, Claude Desktop couldn't locate the Python interpreter using just python or python3 in the configuration, resulting in spawn python ENOENT errors.
Missing Dependencies: The documentation didn't clearly indicate that odoo-mcp requires the separate mcp package to be installed.
Configuration Location: There was confusion about where to place the odoo_config.json file and how it relates to environment variables in the Claude Desktop configuration.
Proposed Solution
I've created detailed documentation covering:
Installation requirements and steps
Proper configuration for both Claude Desktop and Odoo connection
Common issues and their solutions with examples
Troubleshooting steps with code samples
Additional resources for further reference
The documentation includes specific instructions for macOS users and addresses the path resolution issues that are common with pyenv installations.
I've attached the full markdown documentation that could be added to the repository or linked from the README. I'm happy to make any adjustments or provide more details if needed.
Next Steps
Would you consider:
Incorporating this guide into the official documentation?
Adding a troubleshooting section to the README addressing these common issues?
Potentially updating the package installation to automatically include the mcp dependency?
I'm available to help improve the documentation further or address any questions about my experience.
Thank you for creating this valuable tool!