2FA-codes voor je AI-agents, zonder ze het geheim toe te vertrouwen

Openbare code op GitHub. De MCP-connector en de 2FA-skill voor agents installeer je in een paar minuten met een token van je account.

Het probleem

Een AI-agent die inlogt bij een dienst met 2FA loopt vast op de code van zes cijfers. De gebruikelijke noodoplossingen deugen niet. Plak je de TOTP-seed in de configuratie van de agent, dan geef je hem een permanent inloggegeven dat je niet kunt intrekken. Laat je hem wachten tot een mens de code overtypt, dan heeft de automatisering geen zin meer.

Wat de connector doet

Hij stelt de kluis van het team beschikbaar via het MCP-protocol, in de vorm van twee tools:

• list_otp_secrets geeft de accounts van het team weer, met een optionele zoekopdracht en zonder enig gevoelig gegeven;
• get_otp_code retourneert de actuele code van een account, aangewezen met zijn id of zijn exacte naam.

De agent krijgt de code op het moment dat hij die nodig heeft. De seed krijgt hij nooit: die blijft versleuteld in de kluis.

De connector installeren

Je hebt Node.js 20 of nieuwer nodig.

1. Kloon de repository en installeer de afhankelijkheden: git clone https://github.com/ShareAuth/mcp-server.git, daarna npm ci.
2. Maak in je Share Auth-profiel, onder API-tokens, een token aan met de permissies secrets:list en secrets:generate.
3. Registreer de server in je client. Voor Claude Desktop, Codex CLI en andere lokale clients is de opdracht node src/index.js, met het token in de variabele OTP_API_TOKEN.

Voor een client op afstand zoals ChatGPT start je de server in HTTP-modus achter HTTPS, op je eigen infrastructuur; het eindpunt is /mcp. De README van de repository beschrijft beide modi in detail.

De skill voor agents

Voor een agent die een skill kan lezen en opdrachten kan uitvoeren, zoals Claude Code, kloon je de 2FA-skill (shareauth-otp) in zijn map met skills. Die roept de API aan met Bash en curl om een account te vinden en de huidige code op te halen, nooit de seed. Token: secrets:list en secrets:generate.

Beperkte toegang, en alles wordt vastgelegd

De connector en de skill melden zich aan met een API-token dat je vanuit je profiel aanmaakt. Dat token heeft alleen de permissies die je kiest, voor 1, 7, 30 of 90 dagen, en je trekt het op elk moment in.

Elke opgehaalde code wordt vastgelegd in het toegangslogboek van het team, net als een code die op de site is bekeken. De eigenaar ziet welk account is gebruikt, wanneer, en op wiens naam.

Goede gewoonten

• Eén token per persoon en per apparaat, zodat je er één kunt intrekken.
• Laat de menselijke bevestiging op get_otp_code in je client aanstaan: het antwoord is een inloggegeven.
• Laat eerst list_otp_secrets aanroepen als de naam van het account onzeker is.
• Leg de headers van MCP-verzoeken en de resultaten van de tools niet vast in logs.