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.shadowMódulo 13
Módulo de la plataforma
Shadow agent discovery
Lista las llamadas a herramientas que ha visto la pasarela MCP, con el agente tras cada una, para que los llamantes que nadie registró aparezcan junto a los que sí.
mcp.shadow devuelve los últimos eventos que registró la pasarela MCP: quién llamó, qué herramienta y en qué modo. Cada llamada observe y enforce escribe uno en el ledger como mcp.shadow, esté o no registrado quien llama. Comparar los llamantes con la lista de identidades muestra los que nadie registró.
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.
EstadoLos llamantes desconocidos se deducen al leer
La ruta lista eventos de la pasarela. No marca a un llamante como desconocido ni guarda una decisión de autorización. La consola compara los llamantes con el registro, y registrar un DID es la única decisión que se conserva.
Registro
El registro
Qué se registra
events
Los últimos 50 eventos mcp.shadow, en el orden en que se leyeron.
at
Cuándo registró la pasarela la llamada.
event.actorDid
El DID que nombró la llamada, o una cadena vacía cuando no nombró ninguno.
El nombre de la herramienta, o el recurso cuando no se dio herramienta.
event.mode
El modo de la pasarela cuando se registró la llamada: observe, advise o enforce.
event.resource
El recurso que nombró la llamada, cuando nombró alguno.
kind
Siempre registry.shadow.
protocolVersion
La versión del protocolo MCP que habla la pasarela.
Mecanismo
Paso a paso
Cómo funciona
La pasarela registra cada llamada
Una llamada observe o enforce en la pasarela MCP añade un evento mcp.shadow con actorDid, tool, mode y, si se da, resource.
Los eventos se leen de vuelta
GET /api/v1/acp/mcp/shadow fusiona los eventos mcp.shadow del ledger del workspace en la lista y devuelve los últimos 50, cada uno con su hora.
Los llamantes se encuentran con el registro
La consola Shadow también lee identity/list. Un DID visto en la pasarela y ausente del registro aparece como desconocido, con su número de llamadas, la última vez visto y sus herramientas.
Decide una persona
Registrar el DID con shadow: true lo sigue, y registrarlo sin ello lo autoriza. Desde aquí ninguna acción bloquea a un llamante; uno que se deje aparte sigue listado.
Pruébalo
Demo en vivo
Ejecútalo desde esta página
GET/api/v1/acp/mcp/shadow
// Sin cuerpo: esto es un GET. Pulsa Ejecutar.
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.shadow
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.
Un ingeniero conecta un script a la pasarela. Su DID aparece en la lista sin entrada en el registro, antes de que nadie tenga que preguntar quién es.
Dimensionar un despliegue
En observe la pasarela solo registra. Una semana de eventos muestra con qué agentes y herramientas se encontraría enforce antes de activarlo.
Revisar una prueba
Los agentes registrados con shadow: true siguen marcados, así que un equipo puede repasar lo que siguió y autorizar los que conserva.
Comprobar una herramienta sospechosa
Filtra los eventos por tool para ver todos los llamantes que la alcanzaron y en qué modo.
Cuándo usar otra cosa
Detener a un llamante desconocido. La lista solo informa; pon la pasarela en enforce con mcp.enforce, o detén un DID concreto con coordination.quarantine.
Encontrar agentes que nunca usan la pasarela MCP. Los llamantes de GitHub y SaaS no escriben estos eventos; usa sus propios puntos de aplicación.
Leer todas las llamadas a herramientas. Las llamadas hechas a través de un upstream registrado están en el ledger como mcp.call; esta lista contiene solo eventos shadow.
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
Cada llamada observe o enforce en la pasarela MCP deja un evento mcp.shadow, con el DID que nombró.
Ninguna petición a ledger/append puede escribir un evento mcp.shadow; el plano escribe ese tipo por sí mismo.
Cada lectura fusiona los eventos mcp.shadow del ledger del workspace en la lista, así que también aparecen los escritos por otra instancia de Worker.
No hace
Que un agente no listado nunca haya llamado. Solo se registran las llamadas observe y enforce por esta pasarela, y la lista se detiene en los últimos 50.
Quién responde de un DID. La lista registra el DID que llevaba una llamada y no lo vincula a ningún propietario.
Que una llamada se bloqueara o fuera dañina. Un evento registra que llegó una llamada; el allow o deny vuelve a quien llama y no se guarda aquí.
Detalles
Notas de construcción
Antes de construir
Registrado o no
Un evento no dice si quien llama está registrado. Esa comparación se hace al leer, frente a la lista de identidades.
Modo de la pasarela
El modo por defecto es observe, donde la pasarela registra y deja pasar la llamada. advise añade el consejo de un clasificador, y solo enforce puede rechazar.
Seguido no es autorizado
Registrar un DID con shadow: true activa un indicador en su registro. No concede nada ni deniega nada; la admisión sigue necesitando un grant.
Límites y medición
La ruta devuelve como máximo los últimos 50 eventos y no admite filtro ni cursor.
Los eventos no llevan recuentos. La consola calcula las primeras y últimas veces vistas y los totales de llamadas a partir de los eventos que recibe.
Leer la lista no se mide.
Solo la pasarela MCP escribe estos eventos. Otros puntos de aplicación guardan sus propios registros.
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
GET/api/v1/acp/mcp/shadowLista los últimos eventos de la pasarela MCP registrados como llamadas shadow.
Acciones MCP
MCPcoordination.mcp.shadowLista los mismos eventos como acción MCP.
Módulo de la plataforma
