@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

Related MCP server: grantd-mcp

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 de MCP de Cursor:

{
  "mcpServers": {
    "authn8": {
      "command": "npx",
      "args": ["-y", "@authn8/mcp-server"],
      "env": {
        "AUTHN8_API_KEY": "pat_your_token_here"
      }
    }
  }
}

Variables de entorno

Herramientas disponibles

Todas las herramientas declaran un esquema de salida y devuelven structuredContent junto con el bloque de texto, de modo que los clientes obtienen resultados tipados sin tener que volver a analizar JSON del texto.

list_accounts

Devuelve todas las cuentas 2FA accesibles para 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 (string, opcional) - UUID de la cuenta

• account_name (string, opcional) - Nombre o dominio del emisor para buscar (coincidencia parcial sin distinción de mayúsculas y minúsculas)

Proporciona account_id o account_name. Si varias cuentas coinciden con el nombre, la herramienta las devuelve en multipleMatches para que puedas reintentar con un 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