On Pro and Max: Customize > Connectors, then + and Add custom connector, and paste the server URL. On Team and Enterprise an owner adds it first under Organization settings > Connectors.
Model Context Protocol (MCP)
Connect QrX toyour AI assistant
Ask about your stock, orders, returns and CRM in plain language, and make small, safe changes.
QrX supports the Model Context Protocol (MCP). Merchants and fulfilment partners connect QrX to Claude, ChatGPT, Cursor, Claude Code or any other MCP client. The assistant only sees what you may already see in QrX.
How to connect
Connected in three steps
Remote MCP over Streamable HTTP with OAuth. There are no API keys to copy: you sign in with your normal QrX portal account.
- 01
Add the QrX server
In your assistant, add a custom connector or MCP server with the server URL below.
- 02
Sign in to QrX
The assistant opens QrX. Sign in with your normal QrX portal account.
- 03
Choose what it may do
On the consent screen you tick what the assistant may read and which changes it may make.
https://api.qr-x.net/mcpWhere to add it
Run this command in your terminal:
claude mcp add --transport http qrx https://api.qr-x.net/mcpAdd QrX under mcpServers in your mcp.json, with the server URL as url:
{
"mcpServers": {
"qrx": { "url": "https://api.qr-x.net/mcp" }
}
}Add a custom connector or MCP server with the server URL, then sign in to QrX and choose what it may do.
What it can read
You choose what it may see
Each scope is limited to what your user may already see in QrX. Tick only what you need.
- Stock and warehouseStock levels, warehouses, orders waiting, pick lists, packed orders, outbound orders, lots, the carrier handover, counts, inbound deliveries, purchasing, transfers, containers, kits, serial numbers, team tasks and productivity.
- OrdersOrder and payment status, order details with masked consumer email, work tags, delivery exceptions, Track & Trace visits and parcels that need attention.
- Returns
- Products
- InsightsSales dashboard, payments at the door, your QrX invoices, plans and usage, and a summary of today.
- Message Centre overviewOpt-in. Without any message text.
- Message textOpt-in. Only when you tick it. Includes the files in your conversations.
- CRMPeople, companies, deals, tasks, filed emails, quotes, meetings and calendar, sequences, Spaces, Channels and Posts, calls, automations and CRM reports, as far as your role sees them. Your own contact data in full.
- 3PL billingOpt-in, for fulfilment partners. The charges, invoices and rate cards you bill your clients.
What it can change
Small changes, always confirmed
Every write scope is off by default and needs its read scope. Every change is shown as a preview first and only happens after you confirm. QrX logs each change with your name and the assistant's name.
- Park or prioritise orders
- Correct stock, always with a reason
- Quarantine and release stock
- Link an unmapped product to a stock item
- Start a stock count from a count plan
- Prioritise a backorder
- Create, change or cancel an inbound order
- Create or update a CRM person or company
- Add a note or a task
- Create a deal or move it to another stage
- Link an order to a deal
- Start a CloudTalk call
- Reply in a conversation, assign, resolve or snooze it
- Assign, approve, reject or move a return and message the consumer
- Create a return label or decide a partner proposal
- Add or remove work tags on an order
- Take a product offline or set its stock
- Create a purchase order or a warehouse team task
- Create, update and send a CRM quote
- Plan, move or cancel a meeting
- Start or stop a follow-up sequence for a person
- Create, ship or cancel orders
- Buy or void order shipping labels
- Take payments or refund orders
- Delete anything
- Change settings, users or permissions
Safety and privacy
Your permissions, nothing more
The assistant works inside the same limits as your own QrX login.
- Your own permissions. The assistant gets exactly your QrX permissions and only the scopes you ticked.
- No QrX admin data. Data that only QrX admins may see is never shared.
- Masked email addresses. Consumer email addresses are masked.
- Every change logged. With your name and the assistant's name.
- Disconnect any time. In Settings > Advanced > Connected apps in the QrX portal at https://portal.qr-x.app.
Who it is for
Included on every paid plan
The MCP connector is included for every customer on a paid plan. Warehouse tools appear when the WMS module is active, and returns tools when your QrX role may manage returns.