Quick start
From creating your account to your first Odoo answer, in five minutes and without writing a line of code.
5 min de leituraAtualizado a 7 de agosto de 2026
Esta página ainda não está traduzida para o seu idioma: é apresentada em inglês.
This guide takes you to your first Odoo answer inside Claude. Budget five minutes, three of which are spent in Odoo generating an API key.
What you need: admin access to your Odoo, and a Claude.ai or ChatGPT account.
Create your Aidoo account
Head to app.aidoo.ai/register. Sign up by email or with Google.
Your 14-day free trial starts right away: no credit card, full access to Aidoo AI, unlimited requests.
Generate an API key in Odoo
Aidoo connects to Odoo with an API key, never with an account password.
In your Odoo:
- Click your avatar in the top right → My profile
- Account security tab → New API key
- Give it a clear name (
Aidoo) and a validity period - Copy the key immediately: Odoo will never show it again
This key is for the connection, not for your teams
It links Aidoo to your instance and reads the database structure. Each member then registers their own Odoo key under Team → Odoo token, and their requests go out with their own rights. An admin account is therefore fine here, production included. Details in Connect your Odoo.
Connect your Odoo to Aidoo
In Aidoo, open Odoo connection. Enter the URL first: Aidoo reaches the instance and fills in the database name on its own when it can.
| Field | Example | Where to find it |
|---|---|---|
| Odoo URL | https://my-company.odoo.com | Your Odoo address; any path is stripped automatically |
| Database name | my-company | Detected automatically from the URL in most cases |
| Username | [email protected] | The login of the account that created the key |
| Odoo API key | a1b2c3… | The key you copied in the previous step |
Click Test connection. A green Connected badge confirms everything is in place, then Save.
Your credentials are encrypted with AES-256-GCM before being stored. Details and edge cases in Connect your Odoo.
Add the connector in Claude or ChatGPT
No key to copy here: authentication runs through OAuth. The authorization screen is where you pick the workspace and the connector's rights.
- In Claude.ai: Settings → Connectors → Add custom connector
- Name:
Aidoo, URL:https://mcp.aidoo.ai/mcp - Connect → you are redirected to Aidoo
- Sign in, pick the workspace to authorize, then Authorize
- In ChatGPT: Settings → Connectors → Create
- Name:
Aidoo, URL:https://mcp.aidoo.ai/mcp, Authentication: OAuth - Create → sign in to Aidoo, pick the workspace, then Authorize
Your teams can also talk to Aidoo without leaving Odoo: a bubble appears at the bottom right of your production Odoo.
- In Aidoo, open API keys → Aidoo in Odoo tab
- Install in Odoo places the bubble on your production instance
- Enable chat: pick the Odoo identity, the model and the permissions
The in-Odoo chat consumes credits
With Claude or ChatGPT, the model is billed by your subscription with them. The bubble's chat is provided by Aidoo instead: every exchange is debited from the credit pool shared with agents. With no credits left, the chat says so instead of answering.
Owners and admins only. See Credits and consumption.
The connector is live immediately, in every conversation.
Ask your first question
Open a conversation and try:
What are my 5 latest quotations in Odoo?
The assistant works out it needs Aidoo, asks you to approve the call, queries your Odoo and shows the result.
If you see your real quotations: everything works.
Choosing the connector's rights
The authorization screen, right before you confirm, is where you tick what the connector may do. By default only read access is ticked: query, read, schema, report, print. The assistant can look at everything and change nothing.
To let it act, tick create, write or execute at that point.
Rights can be changed later
Nothing is locked in: open API keys in Aidoo to add or remove a permission on a connector you already authorized. If your workspace has a staging environment, you set its rights separately from production. See Writing to Odoo.
What now?
Natural next steps:
- Your first requests: ten annotated prompts to get the hang of it
- Recipes by team: ready-to-paste prompts, by department
- MCP tool reference: exactly what the assistant can do
If something goes wrong
The database name is not filled in automatically. Some instances disable database listing. Type it in by hand: it is usually the subdomain of your URL.
The connector does not show up in Claude. Open a new conversation. If the status reads Reconnect required, click the connector then Reconnect.
The assistant says it has no Odoo access. Check in Aidoo that the Odoo connection shows Connected, and that your trial has not expired.
Failure cases are covered in detail in Connecting with Claude and Connecting with ChatGPT.