Connect an AI client
This guide connects an AI application to Identiguard through the MCP server. Access is read-only and you choose which workspaces it can see.
You need
Section titled “You need”- Any role in the workspace: admin, member or viewer.
- Any plan.
- MCP & AI agent access switched on for the workspace. An admin sets this under Policies.
- A workspace that is not paused.
1. Check access is allowed
Section titled “1. Check access is allowed”- Open the account menu and choose AI & MCP access.
- In the MCP client access card, make sure Allow MCP clients to access my account is on. The status line reads “Enabled - approved clients can read your granted workspaces.”
- Ask a workspace admin to confirm that MCP & AI agent access is on under Policies, and that Save policies was chosen after any change.
2. Add the server to the client
Section titled “2. Add the server to the client”In your AI application, add a custom MCP server or connector with this address:
https://mcp.identiguard.app/mcpThe same address is in the Connect a client box on the AI & MCP access page.
Where to add it depends on the application. Look for Connectors, Integrations or MCP servers in its settings.
3. Sign in and approve
Section titled “3. Sign in and approve”- The application opens Identiguard in your browser. Sign in.
- On Authorize access, check the client name in the title.
- If Unverified application is shown, read it. Check that the host after Approving sends access to belongs to the application you started.
- Read the list under It will be able to:.
- Under For these workspaces:, tick only the workspaces the application needs. Nothing is ticked in advance.
- Choose Authorize followed by the number of workspaces, for example Authorize 1 workspace. To refuse, choose Deny.
When it worked, the browser returns you to the AI application, and the application appears under Authorized applications on the AI & MCP access page with the badge Third-party.
4. Ask something
Section titled “4. Ask something”Try:
- “Which of my Identiguard workspaces have unhealthy tenants?”
- “Summarise the critical events in the last 24 hours for this workspace.”
- “Are there any current Okta security advisories?”
- “How did Auth0 login success change over the last month?”
5. Remove access
Section titled “5. Remove access”- Open the account menu and choose AI & MCP access.
- In Authorized applications, find the application.
- Choose the remove button on its row.
There is no confirmation step. The application loses access within a minute.
To block every application at once, switch off Allow MCP clients to access my account. This also blocks Ask Alex.
In a demo
Section titled “In a demo”Use a demo workspace only. Ask a question whose answer you have already checked on the dashboard, so the client sees the two agree.
If it does not work
Section titled “If it does not work”| What you see | What to do |
|---|---|
| MCP access is turned off for your account | Switch on Allow MCP clients to access my account, then start the connection again from the client. |
| Invalid authorization request | The request expired or was used before. Start the connection again from the client. |
| You have no workspaces available to grant. Join a workspace first, then start the connection again. | Every workspace you belong to is paused or has MCP & AI agent access off. Ask an admin. |
| Select at least one workspace. | Tick a workspace. |
| One or more selected workspaces cannot be granted. | Reload the page and choose again. |
| This authorization request is no longer valid. | Start the connection again from the client. |
| Could not revoke the grant. Try again shortly. | Try again shortly. |
Every message is explained in MCP server.