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
| Autorisation | Né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(oumcp_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. »
| Colonne | Affiche |
|---|---|
| Application | Le nom et l’hôte de l’application |
| Accès | Lecture ou Lecture et modification |
| Statut | Connectée, Déconnectée ou Suspendue par le pare-feu IA |
| Connectée | Date de votre approbation |
| Dernière utilisation | Son 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
- Ouvrez Applications connectées.
- Sélectionnez Déconnecter sur la ligne de l’application.
- 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éthode | Chemin | Qui | Action |
|---|---|---|---|
| GET | /api/mcp/grants | Tout membre connecté disposant de Connecter des clients MCP | Vos applications connectées : { data, total } |
| GET | /api/mcp/grants/all | Gérer les paramètres MCP | Celles de tous |
| DELETE | /api/mcp/grants/{grantId} | Le propriétaire de l’application, ou un administrateur | Dé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
| Situation | Utiliser |
|---|---|
| Un assistant sur votre propre ordinateur | Une clé d’API, ou la connexion si l’assistant la propose |
| Un assistant hébergé qui ajoute des connecteurs par adresse | La connexion |
| Un agent planifié ou un script sans personne | Une 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 |

