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.enforceMódulo 04
Módulo da plataforma
MCP gateway enforcement
Ponha uma frente em um servidor MCP para que cada chamada de ferramenta seja admitida como qualquer outra intenção, e uma chamada recusada nunca chegue ao servidor.
mcp.enforce pergunta ao Intralock se um agente pode chamar uma ferramenta MCP e devolve um veredito, sem modelo no caminho. O mesmo gateway também pode encaminhar uma chamada a um upstream registrado conforme o modo do workspace: observe registra, advise informa, enforce recusa.
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.
mcp/enforce devolve permitir ou recusar e não encaminha nada. Para que o gateway admita, remova, encaminhe e filtre uma chamada, registre um upstream com upstream-add e envie a chamada a mcp/call.
Registro
O registro
O que é registrado
actorDid
Obrigatório. O agente que faz a chamada. Um agente autenticado só pode nomear a si mesmo.
tool
Obrigatório. O nome da ferramenta MCP. É também o recurso admitido, a menos que resource seja enviado.
Opcional. Uma ferramenta cujo nome parece uma mutação, como fs.write, é admitida como write seja o que você enviar. Só delete é mantido.
confirmationToken
Opcional. O token que um aprovador emitiu para uma escrita ou exclusão que exige confirmação.
allow
Na resposta: se o Intralock admitiu a intenção.
reason
Na resposta: por quê, como quarantine ou uma concessão ausente.
llm
Na resposta: false. O veredito vem de uma função pura.
protocolVersion
A versão do protocolo MCP que o gateway fala.
Mecanismo
Passo a passo
Como funciona
Formas e fases
A
observe
O padrão. call encaminha sem checagem de admissão e anota a chamada como observed. O shadow log do workspace se enche com o que os agentes teriam feito.
B
advise
call admite a intenção e informa o que a plataforma teria dito, como would be refused, mas encaminha mesmo assim. As transformações declaradas ainda se aplicam.
C
enforce
call admite a intenção e só encaminha se permitida. Uma chamada recusada devolve forwarded: false e nunca sai do gateway.
Passo a passo
Defina o modo
mode recebe observe, advise ou enforce e o armazena para o workspace. Comece em observe e leia shadow antes de mudar.
Registre um upstream
upstream-add nomeia um servidor MCP por URL, com uma credencial de conexão opcional ou um pacote de mapeamento que classifica suas ferramentas.
Envie uma chamada
call recebe , , e . O gateway deriva a ação e o recurso, admite a intenção e encaminha se permitida.
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.enforce
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.
Uma ferramenta chamada bash ou fs.write é admitida como escrita, então precisa de uma concessão e, sob o piso de confirmação, de uma aprovação humana antes de rodar.
Testar antes de aplicar
Rode em observe por uma semana. shadow lista as últimas 50 chamadas que a plataforma viu, para você ver quais teriam sido recusadas.
Desarmar respostas
call filtra a resposta do upstream, desarma texto em forma de instrução e define instructionShaped em provenance, para que o resultado de uma ferramenta não se passe por instrução.
Descartar argumentos arriscados
Em advise e enforce, call remove command e shell dos argumentos e lista os nomes removidos em stripped.
Quando usar outra coisa
Uma única checagem de admissão sem o enquadramento MCP. Use coordination.admit; o gateway a chama por você.
Coletar uma decisão humana para uma escrita. Os aprovadores usam coordination.approve; o gateway apenas devolve o approvalId.
Controlar repositórios do GitHub. Use github.enforce, que admite recursos repo: e publica o resultado de volta no GitHub.
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
enforce executa a admissão do Intralock seja qual for o modo armazenado, então o veredito é a mesma resposta de função pura de coordination.admit.
No modo enforce uma call recusada não é encaminhada: a resposta diz forwarded: false e nenhuma requisição vai ao upstream.
Toda requisição enforce e observe acrescenta um evento mcp.shadow, e toda chamada um evento mcp.call, ao ledger.
Um nome de ferramenta em forma de mutação não pode ser rebaixado a read ou call pela requisição.
Não faz
Que um cliente não possa contornar o gateway. Ele admite apenas chamadas enviadas a ele; um agente que tem o endereço do servidor pode chamá-lo diretamente.
Que uma resposta filtrada seja segura. Desarmar e a marca instructionShaped são heurísticas sobre texto, não uma garantia.
Que um endereço de upstream seja seguro. A checagem lê o texto da URL e não vê como um hostname resolve.
Que o mode da resposta seja o modo usado. Em enforce ela informa o modo armazenado, que pode ser observe, embora o veredito seja sempre do Intralock.
Detalhes
Notas de construção
Antes de construir
Formato do veredito
enforce devolve a linha shadow com shadow: false, mais allow, reason, a action admitida, llm: false e protocolVersion.
Aprovações
Uma write sem token volta de call com allow: false e um approvalId. A rota enforce devolve apenas allow e reason.
Pacotes de mapeamento
Um upstream pode levar um pacote de mapeamento que nomeia a ação e o recurso de cada ferramenta. Uma ferramenta mapeada é admitida contra seu recurso em vez do padrão.
Permissões
mode, upstream-add e upstream-remove exigem policies.approve. enforce, call e shadow não têm permissão própria, então o veredito de admissão é o controle.
Limites e medição
call encerra por tempo um upstream em 8000 ms e recusa uma resposta maior que 1 MiB.
No máximo 50 upstreams são registrados, o histórico de chamadas guarda 200 linhas e shadow devolve os últimos 50 eventos.
Um pacote de mapeamento tem no máximo 200 ferramentas. As entradas extras são descartadas.
enforce sem actorDid ou tool devolve 400, e call sem upstream também.
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
POST/api/v1/acp/mcp/enforceAdmita uma chamada de ferramenta e devolva o veredito; não encaminha nada.
POST/api/v1/acp/mcp/callAdmita, remova, encaminhe e filtre uma chamada por um upstream.
POST/api/v1/acp/mcp/modeDefina o modo de gateway do workspace.
GET/api/v1/acp/mcp/shadowListe os últimos 50 eventos observados.
POST/api/v1/acp/mcp/upstream-addRegistre um servidor MCP upstream.
Ações MCP
MCPcoordination.mcp.enforcePeça um veredito a partir de um agente.
MCPcoordination.mcp.modeDefina o modo a partir de um agente.
MCPcoordination.mcp.shadowLeia o shadow log a partir de um agente.
Módulo da plataforma
