Authn8

oficial

Accede 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_accounts para ver todas las cuentas 2FA accesibles con el token.
  • Generar códigos TOTP — Usa get_otp con un nombre de cuenta o ID para obtener un código de un solo uso actual.
  • Resolver coincidencias ambiguas — Cuando get_otp devuelva múltiples coincidencias, reintenta con el ID de la cuenta.
  • Verificar detalles del token — Llama a whoami para 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

VariableRequeridoPor defectoDescripción
AUTHN8_API_KEY-Tu token PAT de Authn8
AUTHN8_API_URLNohttps://api.authn8.comURL 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 cuenta
  • account_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