Servidor MCP
O Model Context Protocol (MCP) é uma forma normalizada de as aplicações de IA lerem dados de outros sistemas. O Identiguard tem um servidor MCP, pelo que um utilizador pode fazer perguntas ao Claude, ao ChatGPT ou a outro cliente MCP sobre o seu workspace.
O acesso MCP está disponível em todos os planos e é só de leitura.
O endereço
Seção intitulada “O endereço”https://mcp.identiguard.app/mcpAponte qualquer cliente MCP para este endereço e inicie sessão quando for pedido. O mesmo endereço aparece na caixa Connect a client da página AI & MCP access. Consulte Ligar um cliente de IA.
Como o acesso é controlado
Seção intitulada “Como o acesso é controlado”Três interruptores decidem se um cliente de IA pode ler um workspace. Os três têm de o permitir.
| Controlo | Quem o define | Onde |
|---|---|---|
| MCP & AI agent access para o workspace | Um admin do workspace | Policies, sob o título AI & MCP access. É necessário Save policies. Consulte Definições do workspace. |
| Allow MCP clients to access my account | Cada utilizador, para a sua própria conta | Menu da conta, AI & MCP access. Consulte A sua conta. |
| Aprovação de cada cliente, para os workspaces escolhidos | Cada utilizador | A página Authorize access que se abre quando um cliente se liga |
Outras regras:
- Um utilizador só pode conceder acesso a workspaces a que pertence.
- Um workspace que esteja em pausa, ou que tenha MCP & AI agent access desligado, não é apresentado na página Authorize access.
- Um cliente revogado perde o acesso no espaço de um minuto.
A página Authorize access
Seção intitulada “A página Authorize access”Quando um cliente se liga, o Identiguard abre a página Authorize access no browser.
| Parte da página | O que mostra |
|---|---|
| Título | O nome do cliente, seguido de wants access |
| Introdução | “Grant read-only access to the workspaces you choose. You can revoke this at any time under Account > AI & MCP access.” (conceda acesso só de leitura aos workspaces que escolher; pode revogá-lo em qualquer momento em Account > AI & MCP access) |
| Unverified application | Um aviso mostrado para todos os clientes de terceiros. Veja abaixo. |
| It will be able to: | A lista do que o cliente pode ler, uma linha por cada scope |
| For these workspaces: | Uma caixa de seleção para cada workspace que pode conceder, com Your role |
| Deny | Recusa o pedido. Nada é concedido. |
| Authorize seguido do número de workspaces | Concede o acesso. Fica desativado até assinalar pelo menos um workspace. |
Para um cliente de terceiros, nenhum workspace vem assinalado. Para o Ask Alex, o workspace em que está vem já assinalado.
O aviso Unverified application
Seção intitulada “O aviso Unverified application”Qualquer cliente MCP pode registar-se no Identiguard e escolher o seu próprio nome. Por este motivo, todos os clientes de terceiros mostram este aviso:
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.
(Esta aplicação registou-se a si própria no Identiguard. A Innovate IT não a reviu, e o nome foi escolhido por quem a registou. Continue apenas se foi o próprio a iniciar esta ligação.)
Por baixo, a página indica Approving sends access to seguido de um nome de anfitrião. Verifique que o anfitrião pertence à aplicação que iniciou. Se não foi o próprio a iniciar a ligação, escolha Deny.
Ver e revogar o acesso
Seção intitulada “Ver e revogar o acesso”Abra o menu da conta e escolha AI & MCP access. O cartão Authorized applications lista cada aplicação com:
- um distintivo, First-party para o Ask Alex ou Third-party para tudo o resto
- os seus scopes
- o número de workspaces
- a data em que foi concedido
- um botão de remover
O botão de remover revoga a aplicação de imediato. Não há passo de confirmação nem um botão com o texto “Revoke”. Se revogar o Ask Alex, autoriza-o de novo na próxima vez que o utilizar.
A página está descrita em A sua conta.
O que um cliente pode ler
Seção intitulada “O que um cliente pode ler”| Scope | Frase na página Authorize access |
|---|---|
workspace:read |
View workspace names, membership and tenant overview (ver os nomes dos workspaces, os membros e a visão geral dos tenants) |
events:read |
Read the security event feed and event statistics (ler o feed de eventos de segurança e as estatísticas de eventos) |
tenants:read |
Read tenant connection health and provider status (ler o estado da ligação dos tenants e o estado dos fornecedores) |
advisories:read |
Read security advisories and trust feeds (ler os avisos de segurança e os feeds de confiança) |
reports:read |
List generated health report runs (listar as execuções de relatórios de health check geradas) |
Ferramentas
Seção intitulada “Ferramentas”| Ferramenta | O que devolve |
|---|---|
whoami |
O utilizador atual, os workspaces e os scopes |
list_workspaces |
Os seus workspaces e a sua função em cada um |
get_workspace_overview |
Os tenants de um workspace e eventuais ligações com problemas |
list_events |
Eventos dos últimos 30 dias, filtrados por tenant, fornecedor, tipo, severidade, ator, alvo ou texto |
get_event_stats |
Totais por fornecedor e severidade, e ritmo de ingestão |
get_event_type_timeseries |
Contagens por hora ou por dia de cada tipo de evento num tenant |
get_tenant_status |
O estado da ligação de cada tenant |
list_security_advisories |
Avisos de segurança do Okta, do Entra ID ou do Auth0 |
list_report_runs |
Relatórios recentes e o respetivo estado |
get_auth0_metrics |
Contagens diárias do Auth0 de inícios de sessão, registos, reposições, MFA e proteção contra ataques, até 13 meses |
get_auth0_api_traffic |
Volume de pedidos à API do Auth0, a partir do fluxo de métricas |
describe_auth0_event_types |
O catálogo de códigos de eventos do Auth0 e o que o tenant subscreve |
O que dizer a um cliente
Seção intitulada “O que dizer a um cliente”- Nada é partilhado com um cliente de IA sem a aprovação de um utilizador.
- O acesso é só de leitura. Um cliente de IA não pode alterar nada no Identiguard.
- A política do próprio cliente sobre ferramentas de IA continua a aplicar-se. O Identiguard dá-lhe o interruptor para a fazer cumprir.
- Forme os utilizadores para lerem o aviso Unverified application e o nome do anfitrião antes de aprovarem.
Resolução de problemas
Seção intitulada “Resolução de problemas”Ligar um cliente
Seção intitulada “Ligar um cliente”| O que vê | Porquê | O que fazer |
|---|---|---|
| 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.” (o acesso MCP está desligado para a sua conta; volte a ativá-lo em Account > AI & MCP access e inicie de novo a ligação) | O seu próprio interruptor está desligado. | Ligue Allow MCP clients to access my account e inicie de novo a ligação a partir do cliente. |
| 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.” (o pedido de autorização é inválido: está em falta, expirou ou falhou a verificação; não foi concedido acesso; volte à aplicação e inicie de novo a ligação) | A ligação expirou, já foi utilizada ou foi alterada. | Inicie de novo a ligação a partir do cliente de IA. |
| MCP access is unavailable: “This environment is not configured for MCP authorizations. No access has been granted.” (o acesso MCP não está disponível: este ambiente não está configurado para autorizações MCP; não foi concedido acesso) | Um problema de configuração da plataforma. | Contacte o suporte. |
| You have no workspaces available to grant. Join a workspace first, then start the connection again. (não tem workspaces disponíveis para conceder; adira primeiro a um workspace e inicie de novo a ligação) | Não pertence a nenhum workspace, ou todos os workspaces a que pertence estão em pausa ou têm MCP & AI agent access desligado. | Um admin liga a política e guarda, ou resolve a faturação. Depois comece de novo. |
| Select at least one workspace. (selecione pelo menos um workspace) | Nenhum workspace está assinalado. | Assinale um. |
| One or more selected workspaces cannot be granted. (não é possível conceder um ou mais dos workspaces selecionados) | Um workspace ficou em pausa ou foi desligado, ou saiu dele, enquanto a página estava aberta. | Recarregue a página e escolha de novo. |
| This authorization request is no longer valid. (este pedido de autorização já não é válido) | O pedido expirou enquanto a página estava aberta. | Inicie de novo a ligação a partir do cliente. |
| MCP access is disabled for this account (o acesso MCP está desativado para esta conta) | O seu próprio interruptor está desligado. | Ligue Allow MCP clients to access my account. |
Ask Alex e a página da conta
Seção intitulada “Ask Alex e a página da conta”| O que vê | Porquê | O que fazer |
|---|---|---|
| The MCP service is unreachable, so access could not be granted. Try again shortly. (o serviço MCP está inacessível, por isso não foi possível conceder o acesso; tente de novo dentro de momentos) | O serviço MCP não respondeu quando autorizou o Ask Alex. | Tente de novo dentro de momentos. |
| The MCP service is unreachable right now, so existing grants can’t be listed. Your access setting above still applies. (o serviço MCP está inacessível neste momento, por isso não é possível listar as concessões existentes; a sua definição de acesso acima continua a aplicar-se) | O serviço MCP não respondeu. | Tente mais tarde. O seu interruptor continua a funcionar. |
| Could not revoke the grant. Try again shortly. (não foi possível revogar a concessão; tente de novo dentro de momentos) | A revogação não foi concluída. | Tente de novo dentro de momentos. |
| Um cliente que antes funcionava deixou de obter dados de um workspace | Um admin desligou MCP & AI agent access, o workspace está em pausa, ou saiu do workspace. | Verifique Policies e a faturação com um admin. |
Para outros problemas, consulte Resolução de problemas.