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.shadowModul 13
Plane-Modul
Shadow agent discovery
Listen Sie die Tool-Aufrufe auf, die das MCP-Gateway gesehen hat, mit dem Agenten hinter jedem, damit nicht eingeschriebene Aufrufer neben den eingeschriebenen auftauchen.
mcp.shadow liefert die jüngsten vom MCP-Gateway erfassten Ereignisse: wer aufrief, welches Tool und in welchem Modus. Jeder observe- und enforce-Aufruf schreibt eines als mcp.shadow ins Ledger, ob der Aufrufer eingeschrieben ist oder nicht. Der Vergleich der Aufrufer mit der Identitätsliste zeigt die, die niemand eingeschrieben hat.
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.
StatusUnbekannte Aufrufer werden beim Lesen ermittelt
Die Route listet Gateway-Ereignisse. Sie markiert keinen Aufrufer als unbekannt und speichert keine Sanktionsentscheidung. Die Konsole vergleicht Aufrufer mit der Registry, und das Einschreiben einer DID ist die einzige gespeicherte Entscheidung.
Protokoll
Das Protokoll
Was erfasst wird
events
Die jüngsten 50 mcp.shadow-Ereignisse, in der Reihenfolge, in der sie gelesen wurden.
at
Wann das Gateway den Aufruf erfasste.
event.actorDid
Die im Aufruf genannte DID, oder ein leerer String, wenn er keine nannte.
Der Tool-Name, oder die Ressource, wenn kein Tool angegeben war.
event.mode
Der Gateway-Modus bei der Erfassung des Aufrufs: observe, advise oder enforce.
event.resource
Die im Aufruf genannte Ressource, falls er eine nannte.
kind
Immer registry.shadow.
protocolVersion
Die MCP-Protokollversion, die das Gateway spricht.
Mechanismus
Schritt für Schritt
So funktioniert es
Das Gateway erfasst jeden Aufruf
Ein observe- oder enforce-Aufruf am MCP-Gateway hängt ein mcp.shadow-Ereignis mit actorDid, tool, mode und, falls angegeben, resource an.
Die Ereignisse werden zurückgelesen
GET /api/v1/acp/mcp/shadow führt die mcp.shadow-Ledger-Ereignisse des Workspace in die Liste zusammen und liefert die jüngsten 50, jedes mit seiner Zeit.
Aufrufer treffen auf die Registry
Die Shadow-Konsole liest zusätzlich identity/list. Eine am Gateway gesehene und in der Registry fehlende DID erscheint als unbekannt, mit Aufrufzahl, letzter Sichtung und Tools.
Eine Person entscheidet
Die DID mit shadow: true einzuschreiben verfolgt sie, ohne sanktioniert sie. Von hier aus blockiert keine Aktion einen Aufrufer; ein unberührter bleibt gelistet.
Ausprobieren
Live-Demo
Direkt auf dieser Seite ausführen
GET/api/v1/acp/mcp/shadow
// Kein Body: Das ist ein GET. Klicken Sie auf Ausführen.
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.shadow
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 Ingenieur bindet ein Skript ans Gateway an. Seine DID erscheint in der Liste ohne Registry-Eintrag, bevor jemand fragen muss, wer es ist.
Einen Rollout abschätzen
Bei observe erfasst das Gateway nur. Eine Woche an Ereignissen zeigt, welche Agenten und Tools enforce träfe, bevor es eingeschaltet wird.
Einen Testlauf auswerten
Mit shadow: true eingeschriebene Agenten bleiben markiert, sodass ein Team durchgehen kann, was es verfolgte, und die sanktioniert, die es behält.
Ein verdächtiges Tool prüfen
Filtern Sie die Ereignisse nach tool, um jeden Aufrufer zu sehen, der es erreichte, und in welchem Modus.
Wann etwas anderes passt
Einen unbekannten Aufrufer stoppen. Die Liste berichtet nur; setzen Sie das Gateway mit mcp.enforce auf enforce, oder stoppen Sie eine benannte DID mit coordination.quarantine.
Agenten finden, die das MCP-Gateway nie nutzen. GitHub- und SaaS-Aufrufer schreiben diese Ereignisse nicht; nutzen Sie deren eigene Durchsetzungspunkte.
Jeden Tool-Aufruf lesen. Aufrufe über einen registrierten Upstream stehen als mcp.call im Ledger; diese Liste enthält nur Shadow-Ereignisse.
Nachweis
Garantien
Was es leistet und was nicht
Ein Modul ist eine starke Aussage über etwas Enges. Verlassen Sie sich genau darauf.
Es leistet
Jeder observe- oder enforce-Aufruf am MCP-Gateway hinterlässt ein mcp.shadow-Ereignis mit der genannten DID.
Keine Anfrage an ledger/append kann ein mcp.shadow-Ereignis schreiben; die Plane schreibt diese Art selbst.
Jedes Lesen führt die mcp.shadow-Ledger-Ereignisse des Workspace in die Liste zusammen, sodass auch von einer anderen Worker-Instanz geschriebene Ereignisse erscheinen.
Es leistet nicht
Dass ein nicht gelisteter Agent nie aufgerufen hat. Nur observe- und enforce-Aufrufe über dieses Gateway werden erfasst, und die Liste endet bei den jüngsten 50.
Wer hinter einer DID steht. Die Liste erfasst die DID, die ein Aufruf trug, und verknüpft sie mit keinem Eigentümer.
Dass ein Aufruf blockiert oder schädlich war. Ein Ereignis erfasst, dass ein Aufruf eintraf; das Zulassen oder Ablehnen geht an den Aufrufer zurück und wird hier nicht gespeichert.
Details
Bauhinweise
Bevor Sie bauen
Registriert oder nicht
Ein Ereignis sagt nicht, ob sein Aufrufer eingeschrieben ist. Dieser Vergleich erfolgt beim Lesen, gegen die Identitätsliste.
Gateway-Modus
Der Modus ist standardmäßig observe, wobei das Gateway erfasst und den Aufruf durchlässt. advise ergänzt den Rat eines Klassifikators, und nur enforce kann ablehnen.
Verfolgt ist nicht sanktioniert
Das Einschreiben einer DID mit shadow: true setzt ein Flag an ihrem Registry-Datensatz. Es gewährt nichts und verweigert nichts; die Zulassung braucht weiterhin einen Grant.
Limits und Bemessung
Die Route liefert höchstens die jüngsten 50 Ereignisse und nimmt weder Filter noch Cursor.
Ereignisse tragen keine Zählungen. Erst- und Letztsichtung sowie Aufrufsummen ermittelt die Konsole aus den empfangenen Ereignissen.
Das Lesen der Liste wird nicht gemessen.
Nur das MCP-Gateway schreibt diese Ereignisse. Andere Durchsetzungspunkte führen eigene Aufzeichnungen.
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
GET/api/v1/acp/mcp/shadowDie jüngsten als Shadow-Aufrufe erfassten MCP-Gateway-Ereignisse auflisten.
MCP-Aktionen
MCPcoordination.mcp.shadowDieselben Ereignisse als MCP-Aktion auflisten.
Sehen Sie jeden Agenten, jedes Repo, jede Lease und jede benannte Ressource, die Ihr Workspace kennt, und wie sie zusammenhängen, ohne die Karte zuerst zeichnen zu müssen.
Plane-Modul
