Workspace, settings & billing

Connect an AI assistant

7 min read
You can connect the AI assistant you already use, such as Claude, ChatGPT or Microsoft 365 Copilot, to your OroMiQ workspace and ask it about your week, your pipeline or your invoices. It works as you, with your permissions, and never does more than you allow. Connecting takes about five minutes.

Before you start

Before you start:

  • AI assistants must be switched on for your workspace by the OroMiQ team. If there is no AI assistants card in Settings → Integrations, they are not on yet: raise a support request to ask,
  • you need an assistant that can add a custom connector or MCP server. The sections at the end of this guide say what each one needs, and
  • a workspace admin can pause assistants or limit what they see. If something is withheld, the sign-in screen tells you.

Copy the server address

In the sidebar, open Settings then Integrations, and scroll to the AI assistants card. Under Connect an assistant, click the copy button beside the server address.

The address is the same for every assistant. You paste it into your assistant in the next step.

The AI assistants card in Settings, Integrations: Your connections says No assistant is connected yet, and under Connect an assistant the server address https://api.oromiq.com/mcp sits beside a copy button, above How to add it to each assistant.

Add OroMiQ to your assistant

Paste the address where your assistant adds a custom connector or MCP server. The steps for Claude, Claude Code, ChatGPT and Microsoft 365 Copilot are at the end of this guide.

When the assistant connects, it opens OroMiQ in your browser. If you are not signed in, sign in as usual, with your two-step verification if you use it.

Check what the assistant asks for, then allow it

The Connect an AI assistant screen tells you what you are agreeing to. Read it before you decide:

  • the assistant, by its web address (such as claude.ai), never by a name it gives itself,
  • the workspace it will work in,
  • under It will be able to, what it may do, in plain words, and
  • beside After you decide, your browser goes back to, where your browser is sent next.

Click Allow to connect, or Don’t allow to refuse. Your browser goes back to the assistant either way.

Note

If the assistant’s address and the address your browser goes back to are different, the screen warns you. Only allow it if you expected that. If your workspace’s policy withholds something the assistant asked for, it is listed under It asked for, and will not get.
The Connect an AI assistant screen in OroMiQ: claude.ai wants to use OroMiQ as you, in Brindlemoor Advisory. It will be able to read companies, contacts, pipeline, activity and tasks, read your calendar and meetings, read invoices and balances, and read the data-layer facts OroMiQ already holds on your companies. After you decide, your browser goes back to claude.ai. Buttons: Don’t allow and Allow.

Confirm it is you

The screen shows Confirm it is you. If your account uses two-step verification, enter the six-digit code from your authenticator app and click Confirm, or click Use a passkey if you have one. If it does not, enter your password and click Confirm. Then click Allow.

You confirm every new connection, even if you signed in with two-step verification a moment ago. Allow stays greyed out until you have.

Tip

An assistant that asks to make changes lists Add notes, tasks, records and products, and move opportunities too. If you connected one that can only read, OroMiQ refuses the first change it tries and the assistant has to bring you back to this screen to ask again.
The same screen for chatgpt.com, which also asks to add notes, tasks and records, and move opportunities. Below it, Confirm it is you asks for the six-digit code from your authenticator app, with an Authenticator code field and a Confirm button. Allow is greyed out, with the hint Confirm it is you above before you allow the assistant.

Ask it something

Go back to your assistant and ask in your own words, for example:

  • “What should I work on this week?”
  • “Tell me about the company I’m meeting on Thursday: who we know there and where the deal stands.”
  • “Who owes us money?”
  • “I’ve just come off a call with Priya. Add a note to her company.”

There is no fixed list of questions. The assistant reads your companies, contacts, pipeline, tasks, calendar and, if your workspace uses Finance, your invoices, then answers.

Once you allow changes, it can also add notes, log calls and meetings, add and complete tasks, add and update companies and contacts, add opportunities with products on them, update them and move companies between pipeline stages, add calendar events, keep your product catalogue, put a chart from a data layer on one of your dashboards, and check a list of companies and contacts with you before importing it. If your workspace has a data layer, a column of register identifiers in that list (company numbers, say) is matched the way Bulk import matches it: the assistant tells you how many matched, how many companies it would create from their records and what that costs in tokens, and asks before it goes ahead. It cannot delete anything, send email or issue invoices.

Read before you confirm

Notes, emails and imported files in your CRM can contain text written to an assistant, such as “ignore your instructions and…”. OroMiQ cannot stop an assistant reading it. Your assistant shows you what it is about to change and asks you to confirm: that prompt is your check, so read it before you say yes.

Where your data goes

Everything the assistant reads from OroMiQ is sent to the company that runs the assistant, such as Anthropic, OpenAI or Microsoft, and handled under your agreement with them.

See your connections

Back in Settings → Integrations, the AI assistants card lists each assistant you have connected under Your connections: its address, what it may do, when you connected it and when it was last used.

The AI assistants card with one connection under Your connections: claude.ai (Claude), with what it may do in words, Connected just now, last used just now, and a Revoke button.

Revoke a connection

Click Revoke beside the connection, then Revoke again to confirm. The assistant stops at once. You can connect it again later by repeating these steps.

Note

A workspace admin can revoke any connection in the workspace. Changing or resetting your password revokes all of your connections, and so does your account being locked, deactivated or deleted.
Settings, Integrations with a Revoke claude.ai? window open over the AI assistants card: The assistant stops at once. You can connect it again later. Buttons: Cancel and Revoke.

Add OroMiQ to your assistant

The vendors’ own steps, as their help pages describe them today. Their screens change from time to time, so if a label has moved, their help page has the latest. Wherever you are asked for a URL, paste the server address from step 1.

Claude (web, desktop and mobile)

Custom connectors work on every Claude plan. On the Free plan you can add one.

On your own plan, such as Pro or Max, add it yourself:

  1. Go to Customize → Connectors, click + Add, then Add custom connector.
  2. Enter a name, such as OroMiQ, paste the server address and click Continue.
  3. Review the authentication settings Claude found and click Continue. Under OAuth client, keep Use Claude’s published identity (Recommended).
  4. Click Add, then sign in to OroMiQ when Claude asks.

On a Team or Enterprise plan, an Owner adds OroMiQ once for everyone, in Organization settings → Connectors: click Add, hover over Custom, select Web, and follow the same steps. Each team member then goes to Customize → Connectors, finds OroMiQ and clicks Connect, so Claude works with their own OroMiQ account.

To switch OroMiQ on or off in a chat, click the + button at the lower left of the chat, then Connectors.

Claude Code

In your terminal, run:

claude mcp add --transport http oromiq https://api.oromiq.com/mcp

Then, in Claude Code, type /mcp and follow the steps in your browser to sign in.

ChatGPT

Whether you can add a custom server depends on your ChatGPT plan and your workspace’s settings. On a ChatGPT Business or Enterprise workspace, your ChatGPT admin decides who may create plugins with MCP servers, which uses developer mode. If you cannot see the option, ask them.

  1. Go to ChatGPT Plugins, select the plus button, then Add custom MCP server.
  2. Enter a name and a short description. Under Connection, paste the server address, including /mcp at the end.
  3. Set up the authentication, review the risk warning and select I understand and want to continue.
  4. Select Create as a plugin.
  5. Start a new conversation, type @ and pick OroMiQ. Sign in to OroMiQ when ChatGPT asks.

Microsoft 365 Copilot

Microsoft’s assistants reach OroMiQ through an agent built in Copilot Studio, so this is a job for whoever builds agents in your organisation, not something each person sets up. In Copilot Studio they:

  1. Open the agent’s Tools page, select Add a tool, then New tool, then Model Context Protocol.
  2. Fill in Server name, Server description and Server URL (the server address).
  3. Choose OAuth 2.0 as the authentication, with the type Dynamic discovery, then select Create and Next.
  4. On Add tool, create a new connection, then select Add to agent.

Each person who uses the agent signs in to OroMiQ with their own account the first time, so it works with their permissions. Your organisation’s Power Platform data policies also apply to MCP servers in Copilot Studio, so an admin may need to allow it. How the agent is then made available in Microsoft 365 Copilot depends on your organisation: ask your Microsoft 365 admin.

Other assistants

Any assistant that can connect to a remote MCP server with OAuth sign-in can use the same server address. If yours is not listed here and will not connect, raise a support request and tell us which one it is.