Generate API keys and OAuth configuration for MCP clients using the Connect Wizard

Connect Wizard

The MCP Connect Wizard guides you through creating credentials and generating the exact configuration your AI client needs. It is the recommended starting point for every new connection.

Open it from MCP Server → Connect in the Odoo top menu.

Choosing an Auth Mode

Rendering diagram…

Wizard Steps

Step 1 — Purpose

Configure the connection details:

Field	Description
Connection Name	Label for this credential (e.g. `Cursor Dev`, `Claude Production`)
AI Client	Target platform — determines auth mode and configuration format
User	The Odoo user the AI will act as (must be in the MCP Server User group)

[!NOTE] Screenshot — Connect Wizard Step 1

Place a screenshot of the wizard’s first step here showing the fields above. Suggested filename: connect-wizard-step1.png

Step 2 — Connect

The wizard generates platform-specific configuration based on the client you selected.

[!NOTE] Screenshot — Connect Wizard Step 2

Place a screenshot of the wizard’s second step showing the generated config or MCP URL. Suggested filename: connect-wizard-step2.png

OAuth 2.1 — Web Clients

Used by Claude.ai and ChatGPT.com. These clients handle token acquisition automatically.

Steps:

In the wizard, select Claude.ai or ChatGPT.com as the AI client.
Copy the MCP Server URL (e.g. https://your-odoo.com/mcp).
In your AI client, add a new custom MCP connector.
Paste the URL and confirm.
Your browser will open an Odoo login/consent page — authorize with your Odoo credentials.
The AI client receives an access token and is ready to use MCP tools.

The client auto-discovers OAuth endpoints via /.well-known/oauth-authorization-server.

API Key — Desktop & IDE Clients

Used by Claude Desktop, Cursor, VS Code / GitHub Copilot, and other desktop clients.

Steps:

In the wizard, select your desktop client (e.g. Cursor).
The wizard generates a secret API key.
Copy the JSON configuration snippet shown.
Paste it into your client’s MCP configuration file (location varies by client — see Supported Clients).

Claude Desktop (`claude_desktop_config.json`)

{
  "mcpServers": {
    "odoo": {
      "url": "https://your-odoo.com/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_KEY"
      }
    }
  }
}

Cursor (`.cursor/mcp.json`)

{
  "mcpServers": {
    "odoo": {
      "url": "https://your-odoo.com/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_KEY"
      }
    }
  }
}

VS Code (`settings.json`)

{
  "mcp": {
    "servers": {
      "odoo": {
        "type": "http",
        "url": "https://your-odoo.com/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_MCP_KEY"
        }
      }
    }
  }
}

Auth Mode Quick Reference

Client	Auth Mode	What the wizard provides
Claude.ai	OAuth 2.1	MCP Server URL
ChatGPT.com	OAuth 2.1	MCP Server URL
Claude Desktop	API Key	JSON config with Bearer token
Cursor	API Key	JSON config with Bearer token
VS Code / Copilot	API Key	JSON config with Bearer token
Windsurf, Cline	API Key	JSON config with Bearer token

[!TIP] API keys are stored as a SHA-256 hash in the Odoo database. The raw key is shown only once — copy it immediately. If lost, delete the credential and create a new one.

Connect Wizard

On this page