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.enforceModulo 04
Modulo della piattaforma
MCP gateway enforcement
Metti un fronte davanti a un server MCP così ogni chiamata a tool è ammessa come qualsiasi altro intent, e una chiamata rifiutata non raggiunge mai il server.
mcp.enforce chiede a Intralock se un agente può chiamare un tool MCP e restituisce un verdetto, senza alcun modello nel percorso. Lo stesso gateway può anche inoltrare una chiamata a un upstream registrato in base alla modalità del workspace: observe registra, advise riporta, enforce rifiuta.
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.
mcp/enforce restituisce allow o rifiuto e non inoltra nulla. Perché il gateway ammetta, tolga, inoltri e verifichi una chiamata, registra un upstream con upstream-add e invia la chiamata a mcp/call.
Registro
Il registro
Cosa viene registrato
actorDid
Obbligatorio. L’agente che fa la chiamata. Un agente autenticato può nominare solo sé stesso.
tool
Obbligatorio. Il nome del tool MCP. È anche la risorsa ammessa, salvo che sia inviato resource.
Opzionale. Un tool il cui nome sembra una mutazione, come fs.write, è ammesso come write qualunque cosa tu invii. Solo delete è mantenuto.
confirmationToken
Opzionale. Il token che un approvatore ha emesso per una scrittura o cancellazione che richiede conferma.
allow
Nella risposta: se Intralock ha ammesso l’intent.
reason
Nella risposta: perché, ad esempio quarantine o un grant mancante.
llm
Nella risposta: false. Il verdetto viene da una funzione pura.
protocolVersion
La versione del protocollo MCP parlata dal gateway.
Meccanismo
Passo dopo passo
Come funziona
Forme e fasi
A
observe
Il predefinito. call inoltra senza controllo di ammissione e annota la chiamata come observed. Il log shadow del workspace si riempie di ciò che gli agenti avrebbero fatto.
B
advise
call ammette l’intent e riporta cosa avrebbe detto il piano, come would be refused, ma inoltra comunque. Le trasformazioni dichiarate si applicano ancora.
C
enforce
call ammette l’intent e inoltra solo se permesso. Una chiamata rifiutata restituisce forwarded: false e non lascia mai il gateway.
Passo dopo passo
Imposta la modalità
mode accetta observe, advise o enforce e la salva per il workspace. Parti da observe e leggi shadow prima di passare.
Registra un upstream
upstream-add nomina un server MCP per URL, con una credenziale di connessione opzionale o un pack di mappatura che classifica i suoi tool.
Invia una chiamata
call accetta , , e . Il gateway ricava azione e risorsa, ammette l’intent e inoltra se permesso.
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.enforce
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 tool chiamato bash o fs.write è ammesso come scrittura, quindi richiede un grant e, sotto la soglia di conferma, l’approvazione di una persona prima dell’esecuzione.
Provare prima di applicare
Esegui in observe per una settimana. shadow elenca le ultime 50 chiamate viste dal piano, così vedi quali sarebbero state rifiutate.
Disinnescare le risposte
call verifica la risposta dell’upstream, disinnesca il testo a forma di istruzione e imposta instructionShaped in provenance, così il risultato di un tool non può spacciarsi per istruzione.
Scartare argomenti rischiosi
In advise ed enforce, call rimuove command e shell dagli argomenti ed elenca i nomi rimossi in stripped.
Quando usare altro
Un singolo controllo di ammissione senza inquadramento MCP. Usa coordination.admit; il gateway lo chiama per te.
Raccogliere una decisione umana per una scrittura. Gli approvatori usano coordination.approve; il gateway restituisce solo l’approvalId.
Vincolare i repository GitHub. Usa github.enforce, che ammette risorse repo: e riporta il risultato a GitHub.
Prove
Garanzie
Cosa fa e cosa non fa
Un modulo è una promessa forte su una cosa circoscritta. Contaci esattamente per ciò che è.
Fa
enforce esegue l’ammissione di Intralock qualunque modalità sia salvata, quindi il verdetto è la stessa risposta da funzione pura di coordination.admit.
In modalità enforce una call rifiutata non è inoltrata: la risposta dice forwarded: false e nessuna richiesta va all’upstream.
Ogni richiesta enforce e observe aggiunge al ledger un evento mcp.shadow, e ogni chiamata un evento mcp.call.
Un nome di tool a forma di mutazione non può essere declassato a read o call dalla richiesta.
Non fa
Che un client non possa aggirare il gateway. Ammette solo le chiamate inviate a lui; un agente che ha l’indirizzo del server può chiamarlo direttamente.
Che una risposta verificata sia sicura. Disinnesco e flag instructionShaped sono euristiche sul testo, non una garanzia.
Che l’indirizzo di un upstream sia sicuro. Il controllo legge il testo dell’URL e non può vedere come si risolve un hostname.
Che il mode della risposta sia la modalità usata. Su enforce riporta la modalità salvata, che può essere observe, anche se il verdetto è sempre di Intralock.
Dettagli
Note di sviluppo
Prima di costruire
Forma del verdetto
enforce restituisce la riga shadow con shadow: false, più allow, reason, l’action ammessa, llm: false e protocolVersion.
Approvazioni
Una write senza token torna da call con allow: false e un approvalId. La route enforce restituisce solo allow e reason.
Pack di mappatura
Un upstream può portare un pack di mappatura che nomina azione e risorsa di ogni tool. Un tool mappato è ammesso rispetto alla sua risorsa invece che a quella predefinita.
Permessi
mode, upstream-add e upstream-remove richiedono policies.approve. enforce, call e shadow non portano permessi propri, quindi il controllo è il verdetto di ammissione.
Limiti e misurazione
call interrompe un upstream dopo 8000 ms e rifiuta una risposta più grande di 1 MiB.
Si registrano al massimo 50 upstream, la cronologia delle chiamate tiene 200 righe e shadow restituisce gli ultimi 50 eventi.
Un pack di mappatura contiene al massimo 200 tool. Le voci in più sono scartate.
enforce senza actorDid o tool restituisce 400, e lo stesso vale per call senza upstream.
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
POST/api/v1/acp/mcp/enforceAmmetti una chiamata a tool e restituisci il verdetto; non inoltra nulla.
POST/api/v1/acp/mcp/callAmmetti, togli, inoltra e verifica una chiamata tramite un upstream.
POST/api/v1/acp/mcp/modeImposta la modalità del gateway del workspace.
GET/api/v1/acp/mcp/shadowElenca gli ultimi 50 eventi osservati.
POST/api/v1/acp/mcp/upstream-addRegistra un server MCP upstream.
Azioni MCP
MCPcoordination.mcp.enforceChiedi un verdetto da un agente.
MCPcoordination.mcp.modeImposta la modalità da un agente.
MCPcoordination.mcp.shadowLeggi il log shadow da un agente.
Modulo della piattaforma
