Authn8
oficialAccede a los códigos 2FA de tu equipo desde agentes de IA sin compartir secretos. Lista cuentas, genera códigos TOTP y mantén registros de auditoría completos.
¿Qué puedes hacer con Authn8 MCP?
- Listar cuentas 2FA — Pide a tu asistente que llame a
list_accountspara ver todas las cuentas 2FA accesibles con el token. - Generar códigos TOTP — Usa
get_otpcon un nombre de cuenta o ID para obtener un código de un solo uso actual. - Resolver coincidencias ambiguas — Cuando
get_otpdevuelva múltiples coincidencias, reintenta con el ID de la cuenta. - Verificar detalles del token — Llama a
whoamipara ver el nombre del token, negocio, grupos con alcance, expiración y número de cuentas.
Documentación
@authn8/mcp-server
Servidor MCP que proporciona a los agentes de IA acceso a los códigos 2FA de Authn8 mediante autenticación PAT.
Requisitos previos
- Una cuenta de Authn8
- Un Token de Acceso Personal (PAT) creado en el panel de Authn8
Inicio rápido
npx @authn8/mcp-server
Establece la variable de entorno AUTHN8_API_KEY con tu token PAT.
Docker
docker run -e AUTHN8_API_KEY=pat_xxx ghcr.io/authn8/mcp-server
Configuración
Claude Desktop
Añade a tu archivo de configuración de Claude Desktop:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"authn8": {
"command": "npx",
"args": ["-y", "@authn8/mcp-server"],
"env": {
"AUTHN8_API_KEY": "pat_your_token_here"
}
}
}
}
Claude Code (CLI)
Añade a tu archivo de configuración de Claude Code:
macOS: ~/.claude.json
Windows: %USERPROFILE%\.claude.json
{
"mcpServers": {
"authn8": {
"command": "npx",
"args": ["-y", "@authn8/mcp-server"],
"env": {
"AUTHN8_API_KEY": "pat_your_token_here"
}
}
}
}
Cursor
Añade a tu configuración MCP de Cursor:
{
"mcpServers": {
"authn8": {
"command": "npx",
"args": ["-y", "@authn8/mcp-server"],
"env": {
"AUTHN8_API_KEY": "pat_your_token_here"
}
}
}
}
Variables de entorno
| Variable | Requerido | Por defecto | Descripción |
|---|---|---|---|
AUTHN8_API_KEY | Sí | - | Tu token PAT de Authn8 |
AUTHN8_API_URL | No | https://api.authn8.com | URL del endpoint de la API |
Herramientas disponibles
Todas las herramientas declaran un esquema de salida y devuelven structuredContent junto con el bloque de texto, para que los clientes obtengan resultados tipados sin tener que reanalizar JSON desde el texto.
list_accounts
Devuelve todas las cuentas 2FA accesibles con este token.
Ejemplo de respuesta:
{
"accounts": [
{
"id": "924c52a6-4457-4970-a39f-4dc620217683",
"name": "AWS Production",
"issuerDomain": "amazon.com"
}
]
}
get_otp
Genera un código TOTP para una cuenta específica.
Parámetros:
account_id(cadena, opcional) - UUID de la cuentaaccount_name(cadena, opcional) - Nombre o dominio del emisor para buscar (coincidencia parcial sin distinción de mayúsculas)
Proporciona account_id o account_name. Si varias cuentas coinciden con el nombre, la herramienta las devuelve en multipleMatches para que puedas reintentar usando account_id.
Ejemplo de respuesta:
{
"name": "AWS Production",
"code": "483920",
"length": 6
}
Coincidencia ambigua:
{
"error": "Multiple accounts match 'aws'. Please be more specific or use account_id.",
"length": 0,
"multipleMatches": [
{
"id": "924c52a6-4457-4970-a39f-4dc620217683",
"name": "AWS Production",
"issuerDomain": "amazon.com"
}
]
}
whoami
Devuelve información sobre el token actual.
Ejemplo de respuesta:
{
"tokenName": "MCP Server 2",
"businessName": "Bytecode Solutions",
"scopedGroups": [
{ "id": "cfeba14a-e990-49e8-b6e5-61d63f7d68c8", "name": "HR" }
],
"expiresAt": "2025-12-25T23:59:59Z",
"accountCount": 1
}
Enlaces
- Authn8 - Crea una cuenta y gestiona tokens 2FA
- Repositorio de GitHub