Back

Connect an AI assistant to the Primo MCP server

The Primo MCP server lets AI assistants such as ChatGPT, Claude or Cursor work with your Factorial IT data. Use it when you want to ask about or manage your devices, employees and tickets in plain language from the assistant you already use.


 

Feature/Functionality

Overview

MCP (Model Context Protocol) is an open standard. It lets an AI assistant plug straight into outside tools and data, Factorial IT included.

Once connected, your assistant can read and act on your IT estate when you ask it to: list devices, find employees, manage accessories, open tickets and more.

What you need:

  • A Factorial IT account with access to your company's workspace.
  • An AI assistant that supports MCP, such as ChatGPT, Claude or Cursor.

Sign-in uses OAuth. When you add the server, the assistant sends you to sign in with your Factorial IT account. No API key is needed.

 

Server URL

The server lives at:

https://api.getprimo.com/mcp

Out of the box the connection is read-only: the assistant can look at data but cannot change it.

For write access (opening tickets, updating accessories and so on), use this URL instead:

https://api.getprimo.com/mcp?readOnly=false

 

How to use: ChatGPT

  1. Open ChatGPT. Your plan must support custom MCP connectors.
  2. Go to Settings → Connected Apps, or use the "Connect" menu.
  3. Select Add MCP Server.
  4. Enter https://api.getprimo.com/mcp.
  5. Sign in with your Factorial IT account when the OAuth page opens.
  6. Authorise the connection.

Prompts to try:

  • "List all devices managed in Factorial IT"
  • "Show me employees who joined this month"
  • "What tickets are currently pending?"

 

How to use: Claude Desktop

  1. Open the Claude Desktop app.
  2. Go to Settings → Developer → MCP Servers.
  3. Click Add Server.
  4. Give it a name (for example "Factorial IT") and enter https://api.getprimo.com/mcp.
  5. Complete the OAuth sign-in with your Factorial IT account.
  6. Save and reconnect. The Factorial IT tools now appear in Claude's toolbox.

 

How to use: Cursor

  1. Open the Cursor settings.
  2. Go to MCP Servers.
  3. Add a server with the URL https://api.getprimo.com/mcp.
  4. Complete the OAuth sign-in with your Factorial IT account. Cursor's assistant can then use the Factorial IT tools.

 

How to use: other assistants

Any app that follows the MCP standard can connect. Point it at https://api.getprimo.com/mcp and sign in with your Factorial IT account through OAuth.

 

Several companies on one account

If your account can reach more than one tenant, the server uses the company chosen in Default MCP company. You find it on the Companies tab of My account, which only appears when you belong to two or more companies.

When no default is set, add the x-company-id parameter to the URL:

https://api.getprimo.com/mcp?x-company-id=YOUR_COMPANY_ID

Parameters can be combined:

https://api.getprimo.com/mcp?x-company-id=YOUR_COMPANY_ID&readOnly=false

To get your tenant ID, list your companies through the API or look at the URL in the console.

 

What the assistant can do

The assistant only sees the tools your role allows. It is limited to read operations until you connect with readOnly=false.

Category Read operations Write operations
Accessories List and view accessories and their custom fields Create, update, assign and archive accessories; set custom field values
Admins List the company admins Email the company admins
AI Agents List agents and their runs; read a run's report and transcript Create a custom agent; replace an agent's instructions
AI Dashboards View a dashboard and its instructions Recompose a dashboard; replace its instructions
AI Tools View the AI tools found on devices, the risk findings and the AI tools settings Approve or block AI tools; update the settings
AI Usage View the company's AI credit usage —
Billing Profiles List billing profiles —
Catalogue Search the catalogue and view products, favourites, shipping countries and company addresses; view the equipment and purchasing policies Pin and unpin favourites; update and publish the equipment and purchasing policies
Company View the company and its metrics report —
Compliance List and search compliance alerts with their remediation context; view alert rules, settings and the remediation policy Create and update alert rules; update the settings; update, publish and unpublish the remediation policy
Custom Fields List and view custom fields Create, update and archive custom fields
Device Groups List and view device groups and what uses them; check a target before creating a group Create, update and delete device groups
Devices Search, count and view devices with their activities, MDM commands, local accounts and custom fields; export devices and inventory as CSV Create, update and delete devices; lock, unlock, wipe (⚠️), reboot, retire and disenrol; move to stock or in use; run a script; resend a profile; set tags and custom field values
Employees List, search and view employees and their custom fields Create, update, hide and unhide employees; send an enrolment request; set custom field values
Knowledge Base List and view knowledge base items Create, update, publish, unpublish and delete items
MDM Controls List, view and browse the type catalogue; list the controls that apply to a device Create, update, delete and update tags
Offboardings List and view offboardings —
Onboardings List and view onboardings and the onboarding settings Create, complete and ignore onboardings; run the employee, email account, equipment and SaaS steps; update the settings
Orders List and view orders and their custom fields Create orders and equipment orders; set custom field values
SaaS List and view SaaS, their issues and each employee's identities; preview what the rules grant Provision, deprovision, create, link, archive and delete identities; reset a password; manage groups, roles, licences and organisation units; update contracts, owners, approval status and rules
Scripts List saved scripts and their runs, with the result on each device Run a script on a target
Shipments List and view shipments Create a shipment
Software View the software catalogue, the software on a device, install status and logs, and CVE vulnerabilities Install, uninstall, update and delete software; update install scripts; sync the catalogue or a device
Tasks List tasks Create and schedule tasks; update their status and assignee
Tickets List, count and view tickets with their subscribers; list ticket tags Create and delete tickets; add comments; update status, priority, assignee and AI agent; manage subscribers, linked objects and ticket tags

Be careful with write mode. Some actions cannot be reversed: wiping a device, permanently deleting a SaaS identity with its history, or deleting a ticket along with its tasks. If you want to keep a ticket's history, ask the assistant to close it rather than delete it.


 

Tips and Best Practices

  • Start read-only. Add readOnly=false only when you actually need the assistant to change things.
  • Close tickets instead of deleting them. Deleting removes the ticket and its tasks for good.
  • Double-check before a wipe. The assistant can wipe devices in write mode, and a wipe cannot be undone.
  • Set a default company if you manage several. It saves adding x-company-id to every URL and avoids answers from the wrong tenant.
  • Give the right role. The assistant only gets the tools your role allows, so access is limited by the same rules as the console.

 

Troubleshooting and FAQ

Troubleshooting

  • The URL shows "404 Not Found" in a browser. That is expected. The server is not a web page; it is an endpoint for AI assistants. Add it as an MCP server in your assistant instead.
  • Authentication fails. Finish the OAuth sign-in when the assistant asks for it. Your Factorial IT account must be active and have access to the company you want to query.
  • The assistant shows data from the wrong company. Set Default MCP company on the Companies tab of My account, or add the x-company-id parameter to the URL.
  • The assistant cannot change anything. The connection is read-only by default. Reconnect with readOnly=false.

 

FAQ

  1. Do I need an API key?
    No. You sign in with your Factorial IT account through OAuth.
     
  2. Can the assistant make changes straight away?
    No. It starts in read-only mode. Write access needs the readOnly=false URL.
     
  3. Will the assistant see everything in the console?
    No. It only sees the tools your role allows.
     
  4. Where do I find my tenant ID?
    List your companies through the API, or check the URL in the console.
     
  5. Who do I contact for help with the setup?
    Contact Factorial IT support or use the in-app chat. The API documentation is at api.getprimo.com/apidoc.

Was this article helpful?

Give feedback about this article

Can’t find what you’re looking for?

Our customer care team is here for you.

Contact us

Knowledge Base Software powered by Helpjuice