Torna agli aggiornamenti
New releaseSep 11, 2026

scopeblind-gateway v0.13.1

Gate delle policy Cedar fail-closed con ricevute firmate per le chiamate agli strumenti degli agenti AI. npx protect-mcp

Condividi

protect-mcp

Applicazione locale delle policy e ricevute firmate delle decisioni per le chiamate agli strumenti degli agenti AI.

npm version Monthly npm downloads Node.js compatibility Package checks MIT license

Pagina per sviluppatori · Avvio rapido · Configurazione dell'agente · Pacchetti di policy · Record di esempio · Integrazioni · Documentazione · Contribuisci

Colloca il gateway tra un client MCP e il suo server di strumenti, oppure usa i suoi hook in un agente di programmazione. Esamina una policy Cedar, abilita l'applicazione e conserva un record firmato delle decisioni. La valutazione e la verifica locali non richiedono un account ScopeBlind e non inviano alcuna telemetria sulle decisioni.

  • Applica al confine dello strumento. Cedar nega in caso di policy mancanti, errori del motore o errori di valutazione in modalità fail-closed. La modalità shadow è quella predefinita per il wrapper MCP: usa --enforce quando sei pronto a bloccare.
  • Verifica ciò che è stato firmato. Le ricevute Ed25519 includono la decisione e il digest della policy. @veritasacta/verify verifica i byte rispetto alla chiave pubblica di cui ti fidi.
  • Inizia con gli strumenti esistenti. Usa MCP stdio, il gateway HTTP o gli hook dell'agente di programmazione. La collaborazione ospitata opzionale ha i propri permessi e flussi di dati.

Un gateway copre le chiamate instradate attraverso di esso. Non è una sandbox del sistema operativo, e una ricevuta firmata non stabilisce che un'azione sia stata eseguita né che nessuna azione sia stata omessa. La policy di sicurezza descrive il confine e il processo di segnalazione.

Guarda il risultato

Un'esecuzione locale reale: valuta due chiamate proposte, firma le decisioni, verifica le ricevute, poi modifica una decisione firmata e controllala di nuovo.

Riepilogo del risultato in cinque passaggi: una lettura è consentita, un force-push proposto è negato, entrambe le decisioni sono firmate, le loro ricevute vengono verificate e una negazione modificata non supera la verifica della firma. Nessuno strumento proposto viene eseguito.

Guarda la panoramica di 14 secondi

Riepilogo animato del risultato degli stessi cinque passaggi, basato sull'output CLI catturato.

Procedura dettagliata testuale e riproduzione · Risultati catturati

Provalo senza un agente

Usa Node.js 22 e npm in una nuova directory. Installa il gateway e il verificatore con versione fissata:

mkdir protect-mcp-demo
cd protect-mcp-demo
npm init -y
npm install --save-exact [email protected] @veritasacta/[email protected]

Questo esempio valuta due chiamate proposte e firma le loro decisioni. Non esegue nessuno dei due strumenti né esegue git push. Tutto ciò che segue l'installazione è locale.

# Create a starter policy and a private signing key.
npx --no-install protect-mcp init --starter

# A normal read is allowed; a force-push to main is denied (exit 2).
npx --no-install protect-mcp evaluate --policy ./protect.cedar --tool Read --input '{"path":"README.md"}'
npx --no-install protect-mcp evaluate --policy ./protect.cedar --tool Bash --input '{"command":"git push --force origin main"}' || test "$?" -eq 2

# Evaluate again at signing time and record both decisions, in order.
npx --no-install protect-mcp sign --cedar builtin:starter --tool Read --input '{"path":"README.md"}' --key ./protect-mcp.key --receipts ./receipts
npx --no-install protect-mcp sign --cedar builtin:starter --tool Bash --input '{"command":"git push --force origin main"}' --key ./protect-mcp.key --receipts ./receipts

# Take only the public key from the key you generated, not from the receipt.
PROTECT_MCP_PUBLIC_KEY=$(node -p 'JSON.parse(require("fs").readFileSync("protect-mcp.key", "utf8")).publicKey')
npx --no-install verify --replay-chain ./receipts/receipts.jsonl --key "$PROTECT_MCP_PUBLIC_KEY" --json

# Change the signed deny to allow. The original receipt log stays intact.
node -e 'const fs=require("fs");const r=JSON.parse(fs.readFileSync("receipts/receipts.jsonl","utf8").trim().split("\n")[1]);r.payload.decision="allow";fs.writeFileSync("tampered.json",JSON.stringify(r))'
npx --no-install verify tampered.json --key "$PROTECT_MCP_PUBLIC_KEY" --json || test "$?" -eq 1

Atteso: allow, poi deny; entrambe le firme originali delle ricevute e il loro link verificano; la ricevuta modificata riporta invalid_signature. Mantieni protect-mcp.key privato. Per verificare il record di qualcun altro, ottieni la loro chiave pubblica attesa attraverso un canale fidato indipendente.

I codici di uscita del verificatore sono 0: valido, 1: non valido, 2: non verificato/errore. Un risultato non valido non è necessariamente manomissione: anche la chiave attesa sbagliata può far fallire la verifica. La riproduzione della catena controlla i link forniti; non stabilisce che tu abbia ricevuto l'intera cronologia.

La CI esegue questo esempio esatto contro il candidato pacchettizzato e il verificatore pubblicato fissato. Vedi validazione e rilasci.

Connetti il tuo agente

Scegli l'integrazione che corrisponde al tuo host e alla copertura di cui hai bisogno. Installare le skill di guida non abilita l'applicazione delle regole. doctor controlla la configurazione locale; conferma la rotta selezionata con una chiamata reale consentita e una bloccata.

Per il plugin di Claude Code, prima prepara e avvia il gate locale, poi installalo nel tuo progetto (Claude Code 2.1.295 o successivo):

claude plugin install protect-mcp --marketplace ScopeBlind/scopeblind-gateway --scope project

Il plugin blocca le chiamate agli strumenti instradate mentre il suo gate non è disponibile. Scegliere il plugin oppure gli hook di progetto standalone, in modo che la stessa chiamata non venga registrata due volte.

Categorie