Intramedial está en beta restringida. Al registrarte o iniciar sesión, debes indicar la contraseña de beta tester que recibiste o solicitar una en preview@intramedial.com. Gracias.
Cargando…
mcp.enforceMódulo 04
Módulo de la plataforma
MCP gateway enforcement
Pon un frontal a un servidor MCP para que cada llamada a una herramienta se admita como cualquier otra intención, y una llamada rechazada nunca llegue al servidor.
mcp.enforce pregunta a Intralock si un agente puede llamar a una herramienta MCP y devuelve un veredicto, sin ningún modelo en el camino. La misma pasarela también puede reenviar una llamada a un upstream registrado según el modo del workspace: observe registra, advise informa, enforce rechaza.
Intralock · Leases · Parley · Fleet Map
Un producto Trustvice
Los agentes actúan cuando el plano dice sí, y el registro dice por qué.
Pasa por Intramedial acciones de agentes, hashes de contenido, pruebas de API, DNS, webhooks, llamadas LLM y commits. Obtén un recibo firmado que cualquiera verifica, sin fiarse de nadie.
mcp/enforce devuelve allow o rechazo y no reenvía nada. Para que la pasarela admita, depure, reenvíe y filtre una llamada, registra un upstream con upstream-add y envía la llamada a mcp/call.
Registro
El registro
Qué se registra
actorDid
Obligatorio. El agente que hace la llamada. Un agente autenticado solo puede nombrarse a sí mismo.
tool
Obligatorio. El nombre de la herramienta MCP. También es el recurso admitido salvo que se envíe resource.
Opcional. Una herramienta cuyo nombre parece una mutación, como fs.write, se admite como write sea lo que sea que envíes. Solo se conserva delete.
confirmationToken
Opcional. El token que emitió un aprobador para una escritura o borrado que necesita confirmación.
allow
En la respuesta: si Intralock admitió la intención.
reason
En la respuesta: por qué, como quarantine o un grant ausente.
llm
En la respuesta: false. El veredicto sale de una función pura.
protocolVersion
La versión del protocolo MCP que habla la pasarela.
Mecanismo
Paso a paso
Cómo funciona
Formas y fases
A
observe
El valor por defecto. call reenvía sin comprobación de admisión y anota la llamada como observed. El registro shadow del workspace se llena con lo que los agentes habrían hecho.
B
advise
call admite la intención e informa de lo que habría dicho el plano, como would be refused, pero reenvía igualmente. Las transformaciones declaradas siguen aplicándose.
C
enforce
call admite la intención y reenvía solo si se permite. Una llamada rechazada devuelve forwarded: false y nunca sale de la pasarela.
Paso a paso
Fijar el modo
mode toma observe, advise o enforce y lo guarda para el workspace. Empieza en observe y lee shadow antes de cambiar.
Registrar un upstream
upstream-add nombra un servidor MCP por URL, con una credencial de conexión opcional o un pack de mapeo que clasifica sus herramientas.
Enviar una llamada
call toma , , y . La pasarela deduce la acción y el recurso, admite la intención y reenvía si se permite.
Se ejecuta en un workspace de demostración compartido con una clave de demostración: cualquiera puede ver lo que contiene, así que no envíes nada privado. Docs de mcp.enforce
Respuestas
Pulsa Ejecutar para enviar la solicitud de la izquierda al workspace de demostración compartido.
Se ejecuta en un workspace de demostración compartido con una clave de demostración: cualquiera puede ver lo que contiene, así que no envíes nada privado.
Código
Ejemplo en vivo
Una petición real
Una petición con la forma que acepta la API y una respuesta de ejemplo con la forma que devuelve el módulo.
Una herramienta llamada bash o fs.write se admite como escritura, así que necesita un grant y, con el mínimo de confirmación, una aprobación humana antes de ejecutarse.
Probar antes de aplicar
Ejecuta en observe durante una semana. shadow lista las últimas 50 llamadas que vio el plano, para que veas cuáles se habrían rechazado.
Desactivar respuestas
call filtra la respuesta del upstream, neutraliza el texto con forma de instrucción y fija instructionShaped en provenance, para que el resultado de una herramienta no pueda hacerse pasar por una instrucción.
Eliminar argumentos de riesgo
En advise y enforce, call quita command y shell de los argumentos y lista los nombres eliminados en stripped.
Cuándo usar otra cosa
Una comprobación de admisión suelta sin el marco MCP. Usa coordination.admit; la pasarela lo llama por ti.
Recoger la decisión humana para una escritura. Los aprobadores usan coordination.approve; la pasarela solo devuelve el approvalId.
Controlar repositorios de GitHub. Usa github.enforce, que admite recursos repo: y devuelve el resultado a GitHub.
Evidencia
Garantías
Qué hace y qué no hace
Un módulo es una afirmación fuerte sobre algo acotado. Confía en él exactamente para lo que es.
Hace
enforce ejecuta la admisión de Intralock sea cual sea el modo guardado, así que el veredicto es la misma respuesta de función pura que coordination.admit.
En modo enforce una call rechazada no se reenvía: la respuesta dice forwarded: false y ninguna petición va al upstream.
Cada petición enforce y observe añade un evento mcp.shadow, y cada llamada un evento mcp.call, al ledger.
Un nombre de herramienta con forma de mutación no puede rebajarse a read o call por la petición.
No hace
Que un cliente no pueda saltarse la pasarela. Solo admite las llamadas que se le envían; un agente que tenga la dirección del servidor puede llamarlo directamente.
Que una respuesta filtrada sea segura. La neutralización y el indicador instructionShaped son heurísticas sobre texto, no una garantía.
Que la dirección de un upstream sea segura. La comprobación lee el texto de la URL y no puede ver cómo se resuelve un nombre de host.
Que el mode de la respuesta sea el modo usado. En enforce informa del modo guardado, que puede ser observe, aunque el veredicto siempre es de Intralock.
Detalles
Notas de construcción
Antes de construir
Forma del veredicto
enforce devuelve la fila shadow con shadow: false, más allow, reason, la action admitida, llm: false y protocolVersion.
Aprobaciones
Una write sin token vuelve de call con allow: false y un approvalId. La ruta enforce devuelve solo allow y reason.
Packs de mapeo
Un upstream puede llevar un pack de mapeo que nombra la acción y el recurso de cada herramienta. Una herramienta mapeada se admite contra su recurso en lugar del valor por defecto.
Permisos
mode, upstream-add y upstream-remove necesitan policies.approve. enforce, call y shadow no llevan permiso propio, así que el control es el veredicto de admisión.
Límites y medición
call agota el tiempo de un upstream a los 8000 ms y rechaza una respuesta mayor de 1 MiB.
Se registran como máximo 50 upstreams, el historial de llamadas guarda 200 filas y shadow devuelve los últimos 50 eventos.
Un pack de mapeo contiene como máximo 200 herramientas. Las entradas sobrantes se descartan.
enforce sin actorDid o tool devuelve 400, y call sin upstream también.
Acceso
API y MCP
REST y MCP
Autentícate con una clave de API del workspace como token Bearer. La URL base es https://api.intramedial.com.
Endpoints REST
POST/api/v1/acp/mcp/enforceAdmite una llamada a una herramienta y devuelve el veredicto; no reenvía nada.
POST/api/v1/acp/mcp/callAdmite, depura, reenvía y filtra una llamada a través de un upstream.
POST/api/v1/acp/mcp/modeFija el modo de pasarela del workspace.
GET/api/v1/acp/mcp/shadowLista los últimos 50 eventos observados.
POST/api/v1/acp/mcp/upstream-addRegistra un servidor MCP upstream.
Acciones MCP
MCPcoordination.mcp.enforcePide un veredicto desde un agente.
MCPcoordination.mcp.modeFija el modo desde un agente.
MCPcoordination.mcp.shadowLee el registro shadow desde un agente.
Módulo de la plataforma
