Un assistant IA accède aux serveurs MCP de votre organisation de deux façons : avec une clé API, ou comme application que vous avez connectée par une connexion. Cette page montre comment configurer chacune d’elles en toute sécurité et comment mettre fin à l’accès. Les étapes de connexion se trouvent dans Connect an AI assistant.
Clés MCP
Il n’existe pas de type de clé MCP distinct. Une clé MCP est une clé API ordinaire qui possède la permission Connect MCP clients (mcp_server.connect), créée dans API Keys comme toute autre. Voir Authentication.
Quoi cocher
| Permission | Nécessaire pour |
|---|---|
| Connect MCP clients (groupe MCP) | Accéder à n’importe quel serveur MCP |
View devices (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 Read only des modules ; rien d’autre n’est nécessaire. Une clé dotée de Connect MCP clients mais sans la permission d’un outil ne voit pas cet outil. Une clé sans Connect MCP clients est refusée par chaque serveur MCP, quelles que soient ses autres permissions.
Chaque outil ne s’exécute que si la clé et son titulaire possèdent tous deux la permission de l’outil. Si le titulaire perd une permission, l’assistant perd l’outil à son appel suivant.
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 rotation.
- Liste d’adresses IP autorisées lorsque l’assistant fonctionne sur un serveur fixe.
- Aucune autre permission. Une clé MCP dotée de permissions supplémentaires fonctionne aussi sur l’API REST avec ces permissions.
- Gardez la clé hors 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.
Suivi et révocation d’une clé
- La page de la clé affiche Last used, Last used IP et Total verifications.
- 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. - Deactivate, Revoke ou Rotate key sur la page de la clé mettent fin à l’accès ou le remplacent immédiatement. Voir Authentication.
- Le pare-feu IA enregistre les incidents liés aux clés au comportement anormal. Ses actions (limitation ou désactivation d’une clé) sont en cours de développement.
Applications connectées
Une application que vous avez connectée par une connexion figure dans Connected apps (dans la partie Developer du menu) : « Applications IA que vous avez connectées à cet espace de travail par une connexion. La déconnexion d’une application l’arrête immédiatement. »
| Colonne | Affiche |
|---|---|
| App | Le nom et l’hôte de l’application |
| Access | Read ou Read and change |
| Status | Connected, Disconnected ou Paused by the AI firewall |
| Connected | Date de votre approbation |
| Last used | Son dernier appel |
Utilisez Search app or host… pour en trouver une. Les administrateurs (qui possèdent Manage MCP settings) peuvent basculer entre Mine et Everyone (admins) pour voir les applications de chaque membre.
Déconnecter une application
- Ouvrez Connected apps.
- Sélectionnez Disconnect sur la ligne de l’application.
- Confirmez Disconnect this app? : «
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 tous. La déconnexion nécessite une personne connectée : une clé API ne peut pas la réaliser.
Une connexion prend aussi fin :
- après 90 jours (connectez-la de nouveau),
- lorsque son jeton d’actualisation est utilisé deux fois, ce qui peut signifier qu’il a été copié (la connexion est révoquée et l’événement est audité avec une gravité élevée),
- lorsque la personne qui l’a connectée n’est plus un membre actif.
Mise en pause par le pare-feu IA
En cours de développement : les actions du pare-feu IA, y compris la mise en pause d’une application connectée, sont en cours de développement. Aujourd’hui, le pare-feu se contente d’enregistrer les incidents ; voir AI firewall.
Lorsque cette action sera disponible, une application mise en pause sera refusée à chaque appel pendant jusqu’à 7 jours et son statut affichera Paused by the AI firewall. Si vous voyez ce statut sans l’attendre, déconnectez l’application et consultez le journal d’audit avant de la connecter de nouveau.
Via HTTP
| Méthode | Chemin | Qui | Action |
|---|---|---|---|
| GET | /api/mcp/grants | Tout membre connecté disposant de Connect MCP clients | Vos applications connectées : { data, total } |
| GET | /api/mcp/grants/all | Manage MCP settings | 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://<your host>/tenant/<tenantId>.
Quel mode choisir
| Situation | Utiliser |
|---|---|
| Un assistant sur votre propre ordinateur | Une clé 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é API, marquée comme clé de service si elle doit survivre à son créateur |
| Un assistant d’équipe partagé | Une clé API par assistant avec des permissions en lecture seule ; jamais la connexion d’une personne |