A Cravit product — cravit.nl
CravitGateway
Part one

Administrator guide

How to run your Cravit Gateway console: sign in, give colleagues access, and decide what the AI may do in your Odoo. Everything here affects your organisation only.

You need two things

Your console address (https://yourcompany.cravitgateway.com/admin/ui) and your admin key (starting cga_). You create the key yourself with one button, right after confirming your email; it is shown once and is never in an email. Store it in a password manager: it cannot be recovered afterwards, only replaced.

1. Signing in for the first time

After the sign-up form you receive one mail: Confirm your email. Its button creates your gateway and takes you straight to the page below. Closed the tab? The same mail brings you back until your key exists.

Email confirmed: your gateway is ready, with the Create my admin key button
  1. Click Create my admin key. Your key is created at that moment and shown once — copy it into your password manager.
    Admin key shown once with a Copy button and the Continue to the console button
  2. Click Continue to the console. You are already signed in on this device; the console goes straight to the authenticator step below. Nothing to paste.

You then receive the one mail to keep, Your Cravit Gateway is ready, with your console address and the email you sign in with. Made an administrator by a colleague, or approved by Cravit by hand? Your mail has a personal link to the same page; it works once and expires after 7 days.

Later sign-ins: open your console address, enter your email and your cga_ key, then the 6-digit code from your authenticator app.

Admin console sign-in screen with the Lost your key? link
Lost your key?

Click Lost your key? under the sign-in button and enter your email address. If it belongs to an administrator, you receive a link to create a new key; it works once, for one hour. Your authenticator app stays the same. Your current key keeps working until you use that link, so nobody can lock you out by typing your address. A link is sent every time you ask (at most one per ten minutes); an earlier link you never opened stops working, so use the most recent mail. Lost your authenticator too? Contact Cravit.

Lost your key? form on the sign-in screen
Link already used?

If the page says the link was already used and that was not you, contact Cravit immediately. You also receive a short email whenever your link is used, with the time and the address it came from.

Light or dark

The console has a light and a dark look. Switch with Light / Dark in the sidebar; the choice is remembered on this browser. The console opens in light.

The Users page: each person with what they may see, whether they may change things, which Odoo they are connected to, and their status

2. Setting up two-factor authentication

Required for every administrator; it cannot be skipped.

Two-factor authentication setup screen
  1. Scan the QR code with an authenticator app (Google Authenticator, Microsoft Authenticator, Authy, 1Password). Can't scan? Enter the key manually.
  2. Type the 6-digit code it shows and click Confirm and continue.
Lost or replaced your phone?

Contact Cravit and we reset your two-factor setup so you can enrol again.

3. Setting up your gateway

On first sign-in the console shows only three steps in the sidebar until you are done (or click Skip to Home).

Connect your Odoo: one form with the Odoo address, your login and API key, and one Connect button
  1. Connect your Odoo — one form. Paste the address you open Odoo with (for example https://yourcompany.odoo.com); the version and database appear under it (Change if not right). Your Odoo login is filled in; paste an Odoo API key, choose Yes or Read only and Live or Staging, and click Connect. The gateway checks the address, the database and your key in one go.
  2. Connect your assistant — one card per assistant. Click Copy address, add it in your assistant (three steps on the card, Guide for screenshots), and press Authorize on the page that opens. On the same browser within 30 minutes you are recognised: no key to paste.
Connect your assistant: a card per assistant with the address, and Connected — first answer at 14:02
  • Ask the suggested first question. The page turns green with Connected as soon as the answer comes through.
  • Show my connection key is for another browser or device (shown only on this page). Email me these steps sends the address and steps, never the key.

On Odoo 19 and later you don't need the database name. For older versions, if it is not detected: Odoo Online uses the first part of your address; on Odoo.sh it is the name shown on the production branch; on your own server, ask whoever runs it. Changing the address later (under Settings) always asks for a fresh authenticator code.

4. Finding your way around

Home page of the console: numbers for the last 7 days, insights with one-click actions, who uses it, Odoo connection
  • Home: the last seven days, Insights with one-click fixes (give access, remind, send a new-key link), Who uses it, your assistant address (Connect an assistant), and whether your Odoo is connected.
  • Users: who may use the AI, what each person may see and change.
  • Access: the areas of Odoo the AI may see for a person (Sales, Finance, …).
  • Activity: every question and every refusal, permanently.
  • Billing: your plan, invoices and billing details.
  • Settings: your Odoo connection, a staging copy, who may open this console, a company-wide instruction for the AI.

Any section can be folded with the arrow on its right; the console remembers it.

5. Giving someone access

On Users, click Add a colleague (top right). Type emails (one or several), or Pick from Odoo and tick your colleagues. Choose what the AI may see and whether it may make changes, then Send. People already connected or invited are greyed out. The tabs above the list (All · Can change · Read only · Admins · Invited · Inactive) show how many people are in each.

Users page: Add a colleague with Pick from Odoo, two colleagues ticked and Send 2 invitations
  • What may the AI see? An area of Odoo — Sales, Finance, Purchasing, Inventory, Projects, HR, Contacts — or Everything. Within an area the person's own Odoo rights still apply; the AI never sees more than they could.
  • Allow changes? No — read only. Yes: it may also create and update records as that person, and asks before changing more than one record at a time.

Your colleague gets a mail with one button. The page asks for one thing, their own Odoo API key, and then shows their connection key. They open their AI assistant, connect Cravit Gateway under Connectors and paste the key when it asks. You never handle their Odoo key, and no key travels by email.

The page a colleague sees after entering their Odoo key: You're connected, with their connection key and a Copy button

Adding the connector to the assistant is your job as administrator (step 3 of Set up); on a Claude Team or Enterprise plan you add it once for everyone. A colleague who has to add it themselves, for example on a personal plan, clicks Cravit Gateway not in your list? on that page for the address and the steps.

  • A link is personal, works once and expires after seven days. Until it is opened, the person shows in the list with status Invited; the ⋯ menu on that row sends it again or withdraws it.
  • Later, a person's Actions menu lets you ask them for a new Odoo key, give them a new connection key, add or remove live or staging access separately, add a personal instruction for the AI, or stop their access altogether (reversible).
  • Remove live Odoo access / Remove staging access take one connection away and keep the person in the list with their roles and history; with neither connection left they show as No access. Add it back from the same menu — they get a new connection key. A revoked key stops working within a minute, also for an assistant that is already connected.
  • Email not arriving? Check spam, then Resend. If sending fails, the console shows you the link to pass on yourself.

Advanced: staging, or entering their key yourself

Click Add a colleague, then open Advanced.

Add a colleague with Advanced open: which Odoo, and the form to enter a person's Odoo key yourself
  • Which Odoo: the invitation is for your live Odoo or the staging. The other can be added later from the person's Actions menu.
  • Have their Odoo API key at hand, or setting up a bot with no inbox? Fill in the form and the connection key is shown to you once, with Copy connection instructions for a ready-made message.
A connection key is shown once

If it is lost, choose New connection key in the person's Actions menu. Their Odoo key stays as it is.

More than one administrator

Open a user's Actions menu and choose Make administrator. They get a personal one-time link by email; opening it creates their own admin key (shown to them once), and they set up their own authenticator. The key is never in the email. Their AI access does not change.

Actions menu on a user row with the invite options and Make administrator

Remove admin access is in the same menu. You cannot remove yourself, and the last administrator cannot be removed. A person can administer one gateway only.

Generating an Odoo API key

Each user makes their own, in about a minute:

  1. In Odoo, click your avatar → My Profile (or Preferences).
    Odoo user menu with My Preferences
  2. Open the Security tab → Add API Key, confirm your password.
    Odoo Security tab with API Keys
  3. Description: "Cravit Gateway". Duration: see the warning below.
  4. Generate Key and copy it at once. Odoo shows it only once.
The most common mistake: a key that expires in a day

The duration defaults to 1 Day. Choose Persistent Key (or 1 Year). Duration cannot be changed afterwards; delete and generate a new key if it is too short.

Odoo API key duration options

No Security tab or Add API Key? On hosted Odoo plans, API keys may need a higher-tier plan.

Staging (optional)

You can connect a staging copy of Odoo (an Odoo.sh staging branch or a duplicate) next to your live one. A person gets a separate connection key for it, which only works on the staging address (ending in /staging/mcp).

  • Connect it under Settings → Staging: address, database, version, Test connection, save with an authenticator code.
  • Starting with staging is fine: connect only that on the Set up page, give people staging access, and connect your live Odoo under Settings whenever you are ready — then add live access per person.
  • Invite people for staging (Advanced → Which Odoo), or use Add staging access in their Actions menu. They add it as a separate connector in their assistant.
  • The same area, change permission and confirmations apply on both. Remove staging access or Remove live Odoo access takes one away; Stop their access switches off both.
  • After an Odoo.sh rebuild: update the database name under Settings → Staging, and send people Ask for a new Odoo key (staging).

6. Controlling what the AI can see

Access lists the areas of Odoo. Pick one for a person on the Users page; that is all most companies need.

Access page with the seven areas, Everything, and the Custom access list
  • Sales quotes, orders, customers, leads · Finance invoices, bills, payments · Purchasing · Inventory incl. manufacturing · Projects incl. timesheets · HR · Contacts · Everything: no limit beyond Odoo's own rights.
  • Areas follow the apps installed in your Odoo once a browsing login is connected (optional, under the area editor).

Open an area to see exactly which Odoo data it covers, in plain words and with the technical name. You can add or remove data, and set how many records one change may touch and when the AI must ask first. An adjusted area is marked customised; Reset to standard puts it back.

The Sales area opened for editing: each Odoo model with its plain name and Read / Create / Update

Custom access is for custom modules or stricter rules: start from scratch, name it, and list the Odoo models yourself. Access you created before this version is kept there unchanged, under the names you gave it.

Two switches, one answer

An area says what the AI may see; Allow changes? on the Users page says whether it may change anything. A person with changes set to No can never write, whatever their area allows.

7. Checking what happened

Every request, allowed or refused, with who made it. Nothing can be edited or deleted.

Activity page

Open Activity. Filter by person, result, Odoo (live or staging), data (for example Invoices) and date (UTC). Full details shows the records involved; Export CSV downloads the rows shown. "Pending confirmation" means the AI paused to ask, not a refusal.

8. Billing

Billing page: first-month banner, your plan with users and amount per month, invoices, billing details form
  • Your plan: the users you have today, how many are included, and what the next month costs (a base amount per Odoo plus an amount per extra user, excl. VAT). Users are counted once a day. Adding a user mid-month adds the rest of that month pro-rata to your invoice; removing one takes effect on the next invoice.
  • First month free: your subscription starts the day your gateway is created and the first invoice is € 0. From the second month you pay per month, in advance, within 14 days of the invoice.
  • If an invoice stays unpaid: the administrators get one reminder with the date the service would pause. If it is still unpaid 14 days after the due date, the AI assistants of your organisation stop answering (they say so, and point to this page); the console keeps working. Administrators get one notice on the day of the pause and one confirmation when the service is back. Paying the open invoice restores access within a few minutes.
  • Invoices: every invoice with its date, due date, status and a Pay or View link that opens it on Cravit's customer portal. Payment works the same way as for any Cravit invoice.
  • Billing details: legal name, VAT number, billing email and address, as they appear on your invoices. Details that Cravit already has on file are not overwritten; ask your Cravit contact to change those.
  • Your term: the annual term starts when the free month ends and runs for a year; after that monthly, with one month's notice. The page shows both dates.
  • Not for you? During the free month you can cancel on this page at no cost: the gateway stays on until the free month ends and is then switched off; nothing is invoiced. The full terms are at cravitgateway.com/terms.

9. Settings

Settings page with the Live Odoo and Staging tabs
  • Odoo: Live Odoo and Staging tabs, each with address, database, version, Test connection and an on/off switch. Saving needs an authenticator code. Switching one off stops every key for it at once; nothing is deleted.
  • Notification email: where account notices go.
  • Require IP allow-list: administrators may sign in only from the addresses you list. Turn it off if your office has no fixed IP.
  • What the AI sees first: per kind of data, the fields an answer starts with. Remove or add fields; Back to standard undoes it. The AI can still ask for any other field.
  • AI Prompt: company-wide guidance the AI sees daily. Guidance only; use Access for anything that must be enforced.
What the AI sees first: Quotes and orders with its fields as chips and Add field

Your portal domain is handled by Cravit; see Getting help.

10. Signing in from now on

Email, sign-in key, then the current 6-digit code. Your session ends when you close the browser or click the gear next to your name (bottom left) → Sign out. Help is in the same menu.

Connect an assistant

Claude

Claude acts as you, within the access your administrator set. It never sees your Odoo password or API key, and bulk changes pause for your confirmation.

You need

Your connection key (cgw_…) and your MCP address, for example https://yourcompany.cravitgateway.com/mcp. Both come from your administrator.

Custom connectors work on every Claude plan. On Team and Enterprise an Owner adds the connector once for everyone (step 1); on Pro or Max skip to step 2.

1. Once per organisation (Owner or Admin)

  1. Organization settings → Connectors → Add custom connector → Web.
  2. Name it "Cravit Gateway" and paste the MCP address. Leave client ID and secret empty.
  3. Click Add.

2. Connect your own account

  1. Settings → Connectors → Cravit Gateway → Connect.
  2. Click Authorize. On another browser or later than 30 minutes after creating your key: Use a key instead, paste your cgw_ key, Authorize.
    Authorize page: your name, the site that asked, Authorize and Use a key instead

Your key is checked by the gateway and never stored by Claude. Got a staging key too? Add it as a separate connector using the /staging/mcp address.

3. Use it

  1. New chat → + → Connectors → turn on Cravit Gateway.
  2. Ask.
  • "Look up the contact details for [company] in Odoo."
  • "List my open opportunities closing this month."
  • "Update the phone number on this contact to [number]." (needs write access)

If something doesn't work

  • Key rejected: copy the whole key, no spaces; check it was not rotated or revoked.
  • "Not allowed": your role is working as intended. Ask your administrator.
  • Connector missing: step 1 has not been done for your organisation.
Connect an assistant

ChatGPT

ChatGPT acts as you, within the access your administrator set. It never sees your Odoo password or API key.

You need

A paid plan (Plus, Pro, Business, Enterprise or Edu), your connection key (cgw_…) and your MCP address. On Business, Enterprise and Edu your workspace admin may first have to allow custom connectors.

1. Turn on Developer Mode

Settings → Apps & Connectors → Advanced settings → Developer mode. Accept the warning about unverified connectors.

2. Add the connector

  1. Settings → Apps & Connectors → Create.
  2. Fill in:
    NameCravit Gateway
    MCP server URLhttps://yourcompany.cravitgateway.com/mcp
    AuthenticationOAuth (detected automatically, no client ID needed)
  3. Click Create, then Authorize on the gateway page (paste your cgw_ key if it asks for one).

Staging key too? Add a second connector with the /staging/mcp address.

3. Use it

New chat → open the tools picker → turn on Cravit Gateway → ask, for example "Find all open sales orders for [customer]".

If something doesn't work

  • No Developer Mode or Create button: Free plan, or your workspace admin has not allowed custom connectors.
  • Key rejected: copy the whole key; check it was not rotated or revoked.
  • "Not allowed": your role is working as intended.
Connect an assistant

Microsoft 365 Copilot

In Microsoft 365 the connector is added once by your IT administrator; each person then signs in with their own connection key. Copilot never sees anyone's Odoo password or API key.

Your administrator needs

The Global Administrator or AI Administrator role, access to the Teams Developer Portal, your MCP address (https://yourcompany.cravitgateway.com/mcp), and the OAuth details Cravit sends on request: client ID and secret, authorization, token and refresh endpoints, and scopes. Each user needs a Microsoft 365 Copilot licence.

1. Register the gateway's OAuth connection (IT)

  1. Ask Cravit for the OAuth details. Tell us the Microsoft redirect URL is https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect.
  2. In the Teams Developer Portal: Tools → OAuth Client Registration → + New OAuth connection.
  3. Enter name "Cravit Gateway", the client ID and secret, the three endpoints and the scopes. Enable PKCE.
  4. Save and copy the OAuth client registration ID.

2. Add the connector (IT)

  1. Microsoft 365 admin center → Copilot → Connectors → Gallery.
  2. Under Created by your org → Create a new connector → Add → Connect to MCP server → Add.
  3. Display name "Cravit Gateway", base URL = your MCP address, and the OAuth registration ID from step 1. Save.
  4. Under Your connections, open it → Staged rollout → add test users or groups, then Deploy to all users.
  5. Check Agents → Settings: "Allow agents and plugins built by your organization" must be on, and User access must include these users. Changes take up to 10 minutes.
Prefer a walkthrough?

Microsoft's screens change often. Write to support@cravitgateway.com and we do this step together with your administrator.

3. For each person

  1. In Copilot Chat: Settings → Sources → Cravit Gateway → Connect. (Start a new conversation if it is not listed yet.)
  2. Click Authorize on the gateway page (paste your cgw_ key if it asks for one).
    Authorize page: your name, the site that asked, Authorize and Use a key instead
  3. Ask Copilot, for example "Find all open sales orders for [customer]".

Staging key too? IT adds a second connector with the /staging/mcp address.

If something doesn't work

  • Connector not listed: not rolled out to you yet, or a Copilot setting blocks it. Ask IT.
  • Sign-in loops or fails: the OAuth registration, not your key. Ask IT to check the endpoints and the registration ID.
  • "Not allowed": your role is working as intended.
  • "Not supported type … RecordsOnlyTableValue": refresh the gateway's tools in Copilot Studio (or remove and add it again).
Connect an assistant

Gemini

Gemini can use Cravit Gateway in two ways, depending on your Google account.

Gemini Enterprise (work accounts, set up by IT)

Your administrator needs

Gemini Enterprise (Business edition) at business.gemini.google, your MCP address, and the OAuth details Cravit sends on request: client ID and secret, authorization URL, token URL and scopes. Tell us the Google redirect URL is https://vertexaisearch.cloud.google.com/oauth-redirect.

  1. Settings & help → your team → Manage team → Connected apps → Add MCP Server.
  2. Server URL = your MCP address, name "Cravit Gateway". Next.
  3. Authentication: OAuth 2.0. Enter the authorization URL, token URL, client ID, secret and scopes; add offline_access to the scopes. Verify Auth → Continue.
  4. Choose a region and a data-store name → Add.
  5. On the Connectors page, enable the new connection. It is off until you do.

Each person then opens the connector in Gemini, signs in with their cgw_ key on the gateway page and clicks Authorize.

Gemini app (personal Google account)

Currently available only for personal accounts, in the US, in English, on the web (not the mobile app). Work or school accounts cannot add custom apps yet.

  1. On gemini.google.com: Settings → Connected Apps (under Personal Intelligence if you don't see it).
  2. Under Custom apps, paste your MCP address and click Next. If asked for credentials, use the details from Cravit.
  3. Sign in with your cgw_ key and click Authorize.
  4. In a chat, type @, pick Cravit Gateway, and ask.

If something doesn't work

  • Can't see Connected Apps: work account on the consumer app, or Activity is off. Use Gemini Enterprise instead.
  • Verify Auth fails: check the URLs have no query parameters and the scopes match what Cravit gave you.
  • "Not allowed": your role is working as intended.
Using it

What you can ask

Ask in your own words. These questions get a ready-made report in one step:

AskApp
Which quotations are still open?Sales
Sales by salesperson this month?Sales
Who are our top customers this quarter?Sales
What does the pipeline look like?CRM
Which customer invoices are overdue?Invoicing
Which vendor bills are unpaid?Invoicing
Revenue by month for the last year?Invoicing
Which purchase orders are we still waiting for?Purchase
Which deliveries are late?Inventory
Which tasks are overdue?Project
Hours by person last month?Timesheets
Who is off today?Time Off

Periods: this month, last month, this quarter, this year, last 12 months. You only get reports for apps you have and data your role allows. Anything else, just ask.

Changing records

Before anything is created or changed, the assistant shows what will change, old → new, and waits for your yes. After a search you can simply say "change these" or "mark them done"; it uses the records it just found. Words like "orders", "invoices", "facturen" or "Kunden" are fine; you don't need Odoo's technical names.

Support

Getting help

Lost a connection key or need different access? Ask your own administrator first; they can do it in the console.

Locked out, lost your admin key or authenticator, need OAuth details for Copilot or Gemini, or stuck connecting an assistant? Email support@cravitgateway.com. Include your workspace name (yourcompany.cravitgateway.com) and, for connection problems, which assistant and what the screen says.