AI Assistants

What it is

You can connect an AI assistant such as Claude to CWS. Once connected, you can ask it questions in plain language and it looks the answers up in CWS for you. For example:

  • "Which jobs at the Sydney depot have been waiting for parts for more than 5 days?"
  • "Show me job 123456 and tell me what happened to it."
  • "How many open jobs do we have by status?"
  • "Do we have part ABC-100 in stock?"
  • "How do I set up an API client?"

What an assistant can do

An assistant can read CWS. It cannot add notes, change statuses or edit anything. Ask it in your own words; it picks what to look up.

Work orders

  • Search work orders by job number, customer name, phone number, email, address, serial number, model or reference.
  • List work orders by status, sub status, location, client (group scheme), branch, assigned user, priority, product type, brand, model, serial number, reference (third party, program, RA or invoice) or date, or the jobs that have sat in their sub status for more than a number of days.
  • Count work orders by status, sub status, location, client, priority, assigned user, product type, brand, month created, month closed or age, with the same filters.
  • Open one work order with its details, parts, labour, charges and totals, files (names only), shipments, loan products, bookings, authorisations and claim.
  • Read a work order's whole history: notes, system entries or both.
  • List your saved work order views (your own and those shared with you) and show the work orders of one of them. Filters of a view it cannot apply yet, such as Region or Salvage Grade, are named, so you know the list may hold more work orders than the view shows in CWS.

Customers, shipments and messages

  • Find customers by name, phone number, email address or customer number, at most 25 at a time, and open one customer with their contact details and latest work orders.
  • Track shipments by job number or courier tracking number.
  • Check which emails and SMS messages were sent for a job, or are still being sent. Who they went to is shown only partly, for example the last 3 digits of a phone number.

Stock

  • Look up parts by part number, description or barcode, with their warehouse stock, storage location (bin) and the quantity on order.
  • Open one part with its details, stock, storage location, quantity on order and the last 10 jobs that used it.
  • List a supplier's purchase orders, and its orders and returns.
  • Give a supplier's stock reports: low stock, warehouse stock (with storage location and the models each part fits), stock movements, item usage (the parts sent out most) and slow-moving stock (parts in stock that are rarely or never used).
  • List the parts that open jobs are still waiting for: requested, on order, on back order or unavailable, oldest first, or totalled per part.

Reports and audit trail

  • Open work orders and how old they are, by status, location, branch or model (Open Stats).
  • Aged work orders: open jobs that have sat in their sub status for at least a number of days (Aged Work Orders).
  • Work orders closed in a period with their turnaround, overall and per location (Closed Stats; costs only if you can see its financials).
  • How each location did: jobs closed in a period, their average age, and the share closed within 7, 14, 21 and 28 days.
  • The audit trail, for example who changed a job and when, or what a user did on a given day. Passwords recorded in it are hidden.

Clients, locations, users and help

  • The group schemes you can see with their branches, and a group scheme's product types, brands, models, fault symptoms and fault actions.
  • The locations you can see.
  • For administrators, the account's users with their roles and locations.
  • Search and read these help articles.

Attaching to a conversation

Assistants that support it let you attach a help article, a work order or one of its files (up to 5 MB, if you can open work order files) to a conversation, so the assistant has it in front of it from the start.

Permissions

It works as you. It sees only the work orders, locations, customers and stock that you can see in CWS, and nothing else.

Some answers need a permission:

  • Work order lists, counts and saved views need the same permission as the Workorders list. A work order's history, parts, charges, totals, files, shipments, authorisations and claim each need the same permission as that section of the work order screen.
  • Customers need the same permission as the Customers page.
  • Shipment tracking needs the same permission as the work order's shipments, and the emails and SMS sent for a job the same as the Notifications report.
  • Part lookups and a supplier's purchase orders need the same permission as the inventory item lists, and its orders and returns the same as its Orders tab. Its stock reports need the same permission as its reports, and the parts jobs are waiting for need either of those two.
  • Each report needs the same permission as that report in CWS; how each location did needs the same as Closed Stats. The audit trail needs the Audit Trail report.
  • Cost prices are shown to administrators only.

Your permissions are the only limit: an assistant connected as you can read whatever you can read in CWS, and never more. To give an assistant less, connect it as a user with fewer permissions.

Ready-made requests

Some assistants offer three ready-made requests. You pick one, fill in a detail or two, and the assistant follows set steps, so the answer comes back in the same layout every time.

Request You fill in You get
Stuck jobs digest Optional: the number of days (14 if left empty) and a client (group scheme) Open jobs that have sat in their sub status longer than that, grouped by sub status with the longest waits first: job number, days waiting, customer, product and client. It ends with a short summary and the five longest waits. Up to 100 jobs.
Summarise a job for a call A job number A brief of under 200 words to read during a phone call: the customer and their best number, the product and fault, where the job is now, the latest notes and anything outstanding, with up to three points to raise.
Customer history A customer's name, phone number or email The customer's contact details, how many jobs they have and how many are open, and their jobs newest first, with a note on any pattern such as repeat faults. If several customers match, it asks which one you mean.

Where to find them depends on the assistant. In Claude Code, type / and choose one starting with mcp__cws__, for example /mcp__cws__summarise_job_for_call 123456. In other assistants, look in the menu where you add files or connectors.

If your assistant does not show them, ask in your own words. It uses the same lookups, though the layout may differ:

  • "Summarise CWS job 123456 for a phone call I'm about to make."
  • "Show me the open CWS jobs stuck in their sub status for more than 14 days, grouped by sub status."
  • "Give me the history of the CWS customer 0412 345 678."

Before you start

You need the AI Assistant: Connect permission. An administrator gives it to your user group; administrators already have it. If you don't have it, the connection page tells you.

Connecting Claude

  1. In claude.ai or the Claude app, open Settings, then Connectors, then Add custom connector.
  2. Enter the name CWS and the URL https://youraccount.cws.app/mcp. Replace youraccount with your CWS account name, the same name you use to open CWS.
  3. Click Add, then Connect.
  4. Sign in to CWS if asked.
  5. Check the connection page and choose Connect.

Claude then shows CWS as connected and uses it when your question needs CWS data.

On a Claude Team or Enterprise plan, an owner adds the connector once for the organisation. Each person then connects with their own CWS login, so each person sees only their own data.

Connecting Claude Code

In a terminal, run:

claude mcp add --transport http cws https://youraccount.cws.app/mcp

Then start Claude Code, type /mcp, choose cws and sign in. Your browser opens the CWS connection page. Choose Connect.

Other assistants

Any assistant that supports connecting to an MCP server can use the same URL: https://youraccount.cws.app/mcp. Look for a setting called connectors, tools, integrations or MCP servers, and add a custom one. You sign in and approve it on the same connection page.

The connection page

When an assistant asks to connect, CWS shows a page with:

  • the name of the app asking, and the website it comes from;
  • who it will act as: you, at your account;
  • what it can do: act as you in CWS, within your permissions;
  • where CWS will send you back to after you choose.

Read it before you choose. Only choose Connect if you just started connecting that assistant yourself. Cancel sends you back without connecting anything.

If the page warns that the app runs on your own computer, the app is a program on your computer (for example Claude Code) and CWS sends you back to it there. This is normal when you started the connection from your own computer. If you did not, choose Cancel, because any program on a computer can pretend to be an app.

Disconnecting

Disconnect an assistant at any time:

  1. Open Edit Profile from your user menu.
  2. Choose Connected Apps on the left. It lists the apps that are connected with their name, when they were connected, last used and when they expire.
  3. Click Disconnect on the row and confirm.

The assistant loses access to CWS at once. To use it again, connect it again.

Administrators can do the same for any user: open the user in Admin > Users and choose Connected Apps on the left.

An assistant is also cut off at once if your user is made inactive, you lose the AI Assistant: Connect permission, or AI assistant access is switched off for the account.

Privacy

What an assistant reads from CWS is sent to the company that runs the assistant, such as Anthropic or OpenAI. That includes customers' names, addresses, phone numbers and emails when you ask about work orders. Their privacy terms apply to that data.

  • Ask only for what you need.
  • Do not ask an assistant to list or export customers' details in bulk.
  • Treat what it shows you like any other customer information.
  • Notes and descriptions in CWS are text typed by staff and customers. The assistant treats them as information to report and not as instructions, but check anything surprising before you act on it.

When an assistant cannot answer something because CWS does not offer it yet, it may send the CWS team a short note saying what was asked and what was missing, so it can be added. It is asked to leave out customers' details. Searches that find nothing and requests that fail are noted too, with what was searched for. These notes are kept for a year.

Connections and disconnections are recorded in the CWS event log.

Limits

  • It is read-only for now.
  • Each answer includes at most 25 work orders or customers, and at most 100 rows of other lists. Ask for a narrower list, or ask it to count instead.
  • Requests are limited per person, as the API is. If you ask too much too quickly, wait a moment and try again.
  • An assistant stays connected for 30 days after it was last used. If you do not use it for 30 days it is disconnected, and you connect it again. Each time it is used, the 30 days start again.