Connecter un agent IA par jeton
Un agent comme Claude Code ou Codex, ou un simple script, peut ajouter vos trajets sans passer par la connexion d'un assistant. Il agit avec un jeton que vous créez et que vous révoquez quand vous voulez.
- Publié le , mis à jour le
- Temps de lecture : 3 min
L'essentiel à retenir
Un jeton personnel est une clé que vous créez dans Quitéa et que vous donnez à un agent IA ou à un script. Avec elle, l'agent agit en votre nom et avec vos droits dans l'organisation choisie : il lit vos lieux enregistrés et l'état de vos notes, et il peut ajouter des trajets en brouillon si vous lui en avez donné la portée.
Le même jeton sert à l'outil en ligne de commande quitea et au serveur MCP de Quitéa, à l'adresse https://www.quitea.fr/mcp. Il ne donne jamais plus qu'une autorisation de la page Connecter un assistant, et il est compris dans l'offre Solo et les offres supérieures.
1. Ce que l'agent fait pour vous
Vous lui demandez par exemple d'ajouter la tournée d'hier. Il retrouve vos lieux et votre véhicule, puis prépare un aperçu dont Quitéa calcule la distance et le montant au barème. Il vous le montre et n'enregistre les trajets qu'après votre accord.
Les trajets ajoutés restent en brouillon dans la note du mois et portent le nom du jeton. La soumission et la validation de la note restent les vôtres.
2. Créer le jeton
Dans Quitéa, ouvrez Mon compte, puis la section « Jetons pour agents IA ». Donnez un nom au jeton, par exemple celui de l'ordinateur, choisissez sa durée (30 jours, 90 jours par défaut, un an, ou sans expiration), puis ses droits : lecture seule ou lecture avec ajout de trajets.
Le jeton s'affiche une seule fois, juste après sa création. Copiez-le tout de suite : Quitéa n'en garde que l'empreinte et ne peut plus le montrer ensuite.
3. Donner le message à votre agent
La même section propose un message prêt à copier. Il ne contient pas votre jeton.
Installe l’outil en ligne de commande Quitéa sur cet ordinateur.
1. Lis https://www.quitea.fr/agents.md et suis-le pas à pas pour installer l’outil `quitea`.
2. Vérifie l’empreinte SHA-256 du fichier téléchargé avant de l’installer.
3. Ne me demande pas mon jeton dans la conversation. Dis-moi de le poser moi-même dans ~/.config/quitea/token (droits 600) ou dans la variable QUITEA_TOKEN.
4. Teste avec `quitea whoami`.
5. N’affiche jamais le jeton et demande-moi ma confirmation avant d’ajouter un trajet.
Collez-le dans la conversation avec votre agent. Il suit ensuite le guide agents.md, écrit pour lui.
4. L'installation, vérifiée
L'agent télécharge l'outil, compare son empreinte SHA-256 à celle que le site publie, puis l'installe dans un dossier de votre PATH, sans sudo. Si l'empreinte diffère, rien n'est installé : il vous prévient.
Il vous demande ensuite de poser le jeton vous-même, dans le fichier ~/.config/quitea/token en droits 600 ou dans la variable QUITEA_TOKEN, puis lance quitea whoami pour vérifier que tout répond.
5. Révoquer un jeton
Dans Mon compte, section « Jetons pour agents IA », le bouton « Révoquer » coupe l'accès sur-le-champ. La liste montre aussi le dernier usage de chaque jeton et sa date d'expiration, ou la mention « n'expire jamais ».
Un changement de mot de passe ou le retrait du second facteur coupe aussi tous vos jetons. Perdre le droit de déclarer des trajets ou la fin de votre abonnement les révoque pour de bon.
Bon à savoir : sécurité et accès
Un jeton vaut votre mot de passe pour ce qu'il autorise. Gardez-le secret et ne le collez pas dans une conversation si vous pouvez l'éviter.
Créez un jeton par agent et par machine, avec la durée la plus courte qui vous convienne. Un jeton sans expiration reste valable jusqu'à ce que vous le révoquiez : réservez-le à un usage que vous surveillez, et révoquez-le dès que l'agent n'en a plus besoin. Si vous avez un doute, révoquez-le : vous en créerez un autre en une minute.
Un agent qui sait parler MCP, comme Claude Code ou Codex, peut aussi se brancher directement sur https://www.quitea.fr/mcp avec le même jeton, dans l'en-tête Authorization: Bearer. Le guide agents.md donne la configuration exacte.
Passer du calcul au justificatif
Gratuit : 10 trajets pour essayer, sans limite de durée. Le justificatif PDF et les exports comptables sont dans les offres payantes.