When to use this guide?

Some MCP clients, mainly IDEs, don't support OAuth authentication for remote connectors. They require an Aidoo API key passed through the Authorization header:

Cursor, Windsurf and other MCP-compatible IDEs
Any MCP client that doesn't offer the OAuth flow

For Claude.ai, ChatGPT, Claude Desktop and Claude Code, use the Connecting with Claude guide instead (OAuth, no API key).

Prerequisites

An active Aidoo account with a configured Odoo connection
An Aidoo API key (prefixed aid_live_). Follow the API keys guide to generate one.

The MCP server is hosted by Aidoo at https://mcp.aidoo.fr. No local installation required.

Cursor

Add the MCP server in ~/.cursor/mcp.json:

{
  "mcpServers": {
    "aidoo": {
      "url": "https://mcp.aidoo.fr/sse",
      "headers": {
        "Authorization": "Bearer aid_live_your_key_here"
      }
    }
  }
}

Reload the IDE window (Cmd/Ctrl+Shift+P → Reload Window) to activate the connector.

Windsurf

Add the MCP server in ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "aidoo": {
      "url": "https://mcp.aidoo.fr/sse",
      "headers": {
        "Authorization": "Bearer aid_live_your_key_here"
      }
    }
  }
}

Reload the Windsurf window to activate the connector.

Other MCP clients

For any other IDE or MCP-compatible client, check its documentation for the configuration file location. The block to add stays the same: URL https://mcp.aidoo.fr/sse, SSE transport, Authorization: Bearer aid_live_… header.

Test the connection

Ask a question in your client:

What are my 5 latest purchase orders in Odoo?

You should see the assistant propose an aidoo_* tool call. Approve it to run the query.

Security

Never share your API key publicly (Git repository, screenshot, etc.)
One key per user: don't share keys across team members
If in doubt, revoke the key from the Aidoo dashboard and generate a new one
Limit each key's permissions to the strict minimum (see API keys)

Troubleshooting

The MCP icon doesn't appear in the IDE

Make sure the mcp.json file is valid JSON (a tool like jq or an online linter helps)
Fully reload the IDE window (Reload Window) — simply restarting the terminal isn't enough
Check the IDE logs: Cursor (Output → MCP), Windsurf (View → Output → MCP)

401 / "Unauthorized" error

Make sure your API key starts with aid_live_
Make sure the key has not been revoked in the dashboard
Make sure the corresponding MCP permission is enabled on the key

MCP server unreachable

Test https://mcp.aidoo.fr/health from your browser — you should see {"status":"ok"}
Check your firewall / corporate VPN (outbound HTTPS on port 443)