> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://documentation.enso-rse.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Créer et gérer ses clés API

Une clé API permet à un outil externe d'accéder à vos données ensō rse sans passer par votre identifiant et votre mot de passe : une automatisation développée par votre service informatique, un outil de reporting interne, un assistant IA qui ne sait pas se connecter avec votre compte...

| Pour Claude, ChatGPT ou Mistral Vibe, vous n'avez pas besoin de clé : utilisez la [connexion MCP](https://documentation.enso-rse.com/fr/article/connecter-un-assistant-ia-mcp-130lxyp/), plus simple et plus sûre.

## Ouvrir la page Clés API

Cliquez sur votre profil, en haut à droite, puis sur **« Clés API »**. La page n'apparaît que si votre rôle dispose de la permission **« Clés API »**, donnée par défaut aux administrateurs du cabinet.

## Créer une clé

1. Cliquez sur **« Créer une clé »**.
2. Donnez-lui un **nom** qui permet de reconnaître l'outil qui l'utilise (par exemple « Outil de reporting interne »).
3. Dans **Domaines et droits**, cochez les accès nécessaires. Le domaine **MCP** donne accès au serveur MCP d'ensō rse, en lecture. D'autres domaines peuvent apparaître selon votre abonnement.
4. Choisissez une **expiration** : 30 jours, 90 jours, 1 an ou une date précise. Vous pouvez aussi laisser la clé sans expiration, mais une durée limitée est plus prudente.
5. Cliquez sur **« Créer »**.

![](https://storage.crisp.chat/users/helpdesk/website/-/7/b/3/5/7b35cf8eee3a6400/ia-cle-creer_1hp6hfz.png)

## Copier la clé

La clé s'affiche **une seule fois**. Copiez-la avec le bouton prévu et transmettez-la de façon sûre à la personne qui configure l'outil. Si vous fermez la fenêtre sans l'avoir copiée, supprimez la clé et créez-en une nouvelle.

![](https://storage.crisp.chat/users/helpdesk/website/-/7/b/3/5/7b35cf8eee3a6400/ia-cle-secret_1beream.png)

## Suivre et gérer ses clés

La liste affiche, pour chaque clé, ses accès, sa date d'expiration, sa **dernière utilisation** et sa date de création. Vous pouvez :

- **désactiver** une clé avec l'interrupteur de la colonne Activation, puis la réactiver plus tard ;
- la **modifier** (nom, droits, expiration) depuis le menu à trois points de la ligne ;
- la **supprimer** définitivement depuis le même menu.

![](https://storage.crisp.chat/users/helpdesk/website/-/7/b/3/5/7b35cf8eee3a6400/ia-cle-liste_1f9uhfv.png)

## Bonnes pratiques

- **Une clé par outil** : vous pourrez couper un accès sans gêner les autres.
- **Le minimum de droits** : ne cochez que les domaines utiles à l'outil.
- **Une expiration** : une clé oubliée ne reste pas active indéfiniment.
- **En cas de doute, désactivez** : une clé perdue ou partagée par erreur se coupe en un clic.
- **Faites le ménage** : la colonne « Dernière utilisation » montre les clés qui ne servent plus.

|| La clé agit en votre nom : l'outil qui l'utilise voit les mêmes données que vous, selon vos permissions, et en lecture seule.

## Pour votre service informatique

La clé se transmet dans l'en-tête HTTP `x-api-key`. Pour le serveur MCP, l'adresse à utiliser est celle indiquée sur la page **MCP** de votre profil.