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.

Sign in with your QrX accountYou choose what it may doEvery change is confirmed first
50rows at most per answer; the assistant pages for more
120tool calls per minute per connection
5,000tool calls per day per connection
30confirmed changes per minute

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.

  1. 01

    Add the QrX server

    In your assistant, add a custom connector or MCP server with the server URL below.

  2. 02

    Sign in to QrX

    The assistant opens QrX. Sign in with your normal QrX portal account.

  3. 03

    Choose what it may do

    On the consent screen you tick what the assistant may read and which changes it may make.

Server URLhttps://api.qr-x.net/mcp

Where to add it

Claude

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.

Claude Code

Run this command in your terminal:

claude mcp add --transport http qrx https://api.qr-x.net/mcp
Cursor

Add QrX under mcpServers in your mcp.json, with the server URL as url:

{
  "mcpServers": {
    "qrx": { "url": "https://api.qr-x.net/mcp" }
  }
}
ChatGPT and other MCP clients

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
What it can never do
  • 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.

ONE CONNECTION. ALL OF QRX.

Where next?