AgentZ: Getting Started & Best Practices
AgentZ lets you ask an AI app, such as the Claude desktop app, Claude Code or Codex, to do work in your organisation’s iMIS site, with everything it does shown in the AgentZ app on your computer. This guide takes you through setting AgentZ up, in the order that works, and says who does each part. Each step links to the article with the full instructions.
Who does what
Section titled “Who does what”Three people may be involved. In a small organisation they are often the same person.
| Who | What they do | How often |
|---|---|---|
| Your Organisation admin: the person who manages AgentZ for your organisation | Activates AgentZ with the auth code iFINITY sent, sets up the iMIS API connection for your iMIS site, and looks after who holds a seat | Once, and when people join or leave |
| A system administrator in iMIS | Is signed in to iMIS while the iMIS API connection is set up, because AgentZ creates a Client Application in iMIS. Often this is the Organisation admin | Once for each iMIS site |
| Each person who uses AgentZ | Installs the AgentZ app, signs in with their work email, saves their own iMIS sign-in, and adds AgentZ to their AI app | Once on each computer |
Setting up AgentZ, in order
Section titled “Setting up AgentZ, in order”1. Your Organisation admin sets up the organisation
Section titled “1. Your Organisation admin sets up the organisation”Do this first, so that everyone else can set up without waiting.
- Install the AgentZ app. See Installing AgentZ.
- Activate AgentZ with your organisation’s auth code, then sign in with your work email. See Signing in to AgentZ.
- Connect your iMIS site with your own iMIS staff sign-in. See Connecting your iMIS site.
- Set up the iMIS API connection, signed in to iMIS as a system administrator. See Setting up the iMIS API connection.
- Connect your AI app and make a first request, to prove everything works before others start. See Connecting your AI app and Making your first request.
2. Each person sets up their own computer
Section titled “2. Each person sets up their own computer”Once the organisation is active and the iMIS API connection is set up, each person does the following on their own computer:
- Install the AgentZ app. See Installing AgentZ.
- Sign in with their work email. See Signing in to AgentZ.
- Connect your iMIS site with their own iMIS staff sign-in. See Connecting your iMIS site.
- Connect their AI app. See Connecting your AI app.
- Check the setup, then make a first request. See Checking your setup and Making your first request.
The Overview tab of Settings in the AgentZ app shows each of these parts and the one thing left to do, so nobody needs to remember the order.
Best practices
Section titled “Best practices”- Activate and set up the iMIS API connection before inviting your team. Until the organisation is activated, nobody can sign in. Until the iMIS API connection is set up, each person’s Overview shows Waiting for your administrator for the iMIS API.
- Give each person their own iMIS staff sign-in. AgentZ works in iMIS as the person whose sign-in is saved, with that person’s iMIS permissions. A shared iMIS sign-in makes it impossible to tell who did what. See Security and trust.
- Check iMIS permissions before rolling out. Someone who cannot do something in iMIS cannot do it through AgentZ either. Make sure each person’s iMIS security roles cover the work they will ask for.
- Start with requests that only read. Asking AgentZ to find records or summarise information changes nothing in iMIS, and builds confidence before anyone asks for changes.
- Read every preview before you approve it. Before AgentZ changes anything in iMIS, it shows what will change and waits for you. See Activity and approvals.
- Keep the AgentZ app open while you work. Your AI app works in iMIS through the AgentZ app, so it must be running.
- Leave automatic updates on. The AgentZ app updates itself, and keeps the AgentZ plugin up to date in most AI apps. In the Claude desktop app, turn on Sync automatically for the iFINITY marketplace. See Updating AgentZ.
- Use the recipes. They are ready-made requests for common iMIS jobs, grouped by area of work. See Recipes.
If something does not work
Section titled “If something does not work”Start with Settings > Overview in the AgentZ app: it names what is not done and the button that fixes it. See Checking your setup, and Troubleshooting for each problem by what you see.
Does every person need the auth code? No. Only your Organisation admin uses it, once, to activate your organisation. Everyone else signs in with their work email.
Does every person set up the iMIS API connection? No. It is set up once for each iMIS site, by an Organisation admin who is a system administrator in iMIS.
Can two people share one computer? Each person signs in to AgentZ with their own work email, and AgentZ works as the iMIS sign-in saved on that computer. Give each person their own computer account, so that each has their own AgentZ sign-in and iMIS sign-in.
What happens when someone leaves? Your Organisation admin removes them on the Team tab, which frees their seat. See Removing a team member.

