Skip to content

MCP server

The Model Context Protocol (MCP) is a standard way for AI applications to read data from other systems. Identiguard has an MCP server, so a user can ask Claude, ChatGPT or another MCP client about their workspace.

MCP access is available on every plan and is read-only.

https://mcp.identiguard.app/mcp

Point any MCP client at this address and sign in when prompted. The same address is shown in the Connect a client box on the AI & MCP access page. See Connect an AI client.

Three switches decide whether an AI client can read a workspace. All three must allow it.

Control Who sets it Where
MCP & AI agent access for the workspace A workspace admin Policies, under the heading AI & MCP access. It needs Save policies. See Workspace settings.
Allow MCP clients to access my account Each user, for their own account Account menu, AI & MCP access. See Your account.
Approval of each client, for chosen workspaces Each user The Authorize access page that opens when a client connects

Other rules:

  • A user can only grant access to workspaces they belong to.
  • A workspace that is paused, or that has MCP & AI agent access off, is not offered on the Authorize access page.
  • A revoked client loses access within a minute.

When a client connects, Identiguard opens the Authorize access page in the browser.

Part of the page What it shows
Title The client’s name, followed by wants access
Introduction “Grant read-only access to the workspaces you choose. You can revoke this at any time under Account > AI & MCP access.”
Unverified application A warning shown for every third-party client. See below.
It will be able to: The list of what the client can read, one line for each scope
For these workspaces: A tick box for each workspace you can grant, with Your role
Deny Refuses the request. Nothing is granted.
Authorize followed by the number of workspaces Grants access. It is disabled until you tick at least one workspace.

For a third-party client, no workspace is ticked in advance. For Ask Alex, the workspace you are in is ticked in advance.

Any MCP client can register itself with Identiguard and choose its own name. For this reason every third-party client shows this warning:

This application registered itself with Identiguard. Innovate IT has not reviewed it, and its name was chosen by whoever registered it. Only continue if you started this connection yourself.

Below it, the page reads Approving sends access to followed by a host name. Check that the host belongs to the application you started. If you did not start the connection yourself, choose Deny.

Open the account menu and choose AI & MCP access. The Authorized applications card lists each application with:

  • a badge, First-party for Ask Alex or Third-party for everything else
  • its scopes
  • the number of workspaces
  • the date it was granted
  • a remove button

The remove button revokes the application at once. There is no confirmation step and no button labelled “Revoke”. If you revoke Ask Alex, you authorise it again the next time you use it.

The page is described in Your account.

Scope Sentence on the Authorize access page
workspace:read View workspace names, membership and tenant overview
events:read Read the security event feed and event statistics
tenants:read Read tenant connection health and provider status
advisories:read Read security advisories and trust feeds
reports:read List generated health report runs
Tool What it returns
whoami The current user, workspaces and scopes
list_workspaces Your workspaces and your role in each
get_workspace_overview A workspace’s tenants and any unhealthy connections
list_events Events from the last 30 days, filtered by tenant, provider, type, severity, actor, target or text
get_event_stats Totals by provider and severity, and ingestion rate
get_event_type_timeseries Hourly or daily counts for each event type in a tenant
get_tenant_status Connection health for each tenant
list_security_advisories Advisories for Okta, Entra ID or Auth0
list_report_runs Recent reports and their status
get_auth0_metrics Daily Auth0 login, sign-up, reset, MFA and attack protection counts, up to 13 months
get_auth0_api_traffic Auth0 API request volume from the metric stream
describe_auth0_event_types The Auth0 event code catalogue and what the tenant subscribes to
  • Nothing is shared with an AI client unless a user approves it.
  • Access is read-only. An AI client cannot change anything in Identiguard.
  • The client’s own policy on AI tools still applies. Identiguard gives them the switch to enforce it.
  • Train users to read the Unverified application warning and the host name before they approve.
What you see Why What to do
MCP access is turned off for your account: “You have disabled MCP client access. Re-enable it under Account > AI & MCP access, then start the connection again.” Your own switch is off. Switch on Allow MCP clients to access my account, then start the connection again from the client.
Invalid authorization request: “This request is missing, expired, or failed verification. No access has been granted. Return to the application and start the connection again.” The link expired, was used before or was changed. Start the connection again from the AI client.
MCP access is unavailable: “This environment is not configured for MCP authorizations. No access has been granted.” A platform configuration problem. Contact support.
You have no workspaces available to grant. Join a workspace first, then start the connection again. You belong to no workspace, or every workspace you belong to is paused or has MCP & AI agent access off. An admin switches the policy on and saves, or fixes billing. Then start again.
Select at least one workspace. No workspace is ticked. Tick one.
One or more selected workspaces cannot be granted. A workspace became paused or switched off, or you left it, while the page was open. Reload the page and choose again.
This authorization request is no longer valid. The request expired while the page was open. Start the connection again from the client.
MCP access is disabled for this account Your own switch is off. Switch on Allow MCP clients to access my account.
What you see Why What to do
The MCP service is unreachable, so access could not be granted. Try again shortly. The MCP service did not answer when you authorised Ask Alex. Try again shortly.
The MCP service is unreachable right now, so existing grants can’t be listed. Your access setting above still applies. The MCP service did not answer. Try again later. Your switch still works.
Could not revoke the grant. Try again shortly. The revoke did not go through. Try again shortly.
A client that worked before now gets no data for a workspace An admin switched off MCP & AI agent access, the workspace is paused, or you left the workspace. Check Policies and billing with an admin.

For other problems, see Troubleshooting.