KI-Agenten

2FA-Codes für Ihre KI-Agenten, ohne ihnen das Geheimnis anzuvertrauen

Der MCP-Konnektor und der 2FA-Skill von Share Auth geben Claude, ChatGPT oder Codex den 2FA-Code, den ein Agent braucht, ohne ihm je den TOTP-Seed zu übermitteln. Quellcode öffentlich auf GitHub.

Demo-Oberfläche. Die Codes sind fiktiv.
Das Tutorial in einer Minute
Beim Abspielen wird der Player von YouTube (Google) geladen. Datenschutzerklärung

Quellcode öffentlich auf GitHub. Der MCP-Konnektor und der 2FA-Skill für Agenten sind mit einem Token Ihres Kontos in wenigen Minuten installiert.

Das Problem

Ein KI-Agent, der sich bei einem per 2FA geschützten Dienst anmeldet, scheitert am sechsstelligen Code. Die üblichen Behelfslösungen taugen beide nichts. Wer den TOTP-Seed in die Konfiguration des Agenten einfügt, gibt ihm eine dauerhafte Anmeldeinformation, die sich nicht widerrufen lässt. Und wenn der Agent warten muss, bis ein Mensch den Code abtippt, verliert die Automatisierung ihren Sinn.

Was der Konnektor tut

Er stellt den Tresor des Teams über das MCP-Protokoll bereit, in Form von zwei Werkzeugen:

  • list_otp_secrets listet die Konten des Teams auf, mit optionaler Suche, ganz ohne sensible Daten;
  • get_otp_code liefert den aktuellen Code eines Kontos, das Sie über seine Kennung oder seinen exakten Namen angeben.

Der Agent erhält den Code in dem Moment, in dem er ihn braucht. Den Seed bekommt er nie, er bleibt verschlüsselt im Tresor.

Den Konnektor installieren

Erforderlich ist Node.js 20 oder neuer.

  1. Klonen Sie das Repository und installieren Sie seine Abhängigkeiten: git clone https://github.com/ShareAuth/mcp-server.git, dann npm ci.
  2. Erstellen Sie in Ihrem Share-Auth-Profil im Abschnitt API-Token ein Token mit den Berechtigungen secrets:list und secrets:generate.
  3. Tragen Sie den Server in Ihrem Client ein. Für Claude Desktop, Codex CLI und andere lokale Clients lautet der Befehl node src/index.js, mit dem Token in der Variablen OTP_API_TOKEN.

Für einen entfernten Client wie ChatGPT starten Sie den Server im HTTP-Modus hinter HTTPS, auf Ihrer eigenen Infrastruktur; der Endpunkt ist /mcp. Das README des Repositorys beschreibt beide Modi im Detail.

Der Skill für Agenten

Für einen Agenten, der einen Skill lesen und Befehle ausführen kann, wie Claude Code, lässt sich der 2FA-Skill (shareauth-otp) in seinen Skill-Ordner klonen. Er ruft die API mit Bash und curl auf, um ein Konto zu finden und seinen aktuellen Code abzurufen, niemals den Seed. Token: secrets:list und secrets:generate.

Begrenzter, protokollierter Zugriff

Der Konnektor und der Skill authentifizieren sich mit einem API-Token, das Sie in Ihrem Profil erstellen. Dieses Token hat nur die Berechtigungen, die Sie wählen, gilt 1, 7, 30 oder 90 Tage und lässt sich jederzeit widerrufen.

Jeder abgerufene Code wird im Zugriffsprotokoll des Teams festgehalten, genau wie ein auf der Website angesehener Code. Der Eigentümer sieht, welches Konto verwendet wurde, wann und in wessen Namen.

Empfehlungen

  • Ein Token pro Person und pro Gerät, damit Sie gezielt eines widerrufen können.
  • Lassen Sie die menschliche Bestätigung für get_otp_code in Ihrem Client aktiviert: Seine Antwort ist ein Authentifizierungsmerkmal.
  • Lassen Sie zuerst list_otp_secrets aufrufen, wenn der genaue Kontoname nicht feststeht.
  • Protokollieren Sie weder die Header der MCP-Anfragen noch die Ergebnisse der Werkzeuge.

Häufige Fragen

Lokale Clients wie Claude Desktop oder Codex CLI und entfernte Clients wie ChatGPT oder die Responses API von OpenAI, über einen HTTPS-Endpunkt, den Sie selbst betreiben. Jeder Client, der MCP spricht, kann sich anbinden.