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.
The address
Section titled “The address”https://mcp.identiguard.app/mcpPoint 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.
How access is controlled
Section titled “How access is controlled”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.
The Authorize access page
Section titled “The Authorize access page”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.
The Unverified application warning
Section titled “The Unverified application warning”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.
See and revoke access
Section titled “See and revoke access”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.
What a client can read
Section titled “What a client can read”| 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 |
What to tell a client
Section titled “What to tell a client”- 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.
Troubleshooting
Section titled “Troubleshooting”Connecting a client
Section titled “Connecting a client”| 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. |
Ask Alex and the account page
Section titled “Ask Alex and the account page”| 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.