AI Client Setup Cheatsheet

This page is a quick reference for connecting popular AI clients to your Odoo MCP Server. The wizard already generates the exact snippets — this page is a longer-form recap so admins can share it with end users.

Compatibility matrix

Client

Recommended auth

Notes

claude.ai (web)

Browser login (OAuth)

Self-registers via RFC 7591

ChatGPT (Connectors)

Browser login (OAuth)

Custom connector, MCP over HTTPS

Claude Desktop

Browser login OR API key

Either works on the desktop app

Cursor

API key

JSON config file

Claude Code CLI

API key

claude mcp add cmd

Gemini CLI

API key

httpUrl (not url)

Continue.dev

API key

JSON config file

Custom backend

Custom OAuth

Server-to-server

curl / scripts

API key

Bearer header

claude.ai (web)

  1. Have an admin open MCP Server ‣ Configuration ‣ Connections ‣ Connect a New Tool.

  2. Pick Browser login (OAuth, auto-setup) and click Finish. Copy the MCP Endpoint URL.

  3. In claude.ai, go to Settings ‣ Connectors ‣ Add custom connector.

  4. Paste the Odoo URL and confirm.

  5. Click Connect. A browser tab opens to the Odoo consent screen.

  6. Log in (if not already) and click Allow.

  7. The connector is now live. Back in MCP Server ‣ Configuration ‣ Connections, a new row with status Connected.

ChatGPT

The setup mirrors claude.ai:

  1. (Admin) Run the wizard, pick Browser login, copy the URL.

  2. (User) In ChatGPT, go to your custom GPT or Connectors panel and add an MCP server with the Odoo URL.

  3. (User) Authorise via the browser popup.

  4. The connection appears in Odoo.

Claude Desktop

Claude Desktop supports both flows.

Option A — Browser login

  1. Open Claude Desktop → Settings ‣ Add MCP server ‣ Remote.

  2. Paste the Odoo MCP URL and follow the browser-based prompt.

Option B — API key

  1. (Admin) Generate an API key via the wizard.

  2. Copy the JSON snippet labelled Claude Desktop in the wizard’s Done step.

  3. Paste it into the Claude Desktop config file (usually ~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows).

  4. Restart Claude Desktop.

Cursor

  1. (Admin) Generate an API key via the wizard.

  2. Copy the Cursor JSON snippet.

  3. Paste it into ~/.cursor/mcp.json.

  4. Restart Cursor.

Verify under Settings ‣ MCP — the Odoo server should be listed with a green dot.

Claude Code CLI

  1. (Admin) Generate an API key via the wizard.

  2. Copy the claude mcp add … command from the Claude Code CLI tab.

  3. Run it in your terminal.

  4. Verify with claude mcp list.

Gemini CLI

  1. (Admin) Generate an API key via the wizard.

  2. Copy the Gemini CLI JSON snippet.

  3. Add it to ~/.gemini/settings.json (create the file if it does not exist).

  4. Restart the gemini CLI.

  5. Verify with /mcp list — Odoo should appear as Ready.

Note

Gemini CLI requires the key httpUrl for remote MCP servers (not url). The wizard already generates the correct field name — just paste verbatim.

Continue.dev

  1. (Admin) Generate an API key via the wizard.

  2. Copy the Continue.dev JSON snippet.

  3. Paste it into ~/.continue/config.json.

  4. Restart your IDE.

Custom backend / server-to-server

  1. (Admin) Pick Custom OAuth in the wizard.

  2. Decide between Confidential and Public (PKCE) client.

  3. Provide one or more Redirect URIs.

  4. Save and copy the Client ID and (for confidential clients) the Client Secret.

  5. Implement the OAuth 2.1 Authorisation Code flow in your application, pointing at:

    • /oauth/authorize

    • /oauth/token

    • the MCP endpoint at /odoo/mcp

See Custom OAuth Connections for details.

curl / scripts

  1. (Admin) Generate an API key via the wizard.

  2. Copy the curl snippet.

  3. Run it to sanity-check the endpoint:

curl -X POST https://your-company.odoo.com/odoo/mcp \
  -H 'Authorization: Bearer mcp_ak_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

A valid response lists the catalog of tools.

See also