Intramedial est en bêta restreinte. À l’inscription ou à la connexion, vous devez fournir le mot de passe de bêta-testeur que vous avez reçu ou en demander un à preview@intramedial.com. Merci.
Chargement…
mcp.shadowModule 13
Module du plan
Shadow agent discovery
Listez les appels d'outils vus par la passerelle MCP, avec l'agent derrière chacun, pour que les appelants que personne n'a enrôlés apparaissent à côté de ceux qui le sont.
mcp.shadow renvoie les derniers événements enregistrés par la passerelle MCP : qui a appelé, quel outil et dans quel mode. Chaque appel observe et enforce en écrit un dans le registre comme mcp.shadow, que l'appelant soit enrôlé ou non. Comparer les appelants à la liste d'identités révèle ceux que personne n'a enrôlés.
Intralock · Baux · Parley · Fleet Map
A Trustvice Product
Les agents agissent quand le plan dit oui, et le registre dit pourquoi.
Faites passer actions d’agents, hash de contenu, contrôles d’API, requêtes DNS, webhooks, appels LLM et commits git par Intramedial. Obtenez un reçu signé vérifiable par tous – sans nous croire.
ÉtatLes appelants inconnus sont déterminés à la lecture
La route liste les événements de la passerelle. Elle ne marque aucun appelant comme inconnu et ne stocke aucune décision d'autorisation. La console compare les appelants au registre, et enrôler un DID est la seule décision conservée.
Registre
Le registre
Ce qui est enregistré
events
Les 50 derniers événements mcp.shadow, dans l'ordre de lecture.
at
Le moment où la passerelle a enregistré l'appel.
event.actorDid
Le DID nommé par l'appel, ou une chaîne vide s'il n'en nommait aucun.
Le nom de l'outil, ou la ressource quand aucun outil n'était donné.
event.mode
Le mode de la passerelle à l'enregistrement de l'appel : observe, advise ou enforce.
event.resource
La ressource nommée par l'appel, s'il en nommait une.
kind
Toujours registry.shadow.
protocolVersion
La version du protocole MCP que parle la passerelle.
Mécanisme
Pas à pas
Comment ça marche
La passerelle enregistre chaque appel
Un appel observe ou enforce à la passerelle MCP ajoute un événement mcp.shadow avec actorDid, tool, mode et, si fourni, resource.
Les événements sont relus
GET /api/v1/acp/mcp/shadow fusionne dans la liste les événements de registre mcp.shadow de l'espace de travail et renvoie les 50 derniers, chacun avec son heure.
Les appelants rencontrent le registre
La console Shadow lit aussi identity/list. Un DID vu à la passerelle et absent du registre s'affiche comme inconnu, avec son nombre d'appels, sa dernière apparition et ses outils.
Une personne décide
Enrôler le DID avec shadow: true le suit, et l'enrôler sans le autorise. Aucune action ne bloque un appelant d'ici ; celui qu'on laisse reste listé.
Essayer
Démo en direct
Exécutez-le depuis cette page
GET/api/v1/acp/mcp/shadow
// Pas de corps : c’est un GET. Appuyez sur Exécuter.
S’exécute dans un workspace de démonstration partagé avec une clé de démonstration : tout le monde peut voir ce qu’il contient, n’envoyez donc rien de privé. Docs mcp.shadow
Réponses
Appuyez sur Exécuter pour envoyer la requête de gauche au workspace de démonstration partagé.
S’exécute dans un workspace de démonstration partagé avec une clé de démonstration : tout le monde peut voir ce qu’il contient, n’envoyez donc rien de privé.
Code
Exemple en direct
Une vraie requête
Une requête dans la forme acceptée par l’API, et un exemple de réponse dans la forme renvoyée par le module.
Un ingénieur branche un script à la passerelle. Son DID apparaît dans la liste sans entrée de registre, avant que quiconque ait à demander qui il est.
Dimensionner un déploiement
En observe, la passerelle ne fait qu'enregistrer. Une semaine d'événements montre quels agents et outils enforce rencontrerait avant son activation.
Passer en revue un essai
Les agents enrôlés avec shadow: true restent marqués, si bien qu'une équipe peut parcourir ce qu'elle a suivi et autoriser ceux qu'elle garde.
Vérifier un outil suspect
Filtrez les événements par tool pour voir chaque appelant qui l'a atteint et dans quel mode.
Quand utiliser autre chose
Arrêter un appelant inconnu. La liste ne fait que rapporter ; mettez la passerelle en enforce avec mcp.enforce, ou arrêtez un DID nommé avec coordination.quarantine.
Trouver les agents qui n'utilisent jamais la passerelle MCP. Les appelants GitHub et SaaS n'écrivent pas ces événements ; utilisez leurs propres points d'application.
Lire chaque appel d'outil. Les appels passant par un amont enregistré sont dans le registre comme mcp.call ; cette liste ne contient que des événements shadow.
Preuves
Garanties
Ce qu’il fait, et ce qu’il ne fait pas
Un module est une affirmation forte sur un sujet étroit. Fiez-vous-y exactement pour ce qu’il est.
Il le fait
Chaque appel observe ou enforce à la passerelle MCP laisse un événement mcp.shadow, portant le DID qu'il nommait.
Aucune requête vers ledger/append ne peut écrire un événement mcp.shadow ; le plan écrit lui-même ce type.
Chaque lecture fusionne dans la liste les événements de registre mcp.shadow de l'espace de travail, donc les événements écrits par une autre instance Worker apparaissent aussi.
Il ne le fait pas
Qu'un agent absent de la liste n'a jamais appelé. Seuls les appels observe et enforce via cette passerelle sont enregistrés, et la liste s'arrête aux 50 derniers.
Qui se tient derrière un DID. La liste enregistre le DID qu'un appel portait et ne le relie à aucun propriétaire.
Qu'un appel a été bloqué ou nuisible. Un événement enregistre qu'un appel est arrivé ; l'autorisation ou le refus retourne à l'appelant et n'est pas stocké ici.
Détails
Notes de conception
Avant de construire
Enrôlé ou non
Un événement n'indique pas si son appelant est enrôlé. Cette comparaison se fait à la lecture, contre la liste d'identités.
Mode de la passerelle
Le mode est observe par défaut : la passerelle enregistre et laisse passer l'appel. advise ajoute l'avis d'un classifieur, et seul enforce peut refuser.
Suivi ne veut pas dire autorisé
Enrôler un DID avec shadow: true pose un indicateur sur son enregistrement de registre. Cela n'accorde rien et ne refuse rien ; l'admission exige toujours une habilitation.
Limites et mesure
La route renvoie au plus les 50 derniers événements et n'accepte ni filtre ni curseur.
Les événements ne portent aucun compteur. Premières et dernières apparitions et totaux d'appels sont calculés par la console à partir des événements reçus.
Lire la liste n'est pas mesuré.
Seule la passerelle MCP écrit ces événements. Les autres points d'application tiennent leurs propres registres.
Accès
API et MCP
REST et MCP
Authentifiez-vous avec une clé d’API d’espace de travail comme jeton Bearer. L’URL de base est https://api.intramedial.com.
Points d’accès REST
GET/api/v1/acp/mcp/shadowLister les derniers événements de la passerelle MCP enregistrés comme appels shadow.
Actions MCP
MCPcoordination.mcp.shadowLister les mêmes événements comme action MCP.
Module du plan
