Zurück zu den Updates
New releaseSep 11, 2026

scopeblind-gateway v0.13.1

Fail-closed-Cedar-Richtlinien-Gate plus signierte Belege für Tool-Aufrufe von KI-Agenten. npx protect-mcp

Teilen

protect-mcp

Lokale Richtliniendurchsetzung und signierte Entscheidungsbelege für Tool-Aufrufe von KI-Agenten.

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

Entwicklerseite · Schnellstart · Agent-Einrichtung · Richtlinien-Pakete · Beispielbeleg · Integrationen · Dokumentation · Mitwirken

Setze das Gateway zwischen einen MCP-Client und seinen Tool-Server oder verwende seine Hooks in einem Coding-Agenten. Prüfe eine Cedar-Richtlinie, aktiviere die Durchsetzung und führe einen signierten Beleg über die Entscheidungen. Lokale Auswertung und Verifikation benötigen kein ScopeBlind-Konto und senden keine Entscheidungs-Telemetrie.

  • Durchsetzung an der Tool-Grenze. Cedar verweigert bei fehlenden Richtlinien, Engine- Fehlern oder Auswertungsfehlern im Fail-Closed-Modus. Der Shadow-Modus ist der Standard für den MCP-Wrapper: Verwende --enforce, wenn du bereit bist zu blockieren.
  • Prüfe, was signiert wurde. Ed25519-Belege enthalten die Entscheidung und den Richtlinien- Digest. @veritasacta/verify prüft die Bytes gegen den öffentlichen Schlüssel, dem du vertraust.
  • Beginne mit vorhandenen Tools. Verwende MCP stdio, das HTTP-Gateway oder Coding-Agent- Hooks. Optionale gehostete Zusammenarbeit hat eigene Berechtigungen und Datenflüsse.

Ein Gateway deckt Aufrufe ab, die durch es geleitet werden. Es ist keine OS-Sandbox, und ein signierter Beleg belegt nicht, dass eine Aktion ausgeführt wurde oder dass keine Aktion ausgelassen wurde. Die Sicherheitsrichtlinie beschreibt die Grenze und den Meldeablauf.

Das Ergebnis ansehen

Ein echter lokaler Lauf: zwei vorgeschlagene Aufrufe auswerten, die Entscheidungen signieren, die Belege verifizieren, dann eine signierte Entscheidung ändern und erneut prüfen.

Zusammenfassung des Ergebnisses in fünf Schritten: Ein Lesezugriff ist erlaubt, ein vorgeschlagener Force-Push wird verweigert, beide Entscheidungen werden signiert, ihre Belege werden verifiziert, und eine geänderte Verweigerung besteht die Signaturprüfung nicht. Kein vorgeschlagenes Tool wird ausgeführt.

Sieh dir die 14-sekündige Schritt-für-Schritt-Demo an

Animierte Ergebniszusammenfassung derselben fünf Schritte, basierend auf aufgezeichneter CLI-Ausgabe.

Text-Walkthrough und Reproduktion · Aufgezeichnete Ergebnisse

Ohne Agent ausprobieren

Verwende Node.js 22 und npm in einem neuen Verzeichnis. Installiere das gepinnte Gateway und den Verifier:

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

Dieses Beispiel bewertet zwei vorgeschlagene Aufrufe und signiert ihre Entscheidungen. Es führt weder eines der Tools aus noch ruft es git push auf. Alles nach der Installation ist lokal.

# 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

Erwartet: allow, dann deny; sowohl die ursprünglichen Receipt-Signaturen als auch deren Link verifizieren; das modifizierte Receipt meldet invalid_signature. Halten Sie protect-mcp.key privat. Um den Datensatz einer anderen Person zu verifizieren, beziehen Sie deren erwarteten öffentlichen Schlüssel über einen unabhängigen vertrauenswürdigen Kanal.

Die Exit-Codes des Verifiers sind 0: gültig, 1: ungültig, 2: nicht geprüft/Fehler. Ein ungültiges Ergebnis bedeutet nicht zwangsläufig Manipulation: Auch der falsche erwartete Schlüssel kann die Verifikation fehlschlagen lassen. Das Chain-Replay prüft die übergebenen Links; es stellt nicht sicher, dass Sie die gesamte Historie erhalten haben.

CI führt genau dieses Beispiel gegen den gepackten Kandidaten und den gepinnten veröffentlichten Verifier aus. Siehe Validierung und Releases.

Verbinden Sie Ihren Agenten

Wählen Sie die Integration, die zu Ihrem Host und der benötigten Abdeckung passt. Das Installieren von Guidance-Skills aktiviert keine Durchsetzung. doctor prüft die lokale Konfiguration; bestätigen Sie die gewählte Route mit einem echten erlaubten und einem blockierten Aufruf.

Für das Claude Code Plugin bereiten Sie zuerst das lokale Gate vor und starten Sie es, und installieren Sie es dann in Ihrem Projekt (Claude Code 2.1.295 oder später):

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

Das Plugin blockiert geroutete Tool-Aufrufe, solange sein Gate nicht verfügbar ist. Wählen Sie das Plugin oder die Hooks des eigenständigen Projekts, damit derselbe Aufruf nicht zweimal aufgezeichnet wird.

Kategorien