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_URL | 否 | https://api.authn8.com | API 端点 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) - 账户的 UUIDaccount_name(string, optional) - 要搜索的名称或签发者域名(不区分大小写的部分匹配)
提供 account_id 或 account_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
}