Intramedial befindet sich in der eingeschränkten Beta. Bei der Registrierung oder Anmeldung müssen Sie das erhaltene Beta-Tester-Passwort angeben oder unter preview@intramedial.com eines anfordern. Vielen Dank.
Wird geladen…
mcp.enforceModul 04
Plane-Modul
MCP gateway enforcement
Setzen Sie einem MCP-Server eine Front vor, damit jeder Tool-Aufruf wie jede andere Absicht zugelassen wird und ein abgelehnter Aufruf den Server nie erreicht.
mcp.enforce fragt Intralock, ob ein Agent ein MCP-Tool aufrufen darf, und liefert ein Urteil, ohne Modell im Pfad. Dasselbe Gateway kann einen Aufruf auch an einen registrierten Upstream weiterleiten, unter dem Modus des Workspace: observe erfasst, advise berichtet, enforce lehnt ab.
Intralock · Leases · Parley · Fleet Map
A Trustvice Product
Agenten handeln, wenn die Ebene Ja sagt – und das Protokoll sagt, warum.
Leiten Sie Agent-Aktionen, Inhalts-Hashes, API-Checks, DNS-Abfragen, Webhooks, LLM-Aufrufe und Git-Commits über Intramedial – für einen signierten Beleg, den jeder prüft, ohne uns zu vertrauen.
mcp/enforce liefert allow oder refuse und leitet nichts weiter. Damit das Gateway einen Aufruf zulässt, bereinigt, weiterleitet und prüft, registrieren Sie einen Upstream mit upstream-add und senden den Aufruf an mcp/call.
Protokoll
Das Protokoll
Was erfasst wird
actorDid
Pflicht. Der aufrufende Agent. Ein authentifizierter Agent kann nur sich selbst nennen.
tool
Pflicht. Der MCP-Tool-Name. Er ist auch die zugelassene Ressource, sofern nicht resource gesendet wird.
Optional. Ein Tool, dessen Name nach Mutation klingt, etwa fs.write, wird als write zugelassen, was auch immer Sie senden. Nur delete bleibt erhalten.
confirmationToken
Optional. Das Token, das ein Freigeber für einen Schreib- oder Löschvorgang ausstellte, der Bestätigung braucht.
allow
In der Antwort: ob Intralock die Absicht zuließ.
reason
In der Antwort: warum, etwa quarantine oder ein fehlender Grant.
llm
In der Antwort: false. Das Urteil kommt aus einer reinen Funktion.
protocolVersion
Die MCP-Protokollversion, die das Gateway spricht.
Mechanismus
Schritt für Schritt
So funktioniert es
Formen und Phasen
A
observe
Der Standard. call leitet ohne Zulassungsprüfung weiter und vermerkt den Aufruf als observed. Das Shadow-Log des Workspace füllt sich mit dem, was Agenten getan hätten.
B
advise
call lässt die Absicht zu und meldet, was die Plane gesagt hätte, etwa would be refused, leitet aber trotzdem weiter. Deklarierte Transformationen gelten weiter.
C
enforce
call lässt die Absicht zu und leitet nur weiter, wenn erlaubt. Ein abgelehnter Aufruf liefert forwarded: false und verlässt das Gateway nie.
Schritt für Schritt
Den Modus setzen
mode nimmt observe, advise oder enforce und speichert ihn für den Workspace. Starten Sie mit observe und lesen Sie shadow, bevor Sie umschalten.
Einen Upstream registrieren
upstream-add nennt einen MCP-Server per URL, mit optionalem Verbindungs-Credential oder einem Mapping-Pack, das seine Tools klassifiziert.
Läuft in einem gemeinsamen Demo-Workspace mit einem Demo-Schlüssel: Jeder kann sehen, was darin liegt, senden Sie also nichts Privates. Doku zu mcp.enforce
Antworten
Klicken Sie auf Ausführen, um die Anfrage links an den gemeinsamen Demo-Workspace zu senden.
Läuft in einem gemeinsamen Demo-Workspace mit einem Demo-Schlüssel: Jeder kann sehen, was darin liegt, senden Sie also nichts Privates.
Code
Live-Beispiel
Eine echte Anfrage
Eine Anfrage in der Form, die die API akzeptiert, und eine Beispielantwort in der Form, die das Modul liefert.
Ein Tool namens bash oder fs.write wird als Schreibvorgang zugelassen, braucht also einen Grant und, unter der Bestätigungsuntergrenze, eine menschliche Freigabe, bevor es läuft.
Ausprobieren, bevor durchgesetzt wird
Laufen Sie eine Woche in observe. shadow listet die letzten 50 Aufrufe, die die Plane sah, sodass Sie sehen, welche abgelehnt worden wären.
Antworten entschärfen
call prüft die Antwort des Upstreams, entschärft anweisungsförmigen Text und setzt instructionShaped in provenance, sodass ein Tool-Ergebnis nicht als Anweisung auftreten kann.
Riskante Argumente entfernen
In advise und enforce entfernt callcommand und shell aus den Argumenten und listet die entfernten Namen in stripped.
Wann etwas anderes passt
Eine einzelne Zulassungsprüfung ohne MCP-Rahmen. Nutzen Sie coordination.admit; das Gateway ruft es für Sie auf.
Eine menschliche Entscheidung für einen Schreibvorgang einholen. Freigeber nutzen coordination.approve; das Gateway liefert nur die approvalId.
GitHub-Repositories absichern. Nutzen Sie github.enforce, das repo:-Ressourcen zulässt und das Ergebnis an GitHub zurückmeldet.
Nachweis
Garantien
Was es leistet und was nicht
Ein Modul ist eine starke Aussage über etwas Enges. Verlassen Sie sich genau darauf.
Es leistet
enforce führt die Intralock-Zulassung in jedem gespeicherten Modus aus, sodass das Urteil dieselbe Antwort einer reinen Funktion ist wie bei coordination.admit.
Im Modus enforce wird ein abgelehnter call nicht weitergeleitet: Die Antwort sagt forwarded: false, und keine Anfrage geht an den Upstream.
Jede enforce- und observe-Anfrage hängt ein Ereignis mcp.shadow und jeder Aufruf ein Ereignis mcp.call ans Ledger an.
Ein mutationsförmiger Tool-Name kann durch die Anfrage nicht zu read oder call herabgestuft werden.
Es leistet nicht
Dass ein Client das Gateway nicht umgehen kann. Es lässt nur an es gesendete Aufrufe zu; ein Agent mit der Adresse des Servers kann ihn direkt aufrufen.
Dass eine geprüfte Antwort sicher ist. Entschärfung und das Flag instructionShaped sind Heuristiken auf Text, keine Garantie.
Dass eine Upstream-Adresse sicher ist. Die Prüfung liest den URL-Text und kann nicht sehen, wie ein Hostname aufgelöst wird.
Dass der mode der Antwort der verwendete Modus ist. Bei enforce meldet er den gespeicherten Modus, der observe sein kann, auch wenn das Urteil immer von Intralock stammt.
Details
Bauhinweise
Bevor Sie bauen
Form des Urteils
enforce liefert die Shadow-Zeile mit shadow: false, dazu allow, reason, die zugelassene action, llm: false und protocolVersion.
Freigaben
Ein write ohne Token kommt von call mit allow: false und einer approvalId zurück. Die Route enforce liefert nur allow und reason.
Mapping-Packs
Ein Upstream kann ein Mapping-Pack tragen, das Aktion und Ressource jedes Tools nennt. Ein abgebildetes Tool wird gegen seine Ressource statt gegen den Standard zugelassen.
Berechtigungen
mode, upstream-add und upstream-remove brauchen policies.approve. enforce, call und shadow tragen keine eigene Berechtigung, sodass das Zulassungsurteil die Kontrolle ist.
Limits und Bemessung
call lässt einen Upstream nach 8000 ms in den Timeout laufen und lehnt eine Antwort über 1 MiB ab.
Höchstens 50 Upstreams werden registriert, die Aufrufhistorie behält 200 Zeilen, und shadow liefert die letzten 50 Ereignisse.
Ein Mapping-Pack enthält höchstens 200 Tools. Überzählige Einträge werden verworfen.
enforce ohne actorDid oder tool liefert 400, ebenso call ohne upstream.
Zugriff
API & MCP
REST und MCP
Authentifizieren Sie sich mit einem Workspace-API-Schlüssel als Bearer-Token. Die Basis-URL ist https://api.intramedial.com.
REST-Endpunkte
POST/api/v1/acp/mcp/enforceEinen Tool-Aufruf zulassen und das Urteil liefern; leitet nichts weiter.
POST/api/v1/acp/mcp/callEinen Aufruf über einen Upstream zulassen, bereinigen, weiterleiten und prüfen.
POST/api/v1/acp/mcp/modeDen Gateway-Modus des Workspace setzen.
GET/api/v1/acp/mcp/shadowDie letzten 50 beobachteten Ereignisse auflisten.
Plane-Modul
