Pular para o conteúdo

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.

https://mcp.identiguard.app/mcp

Aponte 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.

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.

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.

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.

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.

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)
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
  • 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.
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.
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.