Skip to main content

Connecting to the OneIQ MCP

How to connect to the OneIQ MCP so you can access OneIQ data directly inside your AI assistant.

Written by Omega Team

OneIQ can now be connected directly to AI assistants like Claude and ChatGPT using a secure, read-only connector. Once connected, you can ask your assistant to pull in OneIQ data as part of your conversation, without leaving the chat.

Setup takes about a minute and works a little differently depending on which assistant you use. Find your tool below.

Jump to:

Requirements

  • A OneIQ account with an active login to the OneIQ platform

  • Claude - Pro, Max, Team, or Enterprise plans

  • ChatGPT - Plus (web only), Pro, Business, Enterprise and Edu)

  • Copilot Studio - A Copilot Studio licence (or an active trial) and maker permissions in your Power Platform environment along with a Microsoft 365 Copilot licence

  • Grok - A Grok account

  • Muse - A Meta account

  • The connector URL: https://mcp.oneiq.com

Claude

Pro and Max plans

  1. Go to Settings > Customize > Connectors

  2. Click the "+" button, then select "Add custom connector"

  3. Enter https://mcp.oneiq.com as the remote MCP server URL

  4. Give it a name (e.g. "OneIQ")

  5. Click Add


​
​Team and Enterprise plans

An Owner adds the connector once, org-wide:

  1. Navigate to Organization settings > Connectors

  2. Click Add, hover over Custom, then select Web

  3. Enter https://mcp.oneiq.com as the remote MCP server URL

  4. Click Add

Each member then connects individually:

  1. Go to Settings > Customize > Connectors

  2. Locate the OneIQ connector your Owner added

  3. Click Connect to authenticate

Claude Code

For instructions on configuring Claude Code, please click here.
​

​

What happens next (all plans)

After clicking Add/Connect, Claude will redirect you to OneIQ. If you're not already logged in to the OneIQ platform, you'll be asked to log in first.


​
​

You'll then see a consent screen asking you to authorize Claude to access OneIQ on your behalf, in read-only mode. Click Allow, and you'll be redirected back to Claude with the connector active.

AI generated image


​

On this consent screen you'll also see a checkbox for Maintain access to your account so it can continue working even when you're not using it. OneIQ's connector now advertises support for offline access (i.e. refresh token), so most clients request it and the box is checked by default. Leaving it checked means your connection can keep working beyond your current sign-in session, without needing to be re-authorized.
​
If you'd rather limit access to just this session, uncheck the box before clicking Allow — without offline access, your connection stays tied to your current session, which lasts 7 days before you'll need to sign in again.

You don't need to fill in any OAuth Client ID or Secret fields — authentication is handled automatically once you enter the URL and log in.

Once connected, you can enable OneIQ for a specific conversation via the "+" button in the lower left of the chat box, then Connectors.
​

Optional: Set tool permissions

Once connected, you can control how much autonomy Claude has when using OneIQ's tools. Go to Settings > Customize > Connectors, then select OneIQ.

Under Tool permissions, you'll see the list of OneIQ tools available to you (e.g. Find cloud instance, Get exchange rate, Query datasource, and others). For each tool — or for all of them at once via the "Other tools" group — you can choose:

  • Always allow (check icon) — Claude can use the tool without asking first

  • Needs approval (hand icon) — Claude will ask before each use (this is the default)

  • Never allow (blocked icon) — Claude cannot use the tool at all

This lets you decide, for example, whether Claude should be able to query OneIQ data sources automatically, or should check with you before running each query.


​
​

ChatGPT

In ChatGPT, this feature is called a Plugin rather than a connector, but the flow is the same.

  1. Launch the ChatGPT Desktop app or login to chatgpt.com

  2. In the sidebar and select Plugins (under "More" if it's not shown directly)
    ​

  3. [ChatGPT Desktop] On the Plugins page, first click on "Browse Directory"
    ​


    ​[ChatGPT Web] On the plugins page, click on + and then click on Add custom MCP server


    ​

  4. [ChatGPT Desktop] Next, click on the Add button in the top right and select Create MCP App
    ​


    ​[ChatGPT Web] Click on Create MCP App
    ​


    ​

  5. In the Create MCP App dialog, enter a Name (e.g. "OneIQ"). Leave the icon and description optional

  6. Under Connection, keep Server URL selected and enter https://mcp.oneiq.com

  7. Leave Authentication set to OAuth — no manual credentials are needed.

  8. Click on Advanced OAuth settings to bring up the advanced settings

  9. Under Scopes (optional, one per line) enter the following scopes:

    1. mcp_user (this may already be checked as a default scope)

    2. offline_access

  10. Check "I understand and want to continue"

  11. Click Create

  12. After clicking Create, ChatGPT will first ask you to continue to confirm that you want to add the OneIQ MCP.

  13. Click on Continue to OneIQ MCP. This will redirect you to OneIQ to log in (if needed) and authorize access — the same as the Claude flow above (see What happens next (all plans)). Click Allow to finish connecting and keep the offline access permission checked if desired.
    ​

Microsoft Copilot Studio (Microsoft 365 Copilot)

For instructions on configuring Microsoft 365 Copilot with Copilot Studio, please click here.

Grok

  1. Log in to Grok and go to Plugins in the left navbar
    ​

  2. Click New Connector in the top right corner
    ​


    ​

  3. Click + Custom to add your own custom connector
    ​

  4. Enter a name for your connector (e.g. "OneIQ MCP") and enter https://mcp.oneiq.com for the Server URL, then click Add Connector
    ​

    ​
    ​

  5. This will redirect you to OneIQ to log in (if needed) and authorize access — the same as the Claude flow above (see What happens next (all plans)). Click Allow to finish connecting and keep the offline access permission checked if desired.
    ​

Muse (Meta AI)

Muse sets up the connection from the chat itself, so there's no separate settings page to fill in.

  1. Log in to Muse and start a new chat
    ​

  2. Ask Muse to connect to the OneIQ MCP Server, for example: "Can you create a connection to the OneIQ MCP Server at https://mcp.oneiq.com?"
    ​

  3. Muse will reply with a short explanation of how the connection works and show an Oneiq Connector card. Click Connect on the card
    ​


    ​

  4. A Custom connector dialog appears, noting that Meta doesn't review custom connectors. Click Connect to continue
    ​


    ​

  5. This will redirect you to OneIQ to log in (if needed) and authorize access — the same as the Claude flow above (see What happens next (all plans)). Click Allow to finish connecting and keep the offline access permission checked if desired.
    ​

    AI generated image


    ​

  6. You'll be redirected back to Muse, which will confirm that OneIQ is connected. You can then ask Muse to list your data sources, summarize one, or look up cloud instance and processor reference data
    ​

You can disconnect OneIQ from Muse at any time in Muse's Settings.
​

OpenAI Codex

For instructions on configuring Codex, please click here.

Google Antigravity

For instructions on configuring Google Antigravity (and Antigravity CLI), please click here.

Troubleshooting

I don't see the OneIQ connector under Organization settings (Claude Team/Enterprise)

Only Owners can add connectors org-wide. Ask your workspace's Claude Owner/admin to add it under Organization settings > Connectors, then connect to it yourself from Settings > Customize > Connectors.

I'm stuck on the OneIQ login or authorization screen

Make sure you're logging in with your OneIQ account credentials, not your Claude, ChatGPT or Meta credentials. If the issue persists, contact your OneIQ administrator.

Source articles

Have questions or run into an issue not covered here? Let us know! 🙂

Did this answer your question?