What is the MCP protocol?

The Model Context Protocol (MCP) is an open standard that lets AI assistants like Claude or ChatGPT interact with external tools. Aidoo exposes your Odoo data and actions through MCP, directly inside the conversation.

Prerequisites

Before you start, make sure you have:

An active Aidoo account (14-day free trial available)
An Odoo connection configured in your Aidoo dashboard

No API key to generate or copy. Authentication runs through OAuth 2.1: you sign in to Aidoo from Claude.ai or ChatGPT and authorize access in one click.

Connect Claude.ai

In Claude.ai, open Settings → Connectors → Add custom connector
Fill in:

Field	Value
Name	`Aidoo`
MCP URL	`https://mcp.aidoo.ai/mcp`

Click Connect
You're redirected to the Aidoo sign-in page
Sign in and select the company to authorize
Click Authorize: you return to Claude.ai, the connector is active

The connector is available immediately, in any conversation. No restart needed.

Connect several companies at once

Claude only allows one URL per connector. To use several Aidoo connectors simultaneously in the same conversation — for example one company per connector, or a production and a test environment — add a connector for each of the URLs below. They all point to the same Aidoo service and behave identically:

Connector	MCP URL
Aidoo (1)	`https://mcp.aidoo.ai/mcp`
Aidoo (2)	`https://mcp.aidoo.ai/mcp-2`
Aidoo (3)	`https://mcp.aidoo.ai/mcp-3`
Aidoo (4)	`https://mcp.aidoo.ai/mcp-4`
Aidoo (5)	`https://mcp.aidoo.ai/mcp-5`

For each connector:

Give it a descriptive name (e.g. Aidoo — Company A, Aidoo — Production) so you can tell them apart in Claude
Enter one of the URLs above
Follow the same OAuth flow: sign in to Aidoo, then pick the company to authorize

Each connector runs its own authorization and stays bound to the company you choose. This lets you query several Odoo instances within a single conversation.

Tip: the URL has no effect on the data. The company selected during authorization is what determines which Odoo the connector accesses. Simply use a different URL per connector to work around Claude's one-URL limit.

Connect ChatGPT

In ChatGPT, open Settings → Connectors → Create
Fill in:

Field	Value
Name	`Aidoo`
MCP URL	`https://mcp.aidoo.ai/sse`
Authentication	OAuth

Click Create
You're redirected to the Aidoo sign-in page
Sign in, select the company, then Authorize

Test the connection

Ask a simple question to confirm everything works:

What are my 5 latest purchase orders in Odoo?

Claude (or ChatGPT) will:

Identify it should use the Aidoo tools
Ask you to approve the tool call
Query your Odoo through Aidoo
Display the results

Troubleshooting

The connector doesn't appear in the available tools

Refresh the conversation or open a new one
Check in Settings → Connectors that the status is Connected
If the status is Reconnect required, click the connector then Reconnect

"Couldn't reach the MCP server" error

Make sure https://mcp.aidoo.ai/health is reachable from your network
On Claude.ai, the URL is https://mcp.aidoo.ai/mcp
On ChatGPT, the URL is https://mcp.aidoo.ai/sse

OAuth redirect fails

Temporarily disable pop-up blockers and tracking extensions
Make sure you're signed in to your Aidoo account in the same browser
Check that your Aidoo subscription is active (an expired trial banner blocks OAuth)

Odoo connection error

Make sure your Odoo connection is properly configured in the Aidoo dashboard
Test the connection from Aidoo → Odoo Connection → Test
Make sure your Odoo credentials are still valid