O Intramedial está em beta restrito. Ao se cadastrar ou entrar, você precisa informar a senha de beta tester que recebeu ou solicitar uma em preview@intramedial.com. Obrigado.
Carregando…
mcp.shadowMódulo 13
Módulo da plataforma
Shadow agent discovery
Liste as chamadas de ferramenta que o gateway MCP viu, com o agente por trás de cada uma, para que chamadores que ninguém registrou apareçam ao lado dos que estão registrados.
mcp.shadow devolve os últimos eventos que o gateway MCP registrou: quem chamou, qual ferramenta e em qual modo. Toda chamada observe e enforce grava um no ledger como mcp.shadow, o chamador estando registrado ou não. Comparar os chamadores com a lista de identidades mostra os que ninguém registrou.
Intralock · Leases · Parley · Fleet Map
Um produto da Trustvice
Os agentes agem quando o plano diz sim, e o registo diz porquê.
Passe ações de agentes, hashes de conteúdo, checagens de API, DNS, webhooks, chamadas de LLM e commits git pela Intramedial. Receba um recibo assinado que todos verificam – sem confiar em nós.
StatusChamadores desconhecidos são calculados na leitura
A rota lista eventos do gateway. Não marca um chamador como desconhecido nem armazena uma decisão de autorização. O console compara os chamadores com o registro, e registrar um DID é a única decisão guardada.
Registro
O registro
O que é registrado
events
Os últimos 50 eventos mcp.shadow, na ordem em que foram lidos.
at
Quando o gateway registrou a chamada.
event.actorDid
O DID que a chamada nomeou, ou uma string vazia quando nenhum foi nomeado.
O nome da ferramenta, ou o recurso quando nenhuma ferramenta foi informada.
event.mode
O modo do gateway quando a chamada foi registrada: observe, advise ou enforce.
event.resource
O recurso que a chamada nomeou, quando nomeou um.
kind
Sempre registry.shadow.
protocolVersion
A versão do protocolo MCP que o gateway fala.
Mecanismo
Passo a passo
Como funciona
O gateway registra cada chamada
Uma chamada observe ou enforce no gateway MCP acrescenta um evento mcp.shadow com actorDid, tool, mode e, quando informado, resource.
Os eventos são lidos de volta
GET /api/v1/acp/mcp/shadow junta à lista os eventos de ledger mcp.shadow do workspace e devolve os últimos 50, cada um com seu horário.
Os chamadores encontram o registro
O console Shadow também lê identity/list. Um DID visto no gateway e ausente do registro aparece como desconhecido, com sua contagem de chamadas, última vez visto e ferramentas.
Uma pessoa decide
Registrar o DID com shadow: true o acompanha, e registrá-lo sem isso o autoriza. Nenhuma ação bloqueia um chamador daqui; um deixado como está continua listado.
Experimente
Demo ao vivo
Execute a partir desta página
GET/api/v1/acp/mcp/shadow
// Sem corpo: isto é um GET. Clique em Executar.
Executa em um workspace de demonstração compartilhado com uma chave de demonstração: qualquer pessoa pode ver o que ele contém, então não envie nada privado. Docs de mcp.shadow
Respostas
Clique em Executar para enviar a requisição à esquerda ao workspace de demonstração compartilhado.
Executa em um workspace de demonstração compartilhado com uma chave de demonstração: qualquer pessoa pode ver o que ele contém, então não envie nada privado.
Código
Exemplo ao vivo
Uma requisição real
Uma requisição no formato que a API aceita e um exemplo de resposta no formato que o módulo devolve.
Um engenheiro liga um script ao gateway. Seu DID aparece na lista sem entrada no registro, antes de alguém precisar perguntar quem é.
Dimensionar um rollout
Em observe o gateway só registra. Uma semana de eventos mostra quais agentes e ferramentas enforce encontraria antes de ser ligado.
Revisar um teste
Os agentes registrados com shadow: true continuam marcados, então uma equipe pode revisar o que acompanhou e autorizar os que mantém.
Conferir uma ferramenta suspeita
Filtre os eventos por tool para ver todos os chamadores que a alcançaram e em qual modo.
Quando usar outra coisa
Barrar um chamador desconhecido. A lista só relata; ponha o gateway em enforce com mcp.enforce ou pare um DID nomeado com coordination.quarantine.
Encontrar agentes que nunca usam o gateway MCP. Chamadores de GitHub e SaaS não gravam esses eventos; use seus próprios pontos de aplicação.
Ler toda chamada de ferramenta. As chamadas feitas por um upstream registrado estão no ledger como mcp.call; esta lista guarda apenas eventos shadow.
Evidência
Garantias
O que faz e o que não faz
Um módulo é uma afirmação forte sobre algo estreito. Confie nele exatamente pelo que ele é.
Faz
Cada chamada observe ou enforce no gateway MCP deixa um evento mcp.shadow, com o DID que nomeou.
Nenhuma requisição a ledger/append pode gravar um evento mcp.shadow; a plataforma grava esse tipo ela mesma.
Cada leitura junta à lista os eventos de ledger mcp.shadow do workspace, então eventos gravados por outra instância de Worker também aparecem.
Não faz
Que um agente não listado nunca chamou. Só chamadas observe e enforce por este gateway são registradas, e a lista para nos últimos 50.
Quem responde por um DID. A lista registra o DID que uma chamada levou e não o liga a nenhum dono.
Que uma chamada foi bloqueada ou nociva. Um evento registra que uma chamada chegou; o allow ou deny volta a quem chamou e não é armazenado aqui.
Detalhes
Notas de construção
Antes de construir
Registrado ou não
Um evento não diz se seu chamador está registrado. Essa comparação é feita na leitura, contra a lista de identidades.
Modo do gateway
O modo assume observe, em que o gateway registra e deixa a chamada passar. advise acrescenta o conselho de um classificador, e só enforce pode recusar.
Acompanhado não é autorizado
Registrar um DID com shadow: true define um sinalizador em seu registro. Não concede nem nega nada; a admissão ainda exige uma concessão.
Limites e medição
A rota devolve no máximo os últimos 50 eventos e não aceita filtro nem cursor.
Os eventos não trazem contagens. Primeira e última vez visto e totais de chamadas são calculados pelo console a partir dos eventos que recebe.
Ler a lista não é medido.
Só o gateway MCP grava esses eventos. Outros pontos de aplicação guardam seus próprios registros.
Acesso
API e MCP
REST e MCP
Autentique-se com uma chave de API do workspace como token Bearer. A URL base é https://api.intramedial.com.
Endpoints REST
GET/api/v1/acp/mcp/shadowListe os últimos eventos do gateway MCP registrados como chamadas shadow.
Ações MCP
MCPcoordination.mcp.shadowListe os mesmos eventos como ação MCP.
Módulo da plataforma
