Agentes de IA
Códigos 2FA para tus agentes de IA, sin confiarles el secreto
El conector MCP y la skill 2FA de Share Auth dan a Claude, ChatGPT o Codex el código 2FA que un agente necesita, sin transmitirle nunca la semilla TOTP. Código público en GitHub.
Código público en GitHub. El conector MCP y la skill 2FA para agentes se instalan en pocos minutos con un token de tu cuenta.
El problema
Un agente de IA que se conecta a un servicio protegido con 2FA tropieza con el código de seis dígitos. Los apaños son todos malos: pegar la semilla TOTP en la configuración del agente es confiarle una credencial permanente que no se puede revocar; hacerle esperar a que una persona copie el código es perder la gracia de la automatización.
Qué hace el conector
Expone la bóveda del equipo a través del protocolo MCP, en forma de dos herramientas:
list_otp_secretslista las cuentas del equipo, con una búsqueda opcional, sin ningún dato sensible;get_otp_codedevuelve el código actual de una cuenta, indicada por su identificador o por su nombre exacto.
El agente obtiene el código en el momento en que lo necesita. Nunca recibe la semilla, que sigue cifrada en la bóveda.
Instalar el conector
Necesitas Node.js 20 o más reciente.
- Clona el repositorio e instala sus dependencias:
git clone https://github.com/ShareAuth/mcp-server.gity luegonpm ci. - En tu perfil de Share Auth, sección Tokens de API, crea un token con los
permisos
secrets:listysecrets:generate. - Declara el servidor en tu cliente. Para Claude Desktop, Codex CLI y los demás
clientes locales, el comando es
node src/index.js, con el token en la variableOTP_API_TOKEN.
Para un cliente remoto como ChatGPT, ejecuta el servidor en modo HTTP detrás de
HTTPS, en tu propia infraestructura; el punto de acceso es /mcp. El
README del repositorio detalla los
dos modos.
La skill para agentes
Para un agente que sabe leer una skill y ejecutar comandos, como Claude Code,
la skill 2FA (shareauth-otp) se clona en su carpeta de skills.
Llama a la API con Bash y curl para encontrar una cuenta y obtener su código
actual, nunca la semilla. Token: secrets:list y secrets:generate.
Un acceso limitado y registrado
El conector y la skill se autentican con un token de API que creas desde tu perfil. Ese token solo lleva los permisos elegidos, con una validez de 1, 7, 30 o 90 días, y puedes revocarlo en cualquier momento.
Cada código obtenido queda guardado en el registro de accesos del equipo, igual que un código consultado en el sitio. El propietario ve qué cuenta se usó, cuándo y en nombre de quién.
Buenas prácticas
- Un token por persona y por dispositivo, para poder revocar solo uno.
- Mantén activada en tu cliente la confirmación humana para
get_otp_code: su respuesta es un elemento de autenticación. - Haz que el agente llame primero a
list_otp_secretscuando el nombre de la cuenta no esté claro. - No registres en los logs ni las cabeceras de las peticiones MCP, ni los resultados de las herramientas.
Preguntas frecuentes
Los clientes locales como Claude Desktop o Codex CLI, y los clientes remotos como ChatGPT o la API Responses de OpenAI, a través de un punto de acceso HTTPS que alojas tú. Cualquier cliente que hable MCP puede conectarse.
No. El conector y la skill 2FA nunca leen ni devuelven la semilla: solo obtienen el código actual, como un lector del equipo.
El propietario del equipo. Cada código obtenido por un agente aparece en el registro de accesos, a nombre de la persona a la que pertenece el token.
Revocando su token desde tu perfil, entre tus tokens de API. De todos modos, el token caduca al final de la duración elegida al crearlo: 1, 7, 30 o 90 días.
El conector MCP para un cliente que hable MCP (Claude Desktop, Codex, ChatGPT). Una skill para un agente que lea skills y pueda ejecutar comandos, como Claude Code: solo necesita Bash y curl.