Frequently Asked Questions (FAQ) about Odoo MCP Server

Q: What is the Odoo MCP Server? A: The Odoo MCP Server is a standardized interface that allows AI Agents to interact with Odoo instances through the Model Context Protocol (MCP). It provides tools for resource management, security, and various communication protocols.

Q: What are the system requirements for the Odoo MCP Server? A: The server requires Python 3.9+, Odoo 15.0+ (with base, web, and bus modules), and optionally Docker. Hardware requirements include 2+ CPU cores, 4GB minimum RAM (8GB recommended), and 1GB minimum disk space.

Q: How do I install the Odoo MCP Server? A: You can install it directly by cloning the repository, installing dependencies with pip, and configuring the settings. Alternatively, you can use Docker by cloning the repository and running Docker Compose.

Q: How do I configure the Odoo MCP Server? A: The server is configured through a JSON file (config.json). You can specify connection details, communication protocols, and security settings. Environment variables can also be used to override configuration settings.

Q: What connection types does the Odoo MCP Server support? A: The server supports stdio (direct communication), streamable_http (HTTP with streaming), and http (classic HTTP POST) connection types. The streamable_http type is ideal for real-time data flows.

Q: How can I start the Odoo MCP Server? A: You can start the server in stdio mode using python -m odoo_mcp.server or in streamable_http mode using python -m odoo_mcp.server streamable_http. You can also specify the configuration file path.

Q: How do I verify that the server is running correctly? A: You can verify the server by sending test requests using curl for HTTP modes or echo commands for stdio mode. Check the server logs for any errors.

Q: What are some use cases for the Odoo MCP Server? A: Use cases include automated customer service, intelligent inventory management, streamlined sales processes, enhanced financial analysis, personalized marketing campaigns, and real-time data analysis.

Q: How do I connect Claude Desktop to the Odoo MCP Server? A: To connect Claude Desktop, ensure the Odoo MCP server is installed and working. Add the server configuration to the mcpServers section in your claude_desktop_config.json file, specifying the command and arguments for the Odoo MCP server. Claude Desktop only communicates via stdio.

Q: What kind of documentation is available for the Odoo MCP Server? A: Complete documentation is available in the docs/ directory, including the MCP protocol documentation, Odoo server documentation, and server usage guide.

Q: How do I contribute to the Odoo MCP Server project? A: You can fork the repository, create a feature branch, commit your changes, push to the branch, and open a pull request.

Q: What should I do if I encounter a connection error? A: Verify that Odoo is running, check the firewall settings, ensure the Odoo URL in the configuration file is correct, and confirm that the database is accessible.

Q: What should I do if I encounter an authentication error? A: Verify the username and API key in the configuration file, check that the user has necessary permissions in the Odoo database, and ensure that the specified database exists.

Q: Where can I find the error logs for the Odoo MCP server? A: Error logs can be written to the console (stderr) if a StreamHandler is configured or to a file specified in the logging section of config.json using a FileHandler.

Q: How do I update the Odoo MCP Server? A: You can update from source by pulling the latest changes, reinstalling the package with pip, and restarting the server. If using Docker, pull the latest images and restart the containers.

Q: How do I uninstall the Odoo MCP Server? A: You can uninstall from source by using pip to uninstall the package and removing configuration files. If using Docker, stop and remove the containers and remove the images.