Intramedial è in beta ristretta. Alla registrazione o all’accesso devi fornire la password da beta tester che hai ricevuto oppure richiederne una a preview@intramedial.com. Grazie.
Caricamento…
mcp.shadowModulo 13
Modulo della piattaforma
Shadow agent discovery
Elenca le chiamate a tool che il gateway MCP ha visto, con l’agente dietro ciascuna, così i chiamanti che nessuno ha registrato compaiono accanto a quelli registrati.
mcp.shadow restituisce gli ultimi eventi registrati dal gateway MCP: chi ha chiamato, quale tool e in quale modalità. Ogni chiamata observe ed enforce ne scrive uno nel ledger come mcp.shadow, che il chiamante sia registrato o no. Confrontando i chiamanti con l’elenco delle identità si trovano quelli che nessuno ha registrato.
Intralock · Lease · Parley · Fleet Map
Un prodotto Trustvice
Gli agenti agiscono quando il piano dice sì, e il registro dice perché.
Fai passare da Intramedial azioni di agenti, hash di contenuti, controlli API, lookup DNS, webhook, chiamate LLM e commit git. Ricevi una ricevuta firmata che chiunque verifica, senza fidarsi di noi.
StatoI chiamanti sconosciuti sono calcolati alla lettura
La route elenca gli eventi del gateway. Non segna un chiamante come sconosciuto né salva una decisione di autorizzazione. La console confronta i chiamanti con il registro, e registrare un DID è l’unica decisione conservata.
Registro
Il registro
Cosa viene registrato
events
Gli ultimi 50 eventi mcp.shadow, nell’ordine in cui sono stati letti.
at
Quando il gateway ha registrato la chiamata.
event.actorDid
Il DID nominato dalla chiamata, o una stringa vuota se non ne nominava.
Il nome del tool, o la risorsa quando non è stato dato un tool.
event.mode
La modalità del gateway quando la chiamata è stata registrata: observe, advise o enforce.
event.resource
La risorsa nominata dalla chiamata, quando ne nominava una.
kind
Sempre registry.shadow.
protocolVersion
La versione di protocollo MCP parlata dal gateway.
Meccanismo
Passo dopo passo
Come funziona
Il gateway registra ogni chiamata
Una chiamata observe o enforce al gateway MCP aggiunge un evento mcp.shadow con actorDid, tool, mode e, se fornita, resource.
Gli eventi sono riletti
GET /api/v1/acp/mcp/shadow unisce nell’elenco gli eventi del ledger mcp.shadow del workspace e restituisce gli ultimi 50, ciascuno con la sua ora.
I chiamanti incontrano il registro
La console Shadow legge anche identity/list. Un DID visto al gateway e assente dal registro compare come sconosciuto, con il numero di chiamate, l’ultima volta visto e i tool.
Decide una persona
Registrare il DID con shadow: true lo traccia, e registrarlo senza lo autorizza. Nessuna azione blocca un chiamante da qui; uno lasciato stare resta elencato.
Provalo
Demo live
Eseguilo da questa pagina
GET/api/v1/acp/mcp/shadow
// Nessun body: è una GET. Premi Esegui.
Viene eseguito in un workspace demo condiviso con una chiave demo: chiunque può vedere cosa contiene, quindi non inviare nulla di privato. Docs di mcp.shadow
Risposte
Premi Esegui per inviare la richiesta a sinistra al workspace demo condiviso.
Viene eseguito in un workspace demo condiviso con una chiave demo: chiunque può vedere cosa contiene, quindi non inviare nulla di privato.
Codice
Esempio live
Una richiesta reale
Una richiesta nella forma accettata dall’API e una risposta di esempio nella forma restituita dal modulo.
Un ingegnere collega uno script al gateway. Il suo DID compare nell’elenco senza voce nel registro, prima che qualcuno debba chiedere chi sia.
Dimensionare un rilascio
In observe il gateway registra soltanto. Una settimana di eventi mostra quali agenti e tool incontrerebbe enforce prima di attivarlo.
Rivedere una prova
Gli agenti registrati con shadow: true restano marcati, così un team può rivedere ciò che ha tracciato e autorizzare quelli che mantiene.
Controllare un tool sospetto
Filtra gli eventi per tool per vedere ogni chiamante che lo ha raggiunto e in quale modalità.
Quando usare altro
Fermare un chiamante sconosciuto. L’elenco riporta soltanto; metti il gateway in enforce con mcp.enforce, o ferma un DID indicato con coordination.quarantine.
Trovare agenti che non usano mai il gateway MCP. I chiamanti GitHub e SaaS non scrivono questi eventi; usa i loro punti di applicazione.
Leggere ogni chiamata a tool. Le chiamate fatte tramite un upstream registrato sono nel ledger come mcp.call; questo elenco contiene solo eventi shadow.
Prove
Garanzie
Cosa fa e cosa non fa
Un modulo è una promessa forte su una cosa circoscritta. Contaci esattamente per ciò che è.
Fa
Ogni chiamata observe o enforce al gateway MCP lascia un evento mcp.shadow, che porta il DID nominato.
Nessuna richiesta a ledger/append può scrivere un evento mcp.shadow; la piattaforma scrive da sé quel tipo.
Ogni lettura unisce nell’elenco gli eventi del ledger mcp.shadow del workspace, quindi compaiono anche gli eventi scritti da un’altra istanza Worker.
Non fa
Che un agente non elencato non abbia mai chiamato. Sono registrate solo le chiamate observe ed enforce tramite questo gateway, e l’elenco si ferma agli ultimi 50.
Chi sta dietro un DID. L’elenco registra il DID portato da una chiamata e non lo lega ad alcun proprietario.
Che una chiamata sia stata bloccata o dannosa. Un evento registra che una chiamata è arrivata; l’allow o il deny torna al chiamante e qui non è salvato.
Dettagli
Note di sviluppo
Prima di costruire
Registrato o no
Un evento non dice se il suo chiamante è registrato. Quel confronto si fa alla lettura, rispetto all’elenco delle identità.
Modalità del gateway
La modalità è per default observe, dove il gateway registra e lascia passare la chiamata. advise aggiunge il consiglio di un classificatore, e solo enforce può rifiutare.
Tracciato non è autorizzato
Registrare un DID con shadow: true imposta un flag sul suo record nel registro. Non concede né nega nulla; l’ammissione richiede comunque un grant.
Limiti e misurazione
La route restituisce al massimo gli ultimi 50 eventi e non accetta filtri né cursore.
Gli eventi non portano conteggi. Primo e ultimo avvistamento e totali di chiamate sono calcolati dalla console dagli eventi che riceve.
Leggere l’elenco non è misurato.
Solo il gateway MCP scrive questi eventi. Altri punti di applicazione tengono i propri registri.
Accesso
API e MCP
REST e MCP
Autenticati con una chiave API del workspace come token Bearer. L’URL di base è https://api.intramedial.com.
Endpoint REST
GET/api/v1/acp/mcp/shadowElenca gli ultimi eventi del gateway MCP registrati come chiamate shadow.
Azioni MCP
MCPcoordination.mcp.shadowElenca gli stessi eventi come azione MCP.
Modulo della piattaforma
