Connecting with Claude

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 and authorize access in one click.

Connect Claude.ai

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

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

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

Avoiding an approval on every call

By default, Claude asks you to approve every tool call. On repeated lookups, that gets tiring fast.

Under Settings → Connectors, Claude groups the Aidoo tools into read-only and write or delete. Each group can be set to Always allow in one move, and you can also decide tool by tool.

Connect several companies at once

Claude only allows one URL per connector. To use several Aidoo connectors simultaneously in the same conversation (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:

For each connector:

1. Give it a descriptive name (e.g. Aidoo Company A, Aidoo Production) so you can tell them apart in Claude
2. Enter one of the URLs above
3. 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.

Using ChatGPT? The procedure has its own page: Connecting with ChatGPT.

Test the connection

Ask a simple question to confirm everything works:

What are my 5 latest purchase orders in Odoo?

Claude will:

1. Identify it should use the Aidoo tools
2. Ask you to approve the tool call
3. Query your Odoo through Aidoo
4. Display the results

Example prompts

A few concrete examples to discover what the connector can do:

What are my 5 latest sales orders in Odoo?

What is my invoiced revenue per month over the last 6 months?

Create a contact "Aidoo Test" with the email [email protected]

Generate the PDF for invoice INV/2026/00042

Confirm quotation S00021

By default, Claude shows you every tool call before running it, writes included. That check is configurable in Claude: keep it on for write tools.

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
• The connector URL is https://mcp.aidoo.ai/mcp

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

Need help?

If an issue persists, reach out via the contact page: we reply within 1 business day.