Connect QrX to Your AI Assistant (MCP)

You can connect QrX to an AI assistant such as Claude, ChatGPT or Cursor. After connecting, you can ask questions in plain language, for example "Which products are low on stock?", "How many orders are waiting to be packed?", "What is the payment status of order 10452?" or "What needs my attention today?". The assistant reads the answer straight from your QrX account. If you allow it, the assistant can also make a small set of warehouse changes, always after you confirm.

The connection uses MCP (Model Context Protocol), the open standard that AI assistants use to talk to other software. QrX runs an MCP server; your assistant connects to it as a custom connector.

Who Can Use It

The AI connector is included in QrX paid plans. There is no separate price.
You sign in with your own QrX portal account. The assistant gets the same permissions as you have in QrX, never more.
Stock and warehouse questions and warehouse changes need the QrX Warehouse (WMS) module. Returns questions need the permission to manage returns in your QrX role. Tools for a module you do not use are not shown to the assistant.
QrX admin accounts cannot connect. If you are viewing PortalX as another user, stop that first and sign in with your own account.
CRM questions need the CRM permissions in your QrX role (every QrX account has the free CRM plan). CRM changes also need the permission to edit the CRM.

What You Need

An AI assistant that supports custom MCP connectors (also called remote MCP servers or custom apps).
The QrX MCP server URL: https://api.qr-x.net/mcp
Your QrX portal account (the one you use on portal.qr-x.app).

How to Connect (Every Assistant)

In your AI assistant, open the place where you add connectors and choose to add a custom connector (or a custom MCP server).
Give it a name, for example "QrX", and enter the server URL https://api.qr-x.net/mcp. You do not need an API key, a client ID or a secret.
Start the sign-in. The QrX portal opens. Sign in with your QrX portal account if you are not signed in yet.
The QrX page "Connect [assistant] to QrX" shows the app, where it sends you back to, and a list of what the assistant may read. Tick only what you want to share. See "What the QrX AI Connector Can and Cannot Do" for what each option means.
Optional: tick Warehouse changes if the assistant may also make warehouse changes. It is off by default and needs Stock and warehouse.
Optional: tick CRM changes if the assistant may create or update CRM people, companies, deals, notes and tasks, move deals and start a call. It is off by default and needs CRM.
Optional: tick Message Centre replies, Return handling, Order tags or Product changes if the assistant may also reply in conversations, handle returns, change order work tags or take a product offline and set its stock. Each is off by default and needs its read option (Message text, Returns, Orders, Products). See "Use the QrX AI Connector for Conversations, Returns, Orders and Products".
Click Allow. You return to your assistant and the connection is ready. Click Deny to cancel without connecting.

The new connection now appears in QrX under Settings > Advanced > Connected apps.

Assistant-Specific Steps

Menu names in AI assistants change often. If a step below does not match what you see, follow the generic steps above and the help pages of your assistant.

Claude (Free, Pro and Max): go to Customize > Connectors, click + and then Add custom connector, enter the name and the URL https://api.qr-x.net/mcp, continue, then sign in with QrX. Turn the connector on in a chat with the + button, Connectors. On the Claude Free plan you can add one custom connector.
Claude (Team and Enterprise): an Owner adds the connector once under Organization settings > Connectors, Add, Custom, Web, with the same URL. Each member then goes to Customize > Connectors, finds QrX and clicks Connect to sign in with their own QrX account.
ChatGPT (Business, Enterprise and Edu): custom MCP apps need developer mode, which a workspace admin turns on. Then go to Settings > Apps > Create (admins can also use Workspace settings), enter the URL https://api.qr-x.net/mcp, choose OAuth, click Scan Tools, sign in with QrX and click Create.
Cursor: add QrX as a remote MCP server with the URL https://api.qr-x.net/mcp (in the MCP settings or in mcp.json), then sign in with QrX when Cursor asks.

Every person connects with their own QrX account, also when a connector is shared in a team workspace. The assistant then only sees what that person may see in QrX.

Good to Know

"Not verified" on the connect page means QrX has not verified the app and the app chose its own name. Only continue if you started the connection yourself from an assistant you trust. The page shows where your data goes.
What the assistant reads is sent to the company that runs your AI assistant, so it can answer you. Share only what you need. Message text is never shared unless you tick Message text.
You can disconnect at any time in Settings > Advanced > Connected apps. See "Disconnect (Revoke) a Connected AI App".
More about the QrX AI connector: qrx.eu/mcp.

Common Problems

"This connect link is not valid": the link expired or was already used. Start connecting again from your AI assistant.
"Sign in to continue": your QrX session ended. Sign in again and the connection continues.
"Your account cannot connect apps": your account has no access to the QrX portal. Ask an admin of your company for access.
"QrX admin accounts cannot connect": sign in with a merchant account instead.
An option on the connect page is greyed out: "This module is not active on your account" means you do not use that QrX module. "Your role does not allow this" means your QrX role lacks the permission; ask an admin of your account.
The assistant says it has no access or asks you to sign in again: the connection was disconnected, for example in Connected apps, when you signed out on all devices, or after a password reset. Connect again.
The assistant says it reached a limit: wait a minute and try again. See the limits in "What the QrX AI Connector Can and Cannot Do".

When to Contact Our Support Team

Contact QrX support when you followed the steps and the connection still fails, when you see a connection in Connected apps that nobody in your company recognises, or when the assistant shows data you think it should not see. Mention the assistant you use, the time you tried and the exact message on screen. Never send passwords or tokens.