Des codes 2FA pour vos agents IA, sans leur confier le secret

Code public sur GitHub. Le connecteur MCP et la skill 2FA pour agents s’installent en quelques minutes avec un jeton de votre compte.

Le problème

Un agent IA qui se connecte à un service protégé par la 2FA bute sur le code à six chiffres. Les solutions de fortune sont toutes mauvaises : coller la graine TOTP dans la configuration de l’agent, c’est lui confier un identifiant permanent qui ne se révoque pas ; lui faire attendre qu’un humain recopie le code, c’est perdre l’intérêt de l’automatisation.

Ce que fait le connecteur

Il expose le coffre de l’équipe à travers le protocole MCP, sous la forme de deux outils :

• list_otp_secrets liste les comptes de l’équipe, avec une recherche facultative, sans aucune donnée sensible ;
• get_otp_code renvoie le code courant d’un compte, désigné par son identifiant ou son nom exact.

L’agent obtient le code au moment où il en a besoin. Il ne reçoit jamais la graine, qui reste chiffrée dans le coffre.

Installer le connecteur

Il faut Node.js 20 ou plus récent.

1. Clonez le dépôt et installez ses dépendances : git clone https://github.com/ShareAuth/mcp-server.git, puis npm ci.
2. Dans votre profil Share Auth, section Jetons API, créez un jeton avec les permissions secrets:list et secrets:generate.
3. Déclarez le serveur dans votre client. Pour Claude Desktop, Codex CLI et les autres clients locaux, la commande est node src/index.js, avec le jeton dans la variable OTP_API_TOKEN.

Pour un client distant comme ChatGPT, lancez le serveur en mode HTTP derrière HTTPS, sur votre propre infrastructure ; le point d’accès est /mcp. Le README du dépôt détaille les deux modes.

La skill pour agents

Pour un agent qui sait lire une skill et lancer des commandes, comme Claude Code, la skill 2FA (shareauth-otp) se clone dans son dossier de skills. Elle appelle l’API avec Bash et curl pour trouver un compte et obtenir son code courant, jamais la graine. Jeton : secrets:list et secrets:generate.

Un accès limité et tracé

Le connecteur et la skill s’authentifient avec un jeton d’API que vous créez depuis votre profil. Ce jeton ne porte que les permissions choisies, pour une durée de 1, 7, 30 ou 90 jours, et vous le révoquez à tout moment.

Chaque code obtenu est enregistré dans le journal d’accès de l’équipe, comme un code consulté sur le site. Le propriétaire voit quel compte a été utilisé, quand, et au nom de qui.

Bonnes pratiques

• Un jeton par personne et par appareil, pour pouvoir en révoquer un seul.
• Gardez la confirmation humaine activée sur get_otp_code dans votre client : sa réponse est un élément d’authentification.
• Faites appeler list_otp_secrets d’abord quand le nom du compte est incertain.
• Ne journalisez ni les en-têtes des requêtes MCP, ni les résultats des outils.