Authn8

官方

从AI代理访问您团队的2FA代码,无需共享机密。列出账户、生成TOTP代码,并维护完整的审计追踪。

你可以用 Authn8 MCP 做什么?

  • 列表 2FA 账号 — 让助手调用 list_accounts 查看令牌可访问的所有 2FA 账号。
  • 生成 TOTP 代码 — 使用 get_otp 并传入账号名称或 ID 获取当前一次性代码。
  • 解析歧义匹配 — 当 get_otp 返回多个匹配时,请使用账号 ID 重试。
  • 检查令牌详情 — 调用 whoami 查看令牌名称、业务、作用域组、过期时间和账号数量。

文档

@authn8/mcp-server

通过 PAT 认证为 AI 代理提供 Authn8 2FA 验证码访问权限的 MCP 服务器。

前提条件

  • 一个 Authn8 账户
  • 在 Authn8 控制台中创建的个人访问令牌(PAT)

快速开始

npx @authn8/mcp-server

AUTHN8_API_KEY 环境变量设置为您的 PAT 令牌。

Docker

docker run -e AUTHN8_API_KEY=pat_xxx ghcr.io/authn8/mcp-server

配置

Claude Desktop

添加到您的 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)

添加到您的 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

添加到您的 Cursor MCP 设置中:

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

环境变量

变量必需默认值描述
AUTHN8_API_KEY-来自 Authn8 的 PAT 令牌
AUTHN8_API_URLhttps://api.authn8.comAPI 端点 URL

可用工具

所有工具都声明输出模式,并在文本块旁边返回 structuredContent,因此客户端无需从文本中重新解析 JSON 即可获得类型化结果。

list_accounts

返回此令牌可访问的所有 2FA 账户。

示例响应:

{
  "accounts": [
    {
      "id": "924c52a6-4457-4970-a39f-4dc620217683",
      "name": "AWS Production",
      "issuerDomain": "amazon.com"
    }
  ]
}

get_otp

为特定账户生成 TOTP 验证码。

参数:

  • account_id (string, optional) - 账户的 UUID
  • account_name (string, optional) - 要搜索的名称或签发者域名(不区分大小写的部分匹配)

提供 account_idaccount_name 之一。如果多个账户与名称匹配,工具会在 multipleMatches 中返回它们,以便您可以使用 account_id 重试。

示例响应:

{
  "name": "AWS Production",
  "code": "483920",
  "length": 6
}

模糊匹配:

{
  "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

返回当前令牌的信息。

示例响应:

{
  "tokenName": "MCP Server 2",
  "businessName": "Bytecode Solutions",
  "scopedGroups": [
    { "id": "cfeba14a-e990-49e8-b6e5-61d63f7d68c8", "name": "HR" }
  ],
  "expiresAt": "2025-12-25T23:59:59Z",
  "accountCount": 1
}

链接