Nouveau : le pare-feu IA surveille toute la plateforme et explique chaque incident en termes simples. Découvrez comment ça marche

Clés MCP et applications connectées

Donnez à un assistant IA une clé d'API ne disposant que des autorisations MCP et de lecture dont il a besoin, et consultez et déconnectez les applications connectées.

Un assistant IA accède aux serveurs MCP de votre organisation de deux manières : avec une clé d’API, ou comme application que vous avez connectée avec une connexion. Cette page explique comment configurer chacune de ces méthodes en toute sécurité et comment mettre fin à l’accès. Les étapes de connexion se trouvent dans Connecter un assistant IA.

Clés MCP

Il n’existe pas de type distinct de clé MCP. Une clé MCP est une clé d’API ordinaire qui détient l’autorisation Connecter des clients MCP (mcp_server.connect), créée dans Clés d’API comme toute autre. Voir Authentification.

Quoi cocher

AutorisationNécessaire pour
Connecter des clients MCP (groupe MCP)Accéder à n’importe quel serveur MCP
Voir les appareils (iot_device.devices.read)list_devices, get_device
Lecture de la télémétrie (telemetry.read)get_latest_readings, get_reading_series

Utilisez les préréglages Lecture seule des modules ; rien d’autre n’est nécessaire. Une clé dotée de Connecter des clients MCP mais sans l’autorisation d’un outil ne voit pas cet outil. Une clé sans Connecter des clients MCP est refusée par tous les serveurs MCP, quelles que soient ses autres autorisations.

Chaque outil ne s’exécute que si la clé et son titulaire détiennent tous deux l’autorisation de l’outil. Si le titulaire perd une autorisation, l’assistant perd l’outil à son prochain appel.

Bonnes pratiques

  • Une clé par assistant et par personne. Nommez-la pour savoir qui l’utilise : « Assistant bureau – Alex ».
  • Expiration courte. 30 à 90 jours, puis renouvelez.
  • Liste d’adresses IP autorisées lorsque l’assistant fonctionne sur un serveur fixe.
  • Aucune autre autorisation. Une clé MCP dotée d’autorisations supplémentaires fonctionne aussi sur l’API REST avec ces autorisations.
  • Ne laissez pas la clé dans des fichiers partagés. Les fichiers de configuration des assistants sont souvent synchronisés ou versionnés ; stockez la clé dans le coffre de secrets de l’assistant ou dans une variable d’environnement lorsque cela est possible.

Suivre et mettre fin à une clé

  • La page de la clé affiche Dernière utilisation, Dernière adresse IP utilisée et Total des vérifications.
  • Chaque appel d’outil figure dans le journal d’audit sous mcp_server.tool.called (ou mcp_server.tool.refused), avec la clé comme acteur, l’outil, le résultat et la durée.
  • Désactiver, Révoquer ou Renouveler la clé sur la page de la clé met fin à l’accès ou le remplace immédiatement. Voir Authentification.
  • Le pare-feu IA enregistre les incidents concernant les clés qui se comportent mal et peut limiter ou révoquer une telle clé.

Applications connectées

Une application que vous avez connectée avec une connexion figure dans Applications connectées (dans la partie Développeur du menu) : « Applications IA que vous avez connectées à cet espace de travail avec une connexion. La déconnexion d’une application l’arrête immédiatement. »

ColonneAffiche
ApplicationLe nom et l’hôte de l’application
AccèsLecture ou Lecture et modification
StatutConnectée, Déconnectée ou Suspendue par le pare-feu IA
ConnectéeDate de votre approbation
Dernière utilisationSon dernier appel

Utilisez Rechercher une application ou un hôte… pour en trouver une. Les administrateurs (qui détiennent Gérer les paramètres MCP) peuvent basculer entre Les miennes et Tout le monde (administrateurs) pour voir les applications de chaque membre.

Déconnecter une application

  1. Ouvrez Applications connectées.
  2. Sélectionnez Déconnecter sur la ligne de l’application.
  3. Confirmez Déconnecter cette application ? : « Nom de l’application perdra immédiatement l’accès à cet espace de travail. Pour l’utiliser à nouveau, connectez-la de nouveau. »

Le prochain appel de l’application est refusé avec 401. Les membres peuvent déconnecter leurs propres applications ; les administrateurs peuvent déconnecter celles de n’importe qui. La déconnexion nécessite une personne connectée : une clé d’API ne peut pas le faire.

Une connexion prend aussi fin :

  • après 90 jours (connectez-la de nouveau),
  • lorsque son jeton de rafraîchissement est utilisé deux fois, ce qui peut signifier qu’il a été copié (la connexion est révoquée et l’événement est journalisé avec une gravité élevée),
  • lorsque la personne qui l’a connectée n’est plus un membre actif.

Via HTTP

MéthodeCheminQuiAction
GET/api/mcp/grantsTout membre connecté disposant de Connecter des clients MCPVos applications connectées : { data, total }
GET/api/mcp/grants/allGérer les paramètres MCPCelles de tous
DELETE/api/mcp/grants/{grantId}Le propriétaire de l’application, ou un administrateurDéconnexion : { "revoked": true }

Les listes acceptent page (à partir de 0), pageSize (par défaut 20, 100 au maximum), search (nom de l’application ou hôte), sort et status (active, suspended, revoked). Les chemins se trouvent sous https://<votre hôte>/tenant/<tenantId>.

Quelle méthode choisir

SituationUtiliser
Un assistant sur votre propre ordinateurUne clé d’API, ou la connexion si l’assistant la propose
Un assistant hébergé qui ajoute des connecteurs par adresseLa connexion
Un agent planifié ou un script sans personneUne clé d’API, marquée comme clé de service si elle doit survivre à son créateur
Un assistant d’équipe partagéUne clé d’API par assistant avec des autorisations en lecture seule ; jamais la connexion d’une personne