Personal Access Tokens
Les Personal Access Tokens (PAT) sont des jetons d'authentification personnels qui permettent d'accéder à Recrut'Auto depuis vos outils externes : serveur MCP, API REST, scripts, intégrations maison. Ils sont scopés sur votre abonnement et respectent vos permissions.
Générer un token
- Connectez-vous à console.recrutauto.fr.
- Ouvrez votre menu utilisateur (en haut à droite) puis cliquez sur Mon compte.
- Descendez jusqu'à la section Tokens d'accès.
- Saisissez un nom descriptif (ex : « Claude Desktop — mon Mac », « Script sync ATS », « Cursor bureau »).
- Cliquez sur Créer le token.
Le token apparaît alors en clair, préfixé par ra_ :
ra_a1b2c3d4e5f6...
Le token complet n'est affiché qu'une seule fois, au moment de la création. Copiez-le immédiatement et stockez-le dans un gestionnaire de secrets (1Password, Bitwarden, variable d'environnement .env.local...). Si vous le perdez, révoquez-le et générez-en un nouveau.
Liste des tokens
La section affiche pour chaque token :
| Champ | Description |
|---|---|
| Nom | Le nom que vous avez choisi |
| Préfixe | Les 8 premiers caractères (ex : ra_a1b2c3...), pour identification uniquement |
| Créé le | Date de création |
| Dernière utilisation | Horodatage du dernier appel authentifié avec ce token |
| Expire le | Date d'expiration si configurée (optionnel) |
| Statut | Actif / Inactif |
Révoquer un token
- Dans la liste, cliquez sur l'icône corbeille à droite du token.
- Confirmez la révocation.
Le token est immédiatement invalidé : toute requête utilisant ce token recevra une erreur 401 Unauthorized. Cette action est irréversible.
- Un token par intégration — plus facile à révoquer individuellement en cas de compromission.
- Nommage explicite — incluez la machine ou l'outil (ex : « Laptop pro — Cursor »).
- Surveillez « Dernière utilisation » — révoquez les tokens dormants.
- Ne commitez jamais un token dans Git — utilisez toujours une variable d'environnement.
Tokens personnels vs clés d'organisation
Recrut'Auto distingue deux types de jetons :
| Personal Access Token | Clé d'API d'organisation | |
|---|---|---|
| Où le créer | Mon compte › Tokens d'accès | Organisation › Développeurs |
| Préfixe | ra_… | ra_live_… / ra_test_… |
| Périmètre | Vous (vos campagnes, candidats, permissions) | L'organisation (CI/CD, intégrations serveur) |
| Serveur MCP (Claude) | ✅ Oui | ❌ Non |
| API REST | ✅ Oui | ✅ Oui |
Pour utiliser Claude (serveur MCP), créez un token personnel : le serveur MCP agit toujours au nom d'un membre identifié et n'accepte pas les clés d'organisation. Les clés d'organisation servent aux intégrations serveur-à-serveur (CI/CD, synchronisation ATS, SCIM) sur l'API REST, et se gèrent dans Organisation › Développeurs.
Utilisation
Une fois votre token généré, consultez :
- Documentation MCP — pour configurer Claude Desktop, Cursor ou Claude Code.
- API REST — pour appeler directement les endpoints HTTP.