Get started

In a few minutes: sign in with your invitation, connect your company's Odoo and add your own Odoo user. Nothing is installed on your Odoo server.

All plans5 minutes

Requirements

Odoo	Odoo 16, 17, 18 or 19, Community or Enterprise, on Odoo Online, Odoo.sh or your own server, reachable from the internet over `https://`.
Access to Conectores ERP	An invitation (private beta). Ask for one on the waitlist.
Odoo user	An internal user (not a portal user) with an API key. Each person uses their own.

1. Create the space

Open the invitation email and follow the link to verify your email and choose a password. If the sign-in screen shows Iniciar sesión con Google (Sign in with Google), you can also sign in with the Google account of that same email.
Go to app.conectoreserp.es.
Create your company's space: give it a name and an identifier (lowercase letters, numbers and hyphens only; it appears in addresses, for example in the MCP Connect one). If you were invited to a space that already exists, skip this step.

Whoever creates the space is its owner. Admins connect Odoo, decide the Copilot's permissions and invite more people in Ajustes → Miembros (Settings → Members); members use the Copilot and MCP Connect with their own Odoo user.

2. Connect the space's Odoo

A space admin does this once, in Ajustes → Conexión de Odoo del espacio (Settings → Space's Odoo connection). You need four details:

Detail	What it is	Example
Your Odoo's address	The one you see in the browser when you open Odoo, with nothing after the domain. It must start with `https://`; if you paste `…/odoo/…` or `…/web#…`, the app removes it for you.	`https://mycompany.odoo.com`
Database	Odoo Online: almost always the subdomain. Odoo.sh: the database of the production branch (not of a staging branch). Your own server: you see it at `/web/database/selector`, or ask whoever runs the server.	`mycompany`
User	The email (login) that user signs in to Odoo with.	`ana@mycompany.com`
API key	An API key of that user (see below). It's stored encrypted and never shown again.	—

Click Verificar y guardar (Verify and save). The app checks the connection to your Odoo right then (it can take up to a minute) and saves nothing if it fails.

Create the API key in Odoo

Sign in to Odoo with the user you're going to connect.
Click your avatar (top right) → My Preferences (or My Profile) → Account Security tab.
Under API Keys, click New API Key and enter your password.
Give it a name, for example "Conectores ERP". In Odoo 19 you also choose its duration: when it expires, create another one and save it in the app.
Copy it before you close the dialog: Odoo doesn't show it again.

Important: If you don't see the Account Security tab, ask whoever administers your Odoo to give you access. Odoo API keys give the same access as the user's password: don't share them.

Odoo versions and how they connect

Odoo	How it connects
19	Odoo's JSON-2 API, with the API key. It's tried first.
16, 17 and 18	XML-RPC, with the same API key instead of the password. It's tried if JSON-2 isn't available.

The app shows which one your connection uses (JSON-2 or XML-RPC) in Ajustes. In both cases, the user's Odoo permissions apply.

3. Connect your own Odoo user

The Copilot and MCP Connect work with each person's Odoo user: they only see and do what Odoo allows that user, and Odoo records that the change was made by that person.

Open Ajustes → Tu usuario de Odoo (Settings → Your Odoo user), or open the Copilot: it asks you the first time.
The address and the database are already filled in with the space's. Enter your Odoo email and paste your API key.
Click to verify and save.

Whoever connected the space's Odoo uses that same connection: they don't need to add another one.
Each Odoo user belongs to just one person in the space. If two people share a user in Odoo, ask whoever administers it to create one for each.
If an admin changes the space's address or database, each person must connect their user again.

Recommended Odoo permissions

Conectores ERP doesn't change Odoo's permissions: it respects them. In Odoo, give each person the groups for what they're going to ask the Copilot. The names are Odoo 19's (with the technical name in parentheses); in other versions they can differ slightly.

For	The user's Odoo group	More information
Querying data	The read permissions of each app (what that person already sees in Odoo).	Query data
Accounting reports, vendor bills, posting invoices, registering payments and sending invoices	Accounting: Invoicing (`account.group_account_invoice`) or higher.	Post invoices
Importing bank statements	Accounting Basic (`account.group_account_basic`) or the accountant group, "Show Full Accounting Features" (`account.group_account_user`). With Invoicing, you can only read them.	Import statements
Creating contacts	Contacts: Contact Creation (`base.group_partner_manager`).	Create and update
Quotations and sales orders	Sales: User (own documents only, or all documents).	Create and update
Employee expenses	The Expenses app installed and an employee linked to your user; for other people's expenses, being their approver in Expenses.	Receipts and expenses
Employees and time off	The Employees and Time Off apps; to see full employee records, Employees: Officer (`hr.group_hr_user`).	Human resources

Note: For MCP Connect, read permissions are enough: it's read-only. If you connect a dedicated user for the space, give it access only to what you want to query.

Next steps

An admin reviews the Copilot's permissions: what it can do without asking, what needs approval and what it doesn't do.
Open the Copilot and ask your first question, for example:
- Which customer invoices are overdue?
- Sales this month by salesperson
If you use Claude, ChatGPT, Cursor or VS Code, connect your assistant with MCP Connect.

Troubleshooting

Quoted text is exactly what the app shows, in Spanish, followed by what it means. When the Copilot can't propose something, it explains why in the chat, in its own words.

What you see	Why	What to do
«Odoo ha rechazado el usuario o la clave API. Comprueba que la clave pertenece a ese usuario y que no ha caducado.»Means: Odoo rejected the user or the API key. Check that the key belongs to that user and hasn't expired.	The key belongs to another user, was copied wrong or expired (Odoo 19).	Create a new key with that same user and paste all of it.
«Odoo no encuentra esa base de datos. Revisa el nombre exacto.»Means: Odoo can't find that database. Check the exact name.	The database name isn't the one at that address.	On Odoo.sh, use the production branch's database. On your own server, look it up at `/web/database/selector`.
«No hemos podido llegar a tu Odoo en esa dirección. Comprueba la URL y que sea accesible desde Internet.»Means: We couldn't reach your Odoo at that address. Check the URL and that it's reachable from the internet.	The address doesn't respond from the internet, has no valid `https://` or is on a private network.	Open the address from outside your office. An Odoo that's only reachable on your local network can't be connected.
«Odoo ha devuelto un error al comprobar la conexión. Revisa los datos o escríbenos.»Means: Odoo returned an error while checking the connection. Check the details or write to us.	Another Odoo error.	Check the four details and, if it persists, email us at soporte@conectoreserp.es.
«Un administrador tiene que conectar primero el Odoo del espacio.»Means: An admin must connect the space's Odoo first.	The space doesn't have an Odoo connection yet.	Ask an admin to do step 2.
«Conecta tu usuario de Odoo para usar el Copiloto.»Means: Connect your Odoo user to use the Copilot.	You haven't added your Odoo user yet.	Do step 3.
«Ese usuario de Odoo ya lo usa otra persona del espacio. Cada persona conecta el suyo: pide a un administrador de Odoo que te cree uno.»Means: Another person in the space already uses that Odoo user. Each person connects their own: ask an Odoo administrator to create one for you.	Another person in the space already connected that Odoo user.	Connect an Odoo user of your own.
«La conexión de Odoo del espacio cambió: vuelve a conectar tu usuario de Odoo.»Means: The space's Odoo connection changed: connect your Odoo user again.	An admin changed the space's address or database.	Save your user again in Ajustes.
«Tu plan no admite más conexiones»Means: Your plan doesn't allow more connections.	Your plan includes a single Odoo instance.	Multiple instances are on the Business plan: Plan and billing.

Get started

Related